AuraTown

🏙️ Features

Found your own town with a custom name and claim the chunk you're standing in Expand your territory by claiming additional chunks over time Three-tier membership system — Owner, Member, and Worker (Coop) Invite players to your town with a timed invite system that auto-expires Per-member permission management through a clean interactive 9-slot GUI Workers can only place and break blocks — nothing more, nothing less Complete chunk protection against outsiders — no building, breaking, interacting, opening containers, trampling crops, triggering explosions, or dealing PvP damage Town bank system — members can deposit, only the owner can withdraw Claim and unclaim chunks at any time with configurable costs per chunk Set a town spawn point and teleport to it with a single command Live ASCII chunk map rendered directly in chat showing your surroundings On-screen title and subtitle displayed whenever you enter or leave a claimed chunk Leave and disband confirmations to prevent accidental data loss All town data persists across server restarts automatically Every message, cost, limit, timer, and permission default is fully configurable

⚙️ Requirements

Minecraft 1.21+ Java 21 Vault plugin installed and enabled An economy plugin compatible with Vault (e.g. EssentialsX, CMI)

📦 Installation Download the latest AuraTown .jar file from the files tab Place the .jar into your server's /plugins folder Make sure Vault and an economy plugin are already installed Start or restart your server AuraTown will generate a config.yml inside /plugins/AuraTown/ automatically Edit config.yml to your liking and run /reload or restart the server to apply changes

AuraTown — All Commands

/town create Founds a new town at your current chunk. Deducts the creation cost from your Vault balance. You can only own one town at a time. The town name must match the configured regex and length limits.

/town disband Permanently deletes your town, removes all claims, kicks all members and workers. Requires typing the command twice within the confirmation timeout to prevent accidents.

/town invite Sends a timed invite to an online player. The invite expires after the configured number of seconds. Only the town owner can invite. The target must not already belong to a town.

/town accept Accepts a pending town invite. Must be used before the invite expires.

/town deny Rejects a pending town invite. Notifies the town owner of the refusal.

/town leave Leaves your current town. Requires typing the command twice to confirm. Town owners cannot leave — they must disband first.

/town kick Removes a member from your town. Only the owner can kick. Cannot kick yourself.

/town claim Claims the chunk you are currently standing in for your town. Deducts the chunk claim cost from your balance. Cannot claim an already-claimed chunk or exceed the max claim limit.

/town unclaim Removes your town's ownership of the chunk you are standing in. Cannot unclaim the chunk where the town spawn is set.

/town coop Adds an online player as a worker. Workers can only break and place blocks — nothing else. The player must not already be a full member.

/town uncoop Removes a player's worker status. They lose all access to your town's chunks immediately.

/town perms Opens a 9-slot interactive GUI showing all toggleable permissions for the selected member. Click any slot to flip that permission on or off. Can also be used as /town perms <true/false> directly in chat.

/town deposit Deposits money from your personal balance into the town bank. Any member can deposit.

/town withdraw Withdraws money from the town bank into your personal balance. Only the town owner can withdraw.

/town info [town] Displays detailed information about a town — owner, member count, worker count, claimed chunks, bank balance, and founding date. If no town name is given, shows your own town.

/town list Lists every founded town on the server with its owner and member count.

/town map Renders an ASCII grid in chat showing the chunks around you. Your town's chunks are green, other towns are red, wilderness is gray, and your position is marked with a gold symbol.

/town spawn [town] Teleports you to a town's set spawn point. If no name is given, teleports to your own town's spawn.

/town setspawn Sets the town's spawn point to your current location. You must be standing inside a claimed chunk of your own town.

/town Typed alone with no arguments, prints the full command list to your chat, one line per command.