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.