🏰 KYO CLAIM - ULTIMATE TERRITORY PROTECTION

An exclusive server-side project within the TEA Server ecosystem, delivering a comprehensive, secure, and resource-optimized land management and protection solution—without requiring any client-side mod installations.

🌟 GROUNDBREAKING FEATURES

1. Land Purchase & Sanctuary Setup (Base-Building)

• Flexible Radius Initialization: Break free from the constraints of boring, square "Chunks." Kyo Claim establishes a Central Core right at your current coordinates.
• Comprehensive Protection: Use the command /nha mua (or /claim buy) for a base cost of 5,000 Coins to activate the protection core. Every block, chest, and entity within the sanctuary's range is strictly protected against vandalism or theft by strangers.

2. Territory Expansion

• Easily expand your boundaries using the command /nha nangcap (or /claim upgrade) for a cost of 20,000 Coins. * The protection radius expands instantly, fully enclosing your farm, treasure stores, and auxiliary structures.

3. Effect Dome & 3D Laser Grid

• Visual Display: Upon purchasing land, upgrading, or typing /nha info within your territory, a 3D boundary projector automatically renders a frame for 15 seconds.
• Sharp Boundaries: A fire barrier (FLAME) traces the terrain's surface, combined with four magical laser pillars (END_ROD) standing at the corners, allowing you and your teammates to pinpoint the exact boundaries.

4. GPS Compass (Instant Navigation)

• If lost far away, type /nha info to launch a brilliant "comet trail" shooting directly toward your territory, accompanied by a locating ping sound. Simply follow the trail of light to find your way back to base.

5. Safe Inter-dimensional Teleportation ("Taxi Service")

• Safe Overworld Return: The command /nha ve (or /claim home)—with a "taxi fee" of 1,000 Coins—instantly teleports you straight to your headquarters.
• Absolute Protection: The system actively monitors the land's status in the Overworld and forces the teleportation stream to land safely there, completely eliminating risks of getting stuck or positional errors when activating the command from the Nether or The End.
• Dual Effects: Features a dissipating particle effect at the departure dimension and a dazzling welcoming fireworks display at the destination.

6. Land Permission Management

• /nha trust <player>: Grants building, farming, and chest-access permissions to friends living with you. * /nha untrust <player>: Immediately revoke land usage rights.
• /nha sell: Liquidate the land plot to recover a portion of the investment when relocating.

💻 DEVELOPER PERSPECTIVE (Technical Architecture)

• 100% Server-Side: All 3D particle effects (Particle Engine), sound packets (SoundPackets), and navigation vector calculations (Vector Math) are processed entirely on the server CPU and synchronized directly to the vanilla client.
• New Standard Persistent Storage (SavedDataType):
• Land state data is directly attached to the server.overworld().getDataStorage() system via KyoClaimState.TYPE.
• Integrates a Hybrid UUID Codec (STRING \(\leftrightarrow\) numeric UUID), ensuring seamless backward compatibility with existing on-disk data without risking save file corruption.
• KyoEconomy Integration: Tightly coupled with the KyoEconomy (Modrinth Maven) ecosystem, balancing cash flow through a coin-burning mechanism (sink) derived from land purchase, upgrade, and teleportation fees.

⚙️ SAMPLE CONFIGURATION (config/kyoclaim.json)

{
"basePrice": 5000.0,
"upgradePrice": 20000.0,
"homeTeleportPrice": 1000.0,
"defaultRadius": 16,
"upgradeRadius": 32,
"cmdClaim": ["claim", "nha"],
"cmdInfo": ["info", "thongtin"],
"cmdHome": ["home", "ve"]
}