Towny is a land protection and town/nation management plugin for Minecraft. It allows players to create towns, claim land, form nations, protect property, and cooperate with others through ranks and alliances. It adds strategic elements like diplomacy, taxation, and territory control.

By default, all chunks are considered Wilderness.

Any player can build, destroy, open chests, and access doors.
Nothing is protected — use caution!
PVP is always enabled.

Tip: To view chunk borders, press F3 + G.

Towny Basics

Towns

A Town is a player-created community that can claim chunks to protect them from other players. The player who creates the town becomes the Mayor. The Mayor can claim Wilderness chunks to turn them into protected town land.

Players who join the town are called Residents.

Claimed land:
- Is protected from non-town members.
- Prevents non-residents from building, breaking, accessing containers, or using items.

Town Bank

Each town has its own Town Bank used to manage the town's economy and pay for:

Land claiming
Stewards
Nation taxes

Bank Access

Anyone can deposit money into the bank by using the comannd /t deposit [amount] [town name]
Only the following town ranks can withdraw money or view the bank's transaction history.
- Mayor
- Co-Mayor
- Deputy Mayor
- Steward
- Finance Manager

To view the town’s bank transaction history, use the following command:/t bankhistory

Creating and Managing Your Town

To start your town:

Go to the spawn area and hire an Architect.
The Architect will follow you as you explore, even inbetween worlds.
When you find a suitable location, right-click the Architect and select "Create Town".
This will establish your town, and you will automatically become the Mayor.

The chunk you are standing in when creating the town will become the homeblock. The exact block you are standing on will become the town spawn, to travel to town spawn do /t spawn. If your a Mayor, Co-Mayor & Deputy Mayor and want to change the location of town spawn do /t set spawn, or change the homeblock location using /t set homeblock

Requirements

You must have at least 300⌾ in your player bank.
Your town must be at least 128 blocks (8 chunks) away from another town.
If you are too close to another town, you will not be able to create a new one.

Renaming Your Town

To rename your town, use the command /t set name [new town name].

Inviting Players to Your Town

After creating your town, you can invite players who aren't already in a town by using the command/t add [username].

Leaving and Removing Players

Residents can leave the town anytime using /t leave. The mayor can also kick players from the town with /t kick [username].

Active Upkeep

ActiveUpkeep replaces the default Towny upkeep. Instead of requiring money to sustain your town, players must now remain active to keep it thriving. A variety of in-game actions contribute to a player’s individual activity score.

Activity Decay

Every player has an activity score that fluctuates based on their daily engagement, players must reach the activity threshold to be considered an active member of a town. The maximum score you can achieve far exceeds the threshold, allowing you to “bank” activity for a period of time. However your score will decay over time and will decrease faster the longer you haven’t played but slower if you have been consistently active.

Inactivity

If all residents of a town become inactive, the town will be marked as inactive, if this continues for 4 days then the town will be removed from the nation it’s in, this serves as a warning sign that the town is inactive. The town then has 3 days to increase activity otherwise on the 7th day of inactivity the town will go to ruin.

Checking Activity

Players can check their own activity and that of other players by typing /activity or /activity [username].

Claiming Land

Claiming is the process of converting an unclaimed chunk from the wilderness into part of your town’s territory. Every claimed chunk is referred to as a claim or town plot.

When you create a town, the chunk you are standing on is immediately claimed as your homeblock.

Expanding Your Town

To add a new claim, stand on a wilderness chunk that is adjacent to your current town claims and type /t claim. After the first 3 or 4 first claimed chunks, any addtional claims must be adjecent to atleast 3 of your town's existing claims.

Maximum Claims

A town can have a maximum of 690 total claims. The claim bonus from active members caps at 500, which is fully reached once 14 residents are active. Any additional active residents beyond that point won’t increase the town's claim capacity further, however you can still add them into your town. The table below summarizes the sources that contribute to the total limit:

Source	Claim Cap	Notes
Base Claims	10	Default for all newly created towns
Bonus Claims (Residents)	500	+35 claims per active resident, only active players count
Nation Bonus	100	Granted for being in a full-sized nation
Housing Steward Bonus	80	Requires Level 3 Housing Steward

Claim Cost Breakdown

Claim	Type	Individual Cost	Cumulative Cost
10	Base	472⌾	3,188⌾
50	Bonus	221⌾	10,519⌾
100	Bonus	364⌾	24,915⌾
150	Bonus	598⌾	48,590⌾
200	Bonus	984⌾	87,527⌾
250	Bonus	1,618⌾	151,568⌾
300	Bonus	2,661⌾	256,894⌾
350	Bonus	4,376⌾	430,116⌾
400	Bonus	7,196⌾	715,000⌾
450	Bonus	11,835⌾	1,183,527⌾
500	Bonus	19,464⌾	1,954,091⌾
550	Bonus	25,000⌾	3,134,328⌾
600	Bonus	25,000⌾	4,384,328⌾
650	Bonus	25,000⌾	5,634,328⌾
690	Bonus	25,000⌾	6,634,328⌾

Claim Cost Calulator

Current Claim Summary
• Existing claims: 10 • 10

Bonus Claims to Purchase
• Bonus claims: 0 • 0 • (You can buy up to 680 bonus claims)

Cost Breakdown
• Cost for 0 bonus claims: 0 ◎
• Total cost for 10 claims: 2716 ◎

Buying & Owning Plots

Any member of a town—including the Mayor—can own plots (chunks) within the town. These are known as resident plots. Once claimed, a resident has personal control over the plot and can use it however they like, within town rules. Residents can own multiple plots.

Claiming a Plot

To claim a resident plot, it must first be put up for sale: The mayor (or other authorized official) stands on the plot and types:
/plot forsale (price)
A resident or mayor can then claim the plot by standing on it and typing:
/plot claim

Plots can be set at 0⌾ to allow free claiming, effectively granting the land.

Withdrawing or Unclaiming Plots

To remove a plot from sale, the mayor can stand on the plot and types:
/plot notforsale
To unclaim a plot, a resident can stand within their own plot and types:
/plot unclaim

Joining a Nation

To join a nation, a town must meet the following conditions:

The town must have at least 3 residents.
The town’s Mayor must be invited by an existing nation or create a nation themselves.

Accepting or Denying a Nation Invite

If a town has received a nation invitation, the Mayor can respond using one of the following commands:

To accept the invitation: /accept (nation name)
To deny the invitation: /deny (nation name)

Once accepted, the town officially becomes part of the nation.

Nation Tax

When a town joins a nation, it may have to pay a daily nation tax, if the nation has taxes enabled. from the town bank and set by the nation's leader.

This tax is automatically withdrawn from the town’s bank each day.
The amount is determined by the nation’s leader.

To view the current nation tax rate, use: /towny prices or /n

Permissions

Managing the Town

Town Rank

In a town, players may be assigned ranks to represent their responsibilities and access levels. Every resident has basic permissions, but ranked roles allow further interaction with town systems and management commands. === Default Resident Permissions === All town members automatically have access to:

Deposit money: /town deposit (amount)
Claim or unclaim personal plots: /plot claim, /plot unclaim
Manage own plot settings: /plot set perm, /plot set reset
Use basic town functions: /town spawn, /town leave

Town Rank Overview

Rank	Description	Key Abilities
Mayor	Town leader with full control.	Invite/kick, claim land, set ranks, set taxes, withdraw funds. Tax-exempt. `/town invite`, `/town claim`, `/town withdraw`
Co-Mayor	Shares full permissions with the Mayor, including the ability to take over the town. Should be given only to trusted individuals. Tax-exempt.	All mayoral abilities including takeover. `/town set mayor`, `/town delete`
Deputy Mayor	High-level assistant without destructive powers (e.g., can't delete town or assign mayors). Tax-exempt.	Most town management. `/town set taxes`, `/town claim`
Steward	General administrator combining permissions of multiple specialized roles.	Plot, finance, invitation, and utility management. `/town set plotprice`, `/town withdraw`
Land Manager	Oversees claiming, unclaiming, and plot access.	`/town claim`, `/town unclaim`, `/plot set perm`
Finance Manager	Manages town economy including taxes and pricing.	`/town set taxes`, `/town withdraw`, `/town set plotprice`
Culture Manager	Handles town culture-related settings and permissions.	`/town toggle`, `/town set name`
Sheriff	Responsible for jail and outlaw systems.	`/town jail`, `/town outlaw`, `/town unjail`
Builder	Trusted with general build access across town land.	`/plot set perm build on`, `/towny claimed townowned`
Assistant	Can invite/kick players, manage switches, and set unowned plots.	`/town invite`, `/plot set`
Tax-Exempt	Assigned to residents who are exempt from town taxes.	`/towny tax_exempt`

Town Board

The town board is a customizable message set by town mayor. It serves as a public announcement for both residents and visitors.

To create or update your town board message, use the command: /t set board (your message) Once set, the board will be visible in the following places:

Residents: Displayed when residents join the server and in /t.
Visitors: Shown in the town’s info screen via /t (town name).

Closed/Open Town

By default, all towns are set to closed status, meaning they are invite-only. Players can only join a closed town if they are invited by a town official, typically a Mayor, Co-Mayor, Deputy Mayor, or Assistant.

Open Towns

If a town is set to open, any player can freely join using the command, /t join (town name). Open towns are marked with (Open) next to their name in the town list displayed via: /t list

Changing AccessSettings

Mayors can toggle their town’s status between open and closed at any time with: /t toggle open

Public and Private Towns

By default, all towns are set to private. This restricts teleportation to the town spawn—only the following players can access it: - Town residents - Members of the same nation - Members of allied nations If a town is set to public, any player on the server can teleport to its town spawn.

Identifying Public Towns

Public towns are marked with (Public) in their town info screen (e.g., /t or /t [town name]). Additionally, the homeblock’s chunk coordinates are shown for public towns.

Changing Public Status

To toggle between public and private status, use: /t toggle public

Town Taxes

Towns can apply multiple types of taxes to their residents and landowners. These taxes help manage town revenue and encourage active participation.

Resident Tax

This is a general tax charged to all town members. - Set using: /t set taxes (amount or percentage) - Toggle flat vs. percentage mode: /t toggle taxpercent

Flat Tax

Charges a fixed amount from each resident's balance daily.
- If a resident cannot pay, they are automatically removed from the town.

Percentage Tax

Charges a percentage of each resident’s current balance.
- Residents unable to pay are also removed.
Use /t set taxpercentcap (amount) to set a maximum tax limit.

Resident Plot Tax

A per-plot tax charged to residents who own plots within the town.

Set using: /t set plottax (amount)
- If a resident cannot pay, ownership of the affected plots is revoked.
- Unpaid plots are automatically listed for sale.

Shop Plot Tax

Tax applied specifically to plots containing shop signs or shops.

Set using: /t set shoptax (amount)
- Failure to pay results in loss of the shop plot.
- Any shop signs are removed when the plot is lost.

Embassy Plot Tax

A tax applied to non-residents who own embassy plots in your town.

Set using: /t set embassytax (amount)
- If unpaid, the embassy plot is removed from the owner and returned to town control.

Tax Stacking

Taxes are additive. Below are common stacking examples:

A resident who owns a shop plot pays: Resident Tax + Plot Tax + Shop Plot Tax
A non-resident who owns an embassy plot pays: Plot Tax + Embassy Plot Tax

Titles and Surnames

Certain players with permissions in a town or nation can assign custom names to residents. These names appear in chat and consist of:

A title (prefix) appears before the player’s name.
A surname' (suffix) appears after the player’s name.

Titles

Titles appear before a player's name in chat.
They can be up to 15 characterslong.

Granting a Title

Town Titles

Granted by: Mayor or Co-Mayor Command: /t set title (player) (title)

Nation Titles

Granted by: Nation Leader or Co-Leader Command: /n set title (player) (title)

Surnames

Surnames appear after a player's name in chat.
They can also be up to 15 characters long.

Granting a Surname

Granted by: Mayor or Co-Mayor
Command: /t set surname (player) (surname)

Removing a Title or Surname

Remove Town Title: /t set title (player)
Remove Nation Title: /n set title (player)
Remove Surname: /t set surname (player)

Transferring Mayorship

The current Mayor of a town can choose to step down and pass their leadership role to another trusted resident.

How to Transfer Mayorship

To assign a new Mayor, use the following command: /t set mayor (new mayor's name) Once the transfer is successful: - The selected resident becomes the new Mayor with full leadership powers.

The previous Mayor is automatically demoted to a regular resident and loses all assigned town ranks.

Note: Only transfer mayorship if absolutely necessary and only to someone you trust completely. The new Mayor will have full control over the town, including its claims, finances, ranks, and even the ability to delete or rename the town.

Deleting a Town

Deleting a town will cause the town to go into ruin and after 24 hours of run will be permanent deleted. The following will be deleted when the town gets deleted.

Name and identity
Claimed land
Residents and their roles
Town bank balance
Steward and infrastructure
- Only the Mayor has the authority to delete the town.

How to Delete a Town

To delete your town, follow these steps:

Withdraw funds first. Any money left in the town bank will be permanently lost. Use: /t withdraw (amount)
Delete the town: /t delete
Then confirm with: /confirm

After confirmation, the town enters a ruin period, where its former territory can be reclaimed or looted by others/