Towny Commands
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.
/resident — Your Profile & Settings
Viewing Info
/residentShow your own resident profile — balance, town, plots owned, friends
/resident {player}Show another player's resident profile
/resident listList all residents on the server
/resident taxShow the taxes you currently pay
Friends
/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 clearlistRemove everyone from your friends list at once
Toggle Modes
/resident toggle mapTurn on a map overlay that refreshes as you cross plot borders
/resident toggle townclaimAuto-claim mode — automatically runs
/town claim as you walk across borders/resident toggle plotborderShow smoke particles at plot boundaries as you move across them
/resident toggle resetTurn off all active toggle modes at once
Personal Plot Permissions
/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 resetApply your resident permission line to all personally owned plots
/town — Managing Your Town
Viewing Info
/townShow your town's info screen — residents, plots, bank balance, upkeep
/town {townname}Show another town's info screen
/town hereShow the info screen for the town you are currently standing in
/town listList all towns on the server
/town onlineShow which members of your town are currently online
/town reslistShow a full list of all residents in your town
/town ranklistShow residents and their assigned ranks
Creating & Joining
/town new {townname}Found a new town at your current location
/town join {townname}Join a town that has open joining enabled
/town leaveLeave your current town (does not work if you are the mayor)
Managing Residents
/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
/town claimClaim 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 autoClaim as many chunks around you as your bank balance and townblock limit allows Mayor
/town claim outpostClaim the chunk you are on as an outpost (separate from your main town area) Mayor
/town unclaimUnclaim the chunk you are standing in Mayor
/town unclaim {radius}Unclaim a radius of chunks around you Mayor
/town unclaim allUnclaim all townblocks — leaves you with only the homeblock Mayor
/town buy bonus {amount}Purchase additional townblock slots beyond your town's resident-based limit
Teleportation
/town spawnTeleport 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)Town Bank
/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
Town Settings
/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 homeblockSet the homeblock (and spawn point) of your town at your current location Mayor
/town set spawnSet the town spawn point within the homeblock Mayor
/town set outpostMark 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
Town Permissions
/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 resetApply the town's permission line to every town-owned plot Mayor
Town Toggles
/town toggle openToggle whether players can join your town without an invite Mayor
/town toggle publicToggle whether your town's spawn is publicly accessible and coordinates are visible Mayor
/town toggle pvpToggle PvP on/off within your town Mayor
/town toggle explosionToggle explosions on/off in your town Mayor
/town toggle fireToggle fire spread on/off in your town Mayor
/town toggle mobsToggle hostile mob spawning on/off in your town Mayor
/town toggle taxpercentSwitch between flat-rate and percentage-based tax collection Mayor
/nation — Nations & Diplomacy
Viewing Info
/nationShow your nation's info screen — member towns, bank balance, king, allies
/nation {nationname}Show another nation's info screen
/nation listList all nations on the server
/nation onlineShow which members of your nation are currently online
Creating & Managing
/nation new {nationname}Found a new nation (you must be a mayor to use this)
/nation deleteDelete your nation King
/nation leaveLeave 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
Nation Bank
/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
Diplomacy
/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
Ranks & Titles
/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
Nation Settings
/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 Reference
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}.
Town Ranks
| 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
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.
/plot — Plot Management
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.
Claiming & Selling Plots
/plot claimPurchase and personally claim the plot you are standing on (must be for sale)
/plot claim autoAutomatically claim all for-sale plots in the area around you
/plot unclaimRelease 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 notforsaleRemove 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
Plot Types
/plot set resetReset a plot back to a normal (default) plot type
/plot set shopMark a plot as a shop plot (different tax/permissions)
/plot set embassyMark a plot as an embassy — can be purchased by players from other towns
/plot set arenaMark a plot as an arena — PvP is always enabled here regardless of town settings
/plot set wildsMark a plot as wilds — behaves like unclaimed wilderness within town borders
/plot set name {name}Give the plot a custom display name
Plot Permissions
/plot permShow 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 resetReset this plot's permissions to match its owner's default line
Plot Toggles
/plot toggle pvpToggle PvP on/off for this specific plot
/plot toggle fireToggle fire spread on/off for this plot
/plot toggle explosionToggle explosions on/off for this plot
/plot toggle mobToggle hostile mob spawning on/off for this plot
/towny — Server Info
/towny mapShow a text-based map of nearby town claims in chat
/towny pricesShow all costs and taxes associated with towns (claim costs, upkeep rates)
/towny timeShow the time remaining until the next new-day cycle (when upkeep is collected)
/towny top residents allShow towns ranked by resident count
/towny top land allShow towns ranked by land claimed
/towny top land townShow individual town land rankings
/towny universeShow total server stats — resident count, town count, nation count, total chunks claimed
Chat Channels
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.
/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 resetReturn to default global chat mode
/channel join {channel}Join a chat channel
/channel leave {channel}Leave a chat channel