How Towny works

• Entering landWhen you walk into a town or back into the wilderness, a message above your hotbar says where you are, who owns the plot, and whether PvP is on.
• This chunk/t here shows the town you're standing in. /plot perm shows who owns this chunk and what's allowed there.
• The map/towny map draws the claims around you in chat: H is a home block, O an outpost, $ a plot for sale, + an ordinary plot and - wilderness. Shop, arena, farm and other plot types have their own letters.
• The web mapEvery town's land is on the live web map too.
• Prices/towny prices lists what everything costs.

How much you can claim

• Per playerA town can own 8 chunks for every resident, plus 15 extra for every town. A town of 3 players can own 39 chunks.
• Nations add moreTowns in a nation get bonus chunks that grow with the nation's size: 10 to 140. See Nations & diplomacy.
• Check it/t shows how many chunks your town owns and how many it can have.

Claiming and unclaiming

• Claim/t claim claims the chunk you're standing in. It has to touch your town's land.
• Many at once/t claim rect <radius> or /t claim circle <radius> claims a square or circle around you, up to a radius of 4 chunks.
• CostThe first claims cost 8 gold each, and every chunk after that costs 1 gold more than the last, paid from the town bank.
• Keep your distanceNew claims must be at least 5 chunks from another town's land, unless that town is in your nation. You can't take land another town already owns.
• No open oceanA chunk that's mostly ocean (55% or more) can't be claimed.
• Outposts/t claim outpost claims a chunk away from your town, at least 5 chunks from any other town. Each outpost costs 80 gold and uses one of your town's chunks; there's no other limit on how many you have.
• Unclaim/t unclaim gives up the chunk you're in (no refund). Unclaimed land slowly changes back to how it was before your town claimed it, so take your builds and chests with you.
• Home block/t set homeblock moves your home block to the chunk you're in (it must be your town's). Peaceful towns can't move theirs.

Selling and owning plots

• Put one up for saleMayors and assistants stand in the plot and type /plot forsale <price> (/plot notforsale takes it off the market). Use 0 to give it away for free.
• Buy oneStand in a plot that's for sale and type /plot claim. The price goes to the town bank.
• Give it up/plot unclaim hands your plot back to the town.
• Plot groupsMayors can join several plots into a group with /plot group add <name> and sell or set them all at once.
• ApartmentsWant to sell rooms inside a building? See Apartments on Towns & camps.

The defaults

• Town landThe town's residents can build, destroy, switch and use items. Members of your nation, your allies and everyone else can't do any of those.
• Your own plotOnly you and your friends (/res friend add <player>) can do anything there.
• Plot settingsPvP is on in towns. Fire spread, explosions and hostile mobs are off.

Changing them

• Whole town/t set perm <resident|nation|ally|outsider> <build|destroy|switch|itemuse> <on|off>, e.g. /t set perm ally switch on lets allies open your doors and chests. Mayors and assistants.
• One plot/plot set perm <group> <action> <on|off> while standing in it. On your own plot the groups are friend, town, ally and outsider.
• See what's allowed/plot perm shows the rules for the plot you're in.
• Trust a player/t trust add <player> lets one player act like a resident on your town's land, and /plot trust add <player> does the same for a single plot.
• PvP, fire, explosions, mobs/t toggle pvp (or fire, explosion, mobs) switches it for the whole town; /plot toggle pvp for one plot. PvP can only be switched every 30 seconds, and not while outsiders are in the town.

Settings

• Open or closed/t toggle open lets anyone join without an invite.
• Town board/t set board <message> sets the message residents see when they log in.
• Name and colour/t set name <name> renames the town (10 gold). /t set mapcolor <colour> sets its colour on the map.
• Titles/t set title <player> <title> gives a resident a title shown in chat.
• Invites and kicks/t add <player> invites, /t kick <player> removes. Players who haven't been online for 60 days are removed automatically.
• MergingTwo towns whose home blocks are within 10 chunks of each other can become one: one mayor types /t merge <town>, the other mayor accepts, and the second town joins the first, with its land and residents.

Money

• Bank/t deposit <amount> puts gold in, /t withdraw <amount> takes it out (mayors). /t shows the balance.
• Upkeep10 gold leaves the bank every new day. If the bank can't pay, the town goes into debt and becomes bankrupt: it can't claim land, build, invite players or open up until the debt is paid off. Deposit gold to clear it.
• Town tax/t set taxes <amount> charges every resident each new day. By default it's a percentage of the gold they carry (up to 25%); /t toggle taxpercent switches to a flat amount (up to 1,000 gold). Residents who can't pay are removed from the town.
• Plot taxes/t set plottax, /t set shoptax and /t set embassytax charge the owners of those plots each day. An owner who can't pay loses the plot back to the town.
• CostsEvery price is on Gold & money.

Travel

• Town spawn/t set spawn (in the home block) sets it. /t spawn takes you there for 1 gold, paid to your town.
• Warm-up and cooldownEvery town and nation spawn has a 30-second warm-up: stand still and don't get hurt, or it's cancelled. Afterwards there's a 5-minute cooldown.
• RespawningIf you die without a bed or respawn anchor, you respawn at your town's spawn, with 10 seconds of protection.
• Other towns/t spawn <town> visits another town if it lets you. See Spawn access on Towns & camps.

Outlaws

• Declare oneMayors use /t outlaw add <player> and /t outlaw remove <player>; /t outlawlist shows a town's outlaws.
• What it doesIn your town, an outlaw can always be attacked, even where PvP is off, and can't use /t spawn, /n spawn, /siegetp, /tpa or /home, or teleport out.

• Inside townsHostile mobs don't spawn, crops can't be trampled, endermen can't pick up blocks, and lava and water can't be poured onto someone else's land.
• In the wildernessHoles blown by creepers, TNT, withers and other explosions repair themselves after about 20 seconds.
• VillagersVillagers can't breed.
• DyingEvery death costs 1 gold, which goes to your killer if a player killed you.