Towny is a land protection and management plugin that allows players to claim land, creating towns and nations. Alathra has added numerous customizations to the default Towny setup, most notable of which is the change from monetary upkeep to an activity-based upkeep system.

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

Wilderness
By default, all land is considered Wilderness:

  • Anyone can build, break, and interact
  • PVP is always enabled
  • Nothing is protected — be cautious!

Towny Basics

What is a Town?

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.

Role Description
Mayor Founder and administrator of the town
Resident Player who joins a town

Claimed land protects:

  • Against non-residents building or breaking blocks
  • Access to chests, doors, and containers

Creating a Town

To create a town, you must have 300⌾ in your personal bank, then head to spawn, /spawn.
1. Hire an Architect from Lord Crowley at spawn.

 

2. Lead the Architect to your desired location, it must be 128 blocks (8 chunks) away from another town.
3. Right-click the Architect and select "Create Town".

 

4. The chunk you stand in becomes the homeblock, and your exact position becomes the town spawn.

To change town spawn or homeblock:

  • Set spawn: /t set spawn
  • Set homeblock: /t set homeblock

To rename, invite, leave, kick commands:

  • Rename town: /t set name [new name]
  • Invite: /t add [username]
  • Leave: /t leave
  • Kick: /t kick [username]

When a town is created town residents will have zero permissions in the town, it is up to the town mayor to configure these permissions for the town residents.

Town Bank

Each town has its own Town Bank used to manage the town's economy and pay for land, stewards, and nation taxes. Anyone can deposit money into the bank, even non-residents.
Bank commands:

  • Deposit: /t deposit [amount] [town name]
  • Withdraw: /t withdraw [amount]
  • View history: /t bankhistory

Withdraw permissions:

  • Mayor
  • Co-Mayor
  • Deputy Mayor
  • Steward
  • Finance Manager

ActiveUpkeep System

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 Effects

Towns are sustained through the activity of their residents. If all members of a town become inactive, the town will begin an inactivity countdown. Inactivity Progress:

  1. When a town has no active residents, it is marked as inactive.
  2. If the town remains inactive for 4 consecutive days, it will be automatically removed from its nation.
  3. This serves as a warning sign that the town is no longer active.
  4. If the town remains inactive for an additional 3 days, bringing the total to 7 consecutive days, it will enter into ruin.

Check activity: Players can check their own or others' activity using: /activity or /activity [username]

Making Claims

  • Stand in a Wilderness chunk near your town
  • Type /t claim
  • After 3–4 claims, new claims must border 3 existing town 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 Table

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: 1010


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


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

Overclaim

When a town enters overclaim, it means the town has claimed more land than it's allowed to. This prevents any further land from being claimed until the town reduces it's claimed land to the claim available to the town or increase activity of your residents. Overclaim can happen for a couple of reasons:

  • A town resident goes inactive, reducing the total number of available claims.
  • Fired your bailiff steward, removing the claim bonus it provides to your town.
  • The town leaves its nation, losing bonus claim chunks granted by the nation.

Resident Plots

Within a town, individual chunks can be assigned to residents as their personal plots. These are known as resident plots and can be owned by any member of the town, including the Mayor. Once owned, the resident has full control over how the land is used, within the rules set by the town.
Residents may own multiple plots, and they can use them for personal builds, shops, housing, etc.

Claiming a Plot

To claim a plot, it must first be listed for sale by an authorized official.

Authorized officials include:

  • Mayor
  • Co-Mayor
  • Deputy Mayor
  • Land Manager

Steps to claim a plot:
An authorized official stands on an unclaimed town chunk and types: /plot forsale [price]. A resident (or the Mayor) then stands on the same plot and types: /plot claim. The plot is then transferred to the resident, and its ownership is displayed in the plot info.

Note: Plots may cost ⌾ to claim. The price is set by the official putting it up for sale, and plots can also be listed for free to allow easy claiming or gifting.

Unclaiming Plots

  • Remove a plot from sale: /plot notforsale
  • Unclaim your own plot: /plot unclaim


Once unclaimed, the plot returns to general town ownership and can be re-listed or reassigned as needed.

Joining a Nation

Joining a nation allows a town to participate in broader regional alliances, benefit from claim bonuses, and engage in diplomatic relationships with other towns and nations.

Requirements to join a nation

  • The town must have at least 3 residents.
  • The Mayor must receive an invitation to join a nation

Accepting or Denying a Nation Invite
If the town has received an invitation from a nation, the Mayor may respond using one of the following commands:

  • Accept the invitation: /accept [nation name]
  • Deny the invitation: /deny [nation name]

Once accepted, the town becomes an official member of that nation. The town will then gain access to any nation related perks, such as increased claim capacity, shared diplomacy, and protected alliances.

Nation Tax

Some nations may charge a daily nation tax to help sustain the nation’s upkeep or to make money.

  • The tax is automatically withdrawn each day from the town bank.
  • The tax amount is determined and adjusted by the nation's leader.
  • If the town bank lacks sufficient funds to cover the tax, consequences may include automatic removal from the nation.

To check the current tax rate, use either of the following commands: /towny prices or /n

Permissions

Permissions are extremely important withn towns, by default residents will have zero permissions. It is the responsibility of the mayor to setup permissions for their residents.

Permission Type Description
build Allows placing blocks, boats, minecarts, item frames, and armor stands; also placing items inside item frames.
destroy Allows breaking blocks, using hoes and axes on blocks, and eating cake.
switch Allows interacting with doors, trapdoors, redstone components, containers, and rotating items in item frames.
itemuse Allows using potions, eggs, fishing rods, buckets, flint and steel, leads, boats, minecarts, armor stands, SlimeFun machines, and more.

Permission Levels

Permissions are grouped by level, which determines who can perform certain actions. There are two categories: Town Plot Permissions (for unowned plots) and Resident Plot Permissions (for owned plots).

Town Plot Permission Levels

These apply to unowned town plots:

  • resident: All residents of the town
  • nation: Members of your own nation
  • ally: Members of allied nations (not your own)
  • outsider: All other players

Resident Plot Permission Levels

These apply to resident-owned plots:

  • friend: Players on your personal friend list
  • town: All residents of your town
  • ally: Members of your nation and allied nations
  • outsider: All other players
Town Permissions
Nomad Permission
Command Description
/towny map View the Towny map showing town claims
/towny prices Check Towny-related prices
/towny tree View Towny's command tree
/towny time Display the current Towny time
/towny universe General server stats related to Towny
/towny version Show the current Towny plugin version
/towny war View war status and information
/town online View which town members are online
/town here View info about the town you're currently in
/town new Create a new town
/town join Join an existing town (with invite)
/town list List all towns on the server
/town plot perm Check plot permissions
/nation list List all nations on the server
/nation townlist List towns in a nation
/nation allylist List allies of a nation
/nation enemylist List enemies of a nation
/town resident View your own resident info
/town spawn public Teleport to a public town spawn
/towny chat general Join the general Towny chat channel
/towny chat local Join the local town chat channel
/towny war hud Display the war heads-up display
/towny plot trust Manage trusted players for your plots
/towny plot group Manage your plot groups
/town ranklist View the town's rank list
/towny nation ranklist View the nation’s rank list
/towny town list Alternative way to list all towns
/towny resident set about Set an "about me" on your profile
/towny resident outlawlist View list of outlaws in your town
Resident Permissions
Command Description
/towny resident View your resident information
/towny plot claim Claim a plot for yourself
/towny plot unclaim Unclaim a previously claimed plot
/towny plot forsale Mark a plot as for sale
/towny plot notforsale Remove a plot from being for sale
/towny plot toggle Toggle plot settings (e.g., fire, pvp)
/towny plot set perm Set permissions on your plot
/towny plot set reset Reset plot permissions to default
/towny town online Show town members who are online
/towny town leave Leave your current town
/towny town deposit Deposit money into the town bank
/towny town spawn Teleport to your town's spawn
/towny town reclaim Reclaim the town if it has fallen
/towny town list List all towns on the server
Mayor Permissions
Command Description
/towny tax_exempt Exempt a resident from taxes
/towny towny top Show top towns/nations by value
/towny town View/manage your town
/towny plot Access plot tools and options
/towny claimed owntown Show town-owned claimed land
/towny nation new Create a new nation
/towny outlaw jailer Manage outlaw jailing
/towny town autoclaim Auto-claim land while walking
/towny nation join Join a nation
/towny nation leave Leave your current nation
/town rank Manage or view town ranks
/town set Change town settings (name, taxes, etc.)
/towny buy Buy additional town blocks/resources
/town plots List town plots
/town toggle Toggle town settings (e.g., pvp, fire)
/town say Broadcast a message to the town
/town claim Claim a chunk for your town
/town claim town Claim land on behalf of the town
/town claim town outpost Claim an outpost
/town unclaim Unclaim land from the town
/town delete Delete the town
/towny plot asmayor Manage plots as the mayor
/town outlaw Mark a player as an outlaw
/town withdraw Withdraw money from town bank
/town invite add Invite a player to the town
/town invite sent View sent invitations
/town add Add a player to the town
/town kick Remove a player from the town
/townyban ban Ban a player from the town
/townyban unban Unban a player from the town
/townyban banlist View all banned players
/townyban banlist town View town-specific banlist
/town rank steward Assign the steward rank
/town rank land-manager Assign the land-manager rank
/town rank node-manager Assign the node-manager rank
/town rank finance-manager Assign the finance-manager rank
/town rank sheriff Assign the sheriff rank
/town rank culture-manager Assign the culture-manager rank
/town rank builder Assign the builder rank
/town rank assistant Assign the assistant rank
/town rank tax-exempt Grant tax-exempt status
/towny set mayor Appoint a new mayor
/town set name Change the town's name
/towny rankpriority 90 Set deputy-mayor rank priority
Co-Mayor
Command Description
/towny tax_exempt Exempt a resident from paying town taxes
/town rank Manage resident ranks within the town
/town set Modify town settings (taxes, spawn, etc.)
/towny buy Purchase additional town blocks
/town plots List all plots in the town
/town toggle Toggle settings like PvP, fire, explosion, etc.
/town say Broadcast a message to all town residents
/town claim Claim land chunks for the town
/town claim town Claim land on behalf of the town
/town claim town outpost Claim an outpost plot
/towny claimed owntown Show town-owned claimed land
/town unclaim Unclaim land previously claimed
/towny top Display top towns by ranking or wealth
/town delete Permanently delete the town
/towny plot Access plot management features
/towny nation new Create a new nation for the town
/towny nation join Join an existing nation
/towny nation leave Leave the current nation
/towny plot asmayor Manage town plots as if you were the mayor
/town outlaw Designate a player as an outlaw
/towny outlaw jailer Jail a designated outlaw
/town withdraw Withdraw money from the town bank
/town invite add Invite a player to join the town
/town invite sent View pending invitations sent to players
/town add Add a resident to the town
/town kick Remove a player from the town
/townyban ban Ban a player from the town
/townyban unban Unban a previously banned player
/townyban banlist View the full ban list
/townyban banlist town View town-specific ban list
Deputy Mayor
Command Description
/towny tax_exempt Exempt residents from town taxes
/town rank steward Assign the Steward rank to a resident
/town rank land-manager Assign the Land-Manager rank
/town rank node-manager Assign the Node-Manager rank
/town rank finance-manager Assign the Finance-Manager rank
/town rank sheriff Assign the Sheriff rank
/town rank culture-manager Assign the Culture-Manager rank
/town rank builder Assign the Builder rank
/town rank assistant Assign the assistant rank
/town rank tax-exempt Assign tax-exempt status to a resident
/town set Change town settings (taxes, name, etc.)
/towny set mayor Change the town mayor
/town set name Rename the town
/town toggle Toggle settings such as PvP, explosions, fire, mobs
/towny buy Purchase additional town blocks
/towny plot as mayor Modify plots with mayor-level control
/towny town outlaw Designate outlaws within the town
/towny outlaw jailer Jail outlaws
/town withdraw Withdraw funds from the town bank
/town invite add Send invitations to join the town
/town invite sent View sent invitations
/town add Add a resident to the town
/town kick Remove a player from the town
/towny plot Access town plot management features
/town claim Claim land for the town
/town unclaim Unclaim previously claimed land
/towny claimed owntown View land claimed by the town
/townyban ban Ban a player from the town
/townyban unban Unban a previously banned player
/townyban banlist View the town-wide ban list
/townyban banlist town View ban list specific to your town
Steward
Command Description
/town rank tax-exempt Assign tax-exempt status to a resident
/town withdraw Withdraw money from the town bank
/town invite add Send an invitation to a player to join the town
/town invite sent View a list of sent invitations
/town add Add a player to the town manually
/town kick Remove a player from the town
/town plot Manage plots owned by the town
/town unclaim Unclaim town-owned land
/town claim Claim land for the town
/town set taxes Set the daily tax for all residents
/town set plottax Set the daily tax for all owned plots
/town set shoptax Set the tax for plots with shop type
/town set embassytax Set the tax for embassy plots
/town set plotprice Set the price of plots sold by the town
/town set shopprice Set the price of shop plots
/town set embassyprice Set the price for embassy plots
/towny claimed owntown View claimed town blocks
Land Manager
Command Description
/towny claim owntown Claim land for the town (town-owned claim)
/towny plot Access and manage town plots
/town unclaim Unclaim land previously claimed by the town
/town claim Claim land for the town
Finance Manager
Command Description
/town set taxes Set the overall town taxes
/town set plottax Set the tax rate for town plots
/town set shoptax Set the tax rate for shop plots
/town set embassaytax Set the tax rate for embassy plots
/town set plotprice Set the price of town plots
/town set shopprice Set the price of shop plots
/town set embassyprice Set the price of embassy plots
/town buy Purchase town blocks
/town set taxpercentcap Set the maximum tax percentage allowed
/town withdraw Withdraw money from the town bank
Sheriff
Command Description
/town toggle jail Enable or disable the town jail feature
/towny outlaw jailer Manage jailed outlaws in the town
/town jail Jail a player
/town unjail Release a player from jail
/town jail list View the list of jailed players
Assistant
Command Description
/town invite add Send an invitation to a player to join the town
/town add Add a player to the town manually
/town kick Remove a player from the town
/towny townowned switch Switch permissions related to town-owned blocks
/towny plot set Set permissions or properties on a town plot

Managing the Town

Town Rank

Within a town, players may be assigned specific ranks that determine their responsibilities and access to various town interactions. While all residents have access to basic commands, higher ranks allow for more administrative interaction.

Default Resident Permissions

All town members automatically have access to:

  • Deposit money: /t deposit [amount]
  • Town Spawn: /t spawn
  • Town Lists: /t list
  • Town Reclaim: /t reclaim
  • Leaving Town: /t leave

Town Rank Overview

Rank Description Example Permissions
Mayor The town’s leader with complete authority. Can manage claims, finances, ranks, and town settings. Always tax-exempt. /t set taxes
/t claim
Co-Mayor Shares all mayoral powers, but cannot delete the town or assign a new Mayor. Tax-exempt. Manages residents, finances, plots, and invites.
/t claim, /t withdraw
Deputy Mayor A trusted manager with broad authority, but restricted from critical changes like deletion or renaming. Tax-exempt. /t kick
/t set name
Steward A general overseer with a blend of building, financial, and invitation rights. /t withdraw
/t set plotprice
Land Manager Manages land claims and plot access across town plots. /t claim
/plot set perm
Finance Manager Controls town taxes, plot pricing, and bank access. /t set taxes
/t withdraw
Culture Manager Handles town naming and ceremonial elements. /t set name
/t toggle
Sheriff Enforces town law through jail and outlaw systems. /t jail
/t outlaw
Builder Granted general build rights on town-owned land. /plot set perm build on
Assistant Helps with resident management and minor plot settings. /t invite
/plot set
Tax-Exempt Assigned to residents who are exempt from town tax. /t 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.
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
Mayor, Co-mayor, Deputy Mayor can toggle their town’s status between open and closed at any time with: /t toggle open

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 impose multiple types of taxes to sustain steward upkeep, encourage participation, and manage land ownership. Taxes apply daily and can be adjusted by town Mayor, Co-Mayor, Deputy Mayor, Steward, Financial Manager.

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

Stewards

Stewards provide special upgrades that enhance your town with new functionality and benefits. Each steward is tied to a specific chunk within your town's claim and only one of each steward can exist in a town. Current they are 5 different types of stewards a town can have;

Architect
Every town has an Architect straight away, they are required to create a town, an architect is a way for towns to hire the other stewards. The Architect doesn't have any upgrades or daily cost.

Treasurer
The Treasurer will increase the town’s bank capacity allowing town residents to store more money into the town bank.

Level Bank Capacity Cost Biome
1 25,000 5,000⌾ Any
2 50,000 10,000⌾ Any
3 100,000 20,000⌾ Any
4 200,000 40,000⌾ Any

Bailiff
The Bailiff will provide the town with extra claim bonus, allowing the town to expand and claim more land.

Level Bonus Claims Cost Biome
1 +20 20,000⌾ Any
2 +40 40,000⌾ Any
3 +80 80,000⌾ Any

Port Master
The Port Master provides the town the ability to have a port, which can be used by players to travel to the town across oceans and gives the town an extra source of income when the port is used by players.

Level Name Cost Daily Cost Stipend Biome
1 Jetty 12,500⌾ 125⌾ 625⌾ Ocean
2 Dock 22,500⌾ 225⌾ 1,125⌾ Ocean
3 Harbor 42,500⌾ 425⌾ 2,125⌾ Ocean
4 MegaPort 70,000⌾ 700⌾ 3,500⌾ Ocean

Stable Master
The Stable Master provides the town the ability to have a stable, which can be used by players to travel to the town on the same landmass and gives the town extra source of income when the port is used by players.

Level Name Cost Daily Cost Stipend Biome
1 Foal Pen 11,000⌾ 150⌾ 525⌾ Any
2 Colt Station 20,000⌾ 220⌾ 1,100⌾ Any
3 Stallion Yard 40,000⌾ 400⌾ 2,000⌾ Any

Stewards on Strike

Some stewards do have a daily cost that comes out of the town bank each towny day. If the town can’t afford to pay it’s stewards then they will go strike and stop providing the bonuses, this only affects the Port and Stable Master. To end the strike the town must pay the stipend cost, once that is paid the steward will go back to providing it’s bonuses to the town.

Titles and Surnames

In both towns and nations, players with the appropriate permissions can assign custom titles and surnames to residents. These appear in chat and consist of:

  • A title (prefix) displayed before the player’s name
  • A surname (suffix) displayed after the player’s name

Both titles and surnames may be up to 15 characters long.

Assigning Titles

  • Town Titles

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

  • Nation Titles

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

Assigning Surnames

  • Granted by: Mayor, Co-Mayor, Deputy Mayor
  • Command: /t set surname (player) (surname)

Removing Titles and Surnames

  • 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 (player) 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 being in ruin 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:

  • 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.

Town Ruin Period

When a town falls into ruin, whether due to inactivity or deletion, it enters a 24-hour ruin period. During this time:

  • All town Stewards are downgraded to Level 1, except for the Bailiff.
  • If the town is not reclaimed within 24 hours, it is permanently deleted, and all data (bank, claims, residents, etc.) is lost.

Reclaiming a Ruined Town

Former residents may reclaim a ruined town during the 24-hour window using: /t reclaim

  • Reclaiming costs 500⌾, deducted from the player's personal balance.
  • The player who reclaims the town becomes the new Mayor.
  • Upon reclaim:
    • The town is fully restored under the new leadership.
    • A 7-day activity grace period begins.

If the town does not meet the required activity threshold within those 7 days, it will re-enter ruin, and the cycle may repeat.

Plot Functions

Toggles are settings that control certain game rules within town plots or the entire town. These can be applied globally (to all plots in a town) or individually (to specific plots), allowing mayors and residents to customize behaviors like PvP, fire spread, and explosions.

Town-Wide Toggles

To toggle a setting across all plots in your town, use: /t toggle (toggle type)

Individual Plot Toggles

To toggle a setting for a single plot, whether it's resident-owned or town owned, stand in the plot and use: /plot toggle (toggle type)

Available Toggle Types

  • pvp – Enables or disables PvP in the plot(s).
  • fire – Controls fire spread.
  • explosions – Allows or blocks explosion damage within the plot(s).

Viewing Current Toggles

  • Town-Wide: View all current town toggles via the town info screen: /t
  • Per-Plot: View active toggles for your current plot using: /plot perm

Plot Names & Notifications

Towns can assign names to individual plots for identification, organization, or flavor. These names appear in on-screen plot notifications when a player enters the area.

Renaming a Plot

Plots can be renamed by:

  • The plot owner – if it is a resident-owned plot.
  • The Mayor or other authorized town staff – for any unowned or owned plot.

To rename a plot while standing in it: /plot set name (plot name)
To remove an existing plot name: /plot set name

Plot Types

When a chunk is claimed from the Wilderness, it becomes a default plot. This is a standard town plot with no special function until configured otherwise.

Resident Plots

Default plots can be sold to or granted to a town resident, converting them into resident plots. These are personally owned plots within the town. A resident plot may be lost or reverted to default if:

  • The owner fails to pay the resident plot tax.
  • The owner leaves the town or manually unclaims the plot using: /plot unclaim
  • The Mayor, Co-Mayor, Deputy Mayor, or Assistant evicts the resident using: /plot evict

Setting Plot Types

To assign a type to an unowned town plot, use: /plot set (plot type)
To revert a plot to default: /plot set reset
You can view all plot types and relevant town statistics with: /t plots

Available Plot Types

Plot Type Description
arena Enables PvP and friendly fire within the plot.
bank Allows residents to deposit money into the town and nation banks, and experience into the nation XP bank (applicable in Nations only).
embassy Allows non-residents to own plots in your town. Embassy plots may be taxed separately. If the owner's nation becomes your enemy, they lose ownership. Otherwise functions like a resident plot.
farm Restricts block interaction to farming actions only—such as planting/destroying crops, trees, and interacting with passive mobs (cows, pigs, sheep, chickens, mooshrooms).
inn Allows players from non-enemy nations to set their spawn point there (Towny only).
jail Houses jailed players. You can have multiple jail plots, each numbered chronologically upon creation.
shop Enables player-run shops (Nations only). Shop plots may be taxed separately but otherwise behave like resident plots.

Plot Groups

lot groups allow players to manage multiple town plots at once—for example, updating permissions, setting plot types, or configuring sale pricing. Plot groups improve efficiency for both staff and residents managing several plots.

  • Town staff (Mayor, Co-Mayor, Assistant) can create and manage plot groups involving any town plot.
  • Residents can only create and manage plot groups that include their own resident plots.

View all plot groups in your town with: /t plotgrouplist
Note: All plot group commands must be run while standing within a plot in the target group, except when adding plots.

Creating and Editing Plot Groups

  • Add a plot to a group (or create one): /plot group add (group name)

This creates the plot group if it doesn't exist. It also moves a plot into another group if already grouped.

  • Rename a plot group (while inside it): /plot group rename (new name)
  • Remove the current plot from its group: /plot group remove
  • Delete the entire group (from any of its plots): /plot group delete

Removing the last plot from a group deletes the group automatically.
Note: If a plot for sale is added to a group, its sale price is added to the group's total price, and the group becomes listed for sale if it wasn’t already.

Plot Group Management

Plot group management commands apply to all plots within the group you're standing in.

Selling

  • Set all plots in a group for sale: /plot group forsale (price)
  • Remove all plots in the group from sale: /plot group notforsale

Plot Types

  • Set plot type for the entire group: /plot group set (plot type)
  • Reset all plots in the group to default type: /plot group

Creating a Nation

A nation is a group of towns working together toward shared goals—whether cultural, political, or strategic. Towns within a nation can be closely knit or loosely affiliated communities unified by common interests.

To establish a nation, the following conditions must be met:

  • You must be the Mayor of a town.
  • Your town must have at least 5 residents.
  • The town bank must contain a minimum of 50,000⌾.

To create the nation, use: /n new [nation name]

Upon successful creation:

  • Your town becomes the capital of the new nation.
  • You are promoted to Nation Leader, granting full access to all nation management commands and settings.

Joining a Nation

For a town to join a nation, the town must be within 110 chunks (1760 blocks) of the nation capital homeblock and have atleast 3 residents already in the town.

For most nations towns will have to be invited this can be done by the nation leader, co-king, duke or assistant by using the command /n invite [town name], they can also kick towns from the nation by doing /n kick [town name].

The town mayor, co-mayor or deputy mayor then can use /accept [nation name] or /n invite -decline [nation name] or just letting it automatically expire.

Nation Board

The Nation Board is a custom message that represents your nation's identity, purpose, or announcements. It is visible to nation members when they log into the server and visitors when their do /n [nation name]. It helps communicate shared goals, cultural flair or important updates.

Setting the Nation Board

Nation leader, co-king and duke can create or update the board message by doing /n set board [message].

Nation Ranks

Nation ranks shape the structure of leadership within a nation, defining who commands, who governs, and who keeps the engine running behind the scenes.

Each rank is more than just a title, it comes with distinct responsibilities, specialized powers, and access to unique nation commands. Whether you're leading a kingdom, managing its economy, forging alliances, or honoring its citizens, these roles ensure the nation thrives as a coordinated whole.

Rank Role Description
King The supreme leader and founder of the nation. Holds full executive authority, including diplomatic, military, and financial control. Represents the nation’s identity and direction.
Co-King The King’s highest-ranking advisor. Shares most permissions but cannot delete the nation. Ideal for trusted governance partners.
Duke A senior statesman or regional administrator. May oversee multiple towns, assist with strategic decisions, and act as a liaison between the King and lower ranks.
Secretary of State The chief diplomat. Coordinates alliances, invites towns, and manages the nation’s external communications and negotiations.
Financier Manages the nation's economic resources. Has access to the nation bank and assists with budgeting, taxes, and financial planning.
General Head of the military. Responsible for coordinating nation defense, organizing wartime tactics, and overseeing allied relationships. Can manage alliances, and accept or propose nation-to-nation pacts.
Assistant A flexible support role. May help manage invitations, permissions, and light administrative duties, depending on what the King delegates.
Title Maker Responsible for assigning ceremonial titles and surnames to nation members. Useful for roleplay, recognition, and national culture.

Closed/Open Nations

Nations can control how towns are allowed to join them. By default, all nations are set to closed, meaning that towns may only join by invitation.

The Nation leader, co-kings, and dukes have the ability to change this setting at any time using the following commands:

  • /n toggle open — Allows any town to join the nation freely, without an invitation.
  • /n toggle closed — Towns may only join if they are invited.

Setting a nation to open can encourage rapid growth and attract new towns — but it may also bring in unexpected members. Consider your nation’s strategy before making the switch!

Nation Taxes

Nation Taxes

Nation taxes are an optional system used to transfer money from the town banks of towns in your nation to the nation bank at the start of each Towny day.

These taxes help fund national projects, pay upkeep costs, or build up reserves for war and expansion. However, using taxes is entirely optional, nations can choose to charge nothing at all.

Nation taxes can be set by players with the following ranks in the nation:

  • King
  • Co-King
  • Duke
  • Financier

To set the nation tax amount, use the command: /n set taxes [amount]

Keep in mind setting taxes too high might drive towns away, while setting them too low could leave your nation underfunded.