Complete reference for every player-facing Towny command — /town, /nation, /resident, /plot, and chat. Use the search box below or jump to a section. Most subcommands have their own in-game help menu: try cutting a command short (e.g. /town set) to see all options.
In-Game Help
Every command supports ? as a subcommand — e.g. /town ?, /resident set ?. Use it whenever you're unsure what a command accepts. Also: add matches online players only; add+ works for offline players too.
No commands matched your search.
| Command |
Description |
/resident |
Show your own resident profile — balance, town, plots owned, friends |
/resident {player} |
Show another player's resident profile |
/resident list |
List all residents on the server |
/resident tax |
Show the taxes you currently pay |
| Command |
Description |
/resident friend add {player} .. {player} |
Add one or more online players to your friends list |
/resident friend add+ {player} .. {player} |
Add one or more offline players to your friends list (exact name required) |
/resident friend remove {player} .. {player} |
Remove online players from your friends list |
/resident friend remove+ {player} .. {player} |
Remove offline players from your friends list |
/resident friend clearlist |
Remove everyone from your friends list at once |
| Command |
Description |
/resident toggle map |
Turn on a map overlay that refreshes as you cross plot borders |
/resident toggle townclaim |
Auto-claim mode — automatically runs /town claim as you walk across borders |
/resident toggle plotborder |
Show smoke particles at plot boundaries as you move across them |
/resident toggle reset |
Turn off all active toggle modes at once |
| Command |
Description |
/resident set perm {on/off} |
Set all permissions on your personally owned plots (build/destroy/switch/itemuse for everyone) |
/resident set perm {friend/ally/outsider} {on/off} |
Set all permissions for a specific group on your plots |
/resident set perm {build/destroy/switch/itemuse} {on/off} |
Set a specific permission type for all groups on your plots |
/resident set perm {friend/ally/outsider} {build/destroy/switch/itemuse} {on/off} |
Set one specific permission for one specific group on your plots |
/resident set perm reset |
Apply your resident permission line to all personally owned plots |
| Command |
Description |
/town |
Show your town's info screen — residents, plots, bank balance, upkeep |
/town {townname} |
Show another town's info screen |
/town here |
Show the info screen for the town you are currently standing in |
/town list |
List all towns on the server |
/town online |
Show which members of your town are currently online |
/town reslist |
Show a full list of all residents in your town |
/town ranklist |
Show residents and their assigned ranks |
| Command |
Description |
/town new {townname} |
Found a new town at your current location |
/town join {townname} |
Join a town that has open joining enabled |
/town leave |
Leave your current town (does not work if you are the mayor) |
| Command |
Description |
/town add {player} .. {player} |
Invite one or more online players to your town (Mayor) |
/town kick {player} .. {player} |
Remove one or more residents from your town (Mayor) |
/town rank add {player} {rank} |
Grant a rank (e.g. Assistant, Builder) to a resident (Mayor) |
/town rank remove {player} {rank} |
Remove a rank from a resident (Mayor) |
/town set mayor {player} |
Transfer mayor status to another resident (Mayor) |
¶ Claiming & Unclaiming Land
| Command |
Description |
/town claim |
Claim the chunk you are standing in for your town (Mayor) |
/town claim {radius} |
Claim a square radius of chunks around you (e.g. /town claim 3 claims a 7×7 area) (Mayor) |
/town claim auto |
Claim as many chunks around you as your bank balance and townblock limit allows (Mayor) |
/town claim outpost |
Claim the chunk you are on as an outpost (separate from your main town area) (Mayor) |
/town unclaim |
Unclaim the chunk you are standing in (Mayor) |
/town unclaim {radius} |
Unclaim a radius of chunks around you (Mayor) |
/town unclaim all |
Unclaim all townblocks — leaves you with only the homeblock (Mayor) |
/town buy bonus {amount} |
Purchase additional townblock slots beyond your town's resident-based limit |
| Command |
Description |
/town spawn |
Teleport to your own town's spawn point |
/town spawn {townname} |
Teleport to another town's spawn (only if they have public spawning enabled; may cost money) |
/town outpost {#} |
Teleport to one of your town's outposts by number (e.g. /town outpost 1) |
| Command |
Description |
/town deposit {$amount} |
Deposit money from your personal balance into the town bank |
/town withdraw {$amount} |
Withdraw money from the town bank to your personal balance (Mayor) |
/town tribute {$amount} |
Send money from your town bank to your nation's bank |
| Command |
Description |
/town set board {message} |
Set the message residents see when they log in (Mayor) |
/town set name {name} |
Rename your town (Mayor) |
/town set tag {1-4 chars} |
Set a short tag used in chat prefixes (Mayor) |
/town set homeblock |
Set the homeblock (and spawn point) of your town at your current location (Mayor) |
/town set spawn |
Set the town spawn point within the homeblock (Mayor) |
/town set outpost |
Mark the current townblock as an outpost (Mayor) |
/town set taxes {$amount} |
Set the daily flat-rate tax collected from each resident (Mayor) |
/town set plottax {$amount} |
Set the daily tax per personally-owned plot (Mayor) |
/town set plotprice {$amount} |
Set the default purchase price of a town plot (Mayor) |
| Command |
Description |
/town set perm {on/off} |
Set all build/destroy/switch/itemuse permissions for all groups on town-owned plots (Mayor) |
/town set perm {resident/ally/outsider} {on/off} |
Set all permissions for one group (Mayor) |
/town set perm {build/destroy/switch/itemuse} {on/off} |
Set one permission type for all groups (Mayor) |
/town set perm {resident/ally/outsider} {build/destroy/switch/itemuse} {on/off} |
Set one specific permission for one specific group (Mayor) |
/town set perm reset |
Apply the town's permission line to every town-owned plot (Mayor) |
| Command |
Description |
/town toggle open |
Toggle whether players can join your town without an invite (Mayor) |
/town toggle public |
Toggle whether your town's spawn is publicly accessible and coordinates are visible (Mayor) |
/town toggle pvp |
Toggle PvP on/off within your town (Mayor) |
/town toggle explosion |
Toggle explosions on/off in your town (Mayor) |
/town toggle fire |
Toggle fire spread on/off in your town (Mayor) |
/town toggle mobs |
Toggle hostile mob spawning on/off in your town (Mayor) |
/town toggle taxpercent |
Switch between flat-rate and percentage-based tax collection (Mayor) |
| Command |
Description |
/nation |
Show your nation's info screen — member towns, bank balance, king, allies |
/nation {nationname} |
Show another nation's info screen |
/nation list |
List all nations on the server |
/nation online |
Show which members of your nation are currently online |
| Command |
Description |
/nation new {nationname} |
Found a new nation (you must be a mayor to use this) |
/nation delete |
Delete your nation (King) |
/nation leave |
Leave the nation (mayor command — removes your town from the nation) |
/nation add {town} .. {town} |
Invite one or more towns to your nation (King) |
/nation kick {town} .. {town} |
Remove one or more towns from your nation (King) |
| Command |
Description |
/nation deposit {$amount} |
Deposit money from your personal balance into the national bank (King) |
/nation withdraw {$amount} |
Withdraw money from the national bank (King) |
/nation grant {townname} {$amount} |
Send money from the national bank to a member town (King) |
| Command |
Description |
/nation ally add {nation} .. {nation} |
Add one or more nations to your ally list (King) |
/nation ally remove {nation} .. {nation} |
Remove nations from your ally list (King) |
/nation enemy add {nation} .. {nation} |
Declare another nation an enemy (King) |
/nation enemy remove {nation} .. {nation} |
Remove nations from your enemy list (King) |
| Command |
Description |
/nation rank add {player} {rank} |
Grant a nation rank to a player (King) |
/nation rank remove {player} {rank} |
Remove a nation rank from a player (King) |
/nation set title {player} {title} |
Add a custom title prefix to a member (e.g. "Field Marshal") (King) |
/nation set surname {player} {surname} |
Add a custom surname suffix to a member (King) |
/nation set king {player} |
Transfer the nation's kingship to another resident (King) |
| Command |
Description |
/nation set name {name} |
Rename your nation (King) |
/nation set tag {1-4 chars} |
Set a short tag used in chat (King) |
/nation set taxes {$amount} |
Set the daily nation tax applied to all member towns (King) |
/nation set capital {townname} |
Move the nation's capital to a different member town (King) |
Ranks grant residents additional permissions beyond what their role (resident/mayor/king) provides by default. Town ranks are assigned with /town rank add {player} {rank}; nation ranks with /nation rank add {player} {rank}.
| Rank |
What They Can Do |
Assigned By |
| assistant |
Claim/unclaim land, invite players, toggle town public, manage all plots, participate in sieges |
Mayor |
| militia |
Participate in sieges, earn siege pay |
Mayor / Assistant |
| private |
Participate in sieges, earn siege pay |
Mayor / Assistant |
| guard |
Score siege battle points for the town's defense |
Mayor / Assistant |
Nation ranks are a military hierarchy. Higher ranks can start sieges, lead invasions, and manage lower-ranked soldiers. All ranks below Major earn the same basic siege pay — Major and above earn significantly more.
| Rank |
Siege Capabilities |
Can Assign |
| militia |
Participate in sieges, earn pay |
— |
| private |
Participate, score battle points, earn pay |
— |
| sergeant |
Participate, score battle points, earn pay |
— |
| lieutenant |
Participate, score battle points, earn pay |
— |
| captain |
Participate, score battle points, earn pay |
— |
| colonel |
Participate, score battle points, earn pay |
— |
| major |
Attack & start conquest sieges, battle points, earn 10× pay |
— |
| general |
Full siege control — attack, invade, plunder, start sieges, pay soldiers, earn pay |
Private → Colonel |
| king |
All siege actions, full nation control |
All ranks |
Nomad vs Resident
Players without a town (Nomads) have limited Towny access — they can view town/nation info and use basic /towny commands, but cannot claim land, use /town spawn, or participate in sieges. Joining or founding a town unlocks everything.
Plots vs. Townblocks
A townblock is a 16×256×16 area claimed by your town. A plot is a townblock that has been personally assigned to a resident (either sold or given). Town-owned plots follow town permissions; personal plots follow the owning resident's permissions.
| Command |
Description |
/plot claim |
Purchase and personally claim the plot you are standing on (must be for sale) |
/plot claim auto |
Automatically claim all for-sale plots in the area around you |
/plot unclaim |
Release personal ownership of the plot you are on — returns it to the town |
/plot forsale {$price} |
Put the plot you stand on up for sale at the given price |
/plot forsale circle/rect {radius} {$price} |
Put a circular or rectangular area of plots up for sale |
/plot notforsale |
Remove the for-sale listing from the plot you stand on |
/plot notforsale circle/rect {radius} |
Remove for-sale listing from a circular or rectangular area |
| Command |
Description |
/plot set reset |
Reset a plot back to a normal (default) plot type |
/plot set shop |
Mark a plot as a shop plot (different tax/permissions) |
/plot set embassy |
Mark a plot as an embassy — can be purchased by players from other towns |
/plot set arena |
Mark a plot as an arena — PvP is always enabled here regardless of town settings |
/plot set wilds |
Mark a plot as wilds — behaves like unclaimed wilderness within town borders |
/plot set name {name} |
Give the plot a custom display name |
| Command |
Description |
/plot perm |
Show the current permission line of the plot you are standing on |
/plot set perm {on/off} |
Set all permissions on this single plot |
/plot set perm {resident/ally/outsider} {on/off} |
Set all permissions for one group on this plot |
/plot set perm {build/destroy/switch/itemuse} {on/off} |
Set one permission type for all groups on this plot |
/plot set perm {resident/ally/outsider} {build/destroy/switch/itemuse} {on/off} |
Set one specific permission for one specific group on this plot |
/plot set perm reset |
Reset this plot's permissions to match its owner's default line |
| Command |
Description |
/plot toggle pvp |
Toggle PvP on/off for this specific plot |
/plot toggle fire |
Toggle fire spread on/off for this plot |
/plot toggle explosion |
Toggle explosions on/off for this plot |
/plot toggle mob |
Toggle hostile mob spawning on/off for this plot |
| Command |
Description |
/towny map |
Show a text-based map of nearby town claims in chat |
/towny prices |
Show all costs and taxes associated with towns (claim costs, upkeep rates) |
/towny time |
Show the time remaining until the next new-day cycle (when upkeep is collected) |
/towny top residents all |
Show towns ranked by resident count |
/towny top land all |
Show towns ranked by land claimed |
/towny top land town |
Show individual town land rankings |
/towny universe |
Show total server stats — resident count, town count, nation count, total chunks claimed |
Entering vs. Prefixing
You can use these channels in two ways: type the command followed by your message to send a single message, or type the command alone to enter the channel — after which everything you type goes there until you switch back with /g or /res set mode reset.
| Command |
Description |
/tc {message} |
Send a message to your town only (/townchat also works) |
/nc {message} |
Send a message to your nation only (/nationchat also works) |
/g {message} |
Send a message in global chat (/global also works) |
/resident set mode reset |
Return to default global chat mode |
/channel join {channel} |
Join a chat channel |
/channel leave {channel} |
Leave a chat channel |