Command list
Doing any of these commands will show more info in game.
| Commands | Info |
|---|---|
| /towny | Helper command |
| /plot | Mainly for town residents |
| /resident | Used by all players to manage friend lists etc |
| /town | Get info about your town if you are in one. |
| /nation | Get info about your nationif you are in one. |
| /townyadmin | OP only |
| /townyworld | Info about the towny world. |
- This list breaks each command down by word. Eg: /resident set perm {on/off}.
- For resident commands, the add command would auto-match online players, while add+ requires exact spelling to choose offline players.
- Just about every subcommand has it’s own help menu. Use /resident set, or a similar cutoff, to show all the options for that command ingame. You can also use /resident set ?, you will probably need to use that in the case where a subcommand actually has a function by itself. Example: /town claim, and /town claim ? would show all it’s subcommands.
- The { } brackets are used to show variables, or what you need to fill in. The elipse “..” (or shortened elipse) is used to show that you can specify multiple things at once (like inviting 10 residents at once).
- The {bleh/blah/bluh} is used to show that the input can be multiple words.
- An empty bullet represents that the subcommand itself does something and will not show a help menu.
Towny commands
| Commands | Info |
|---|---|
| /towny | Shows basic towny commands. |
| /towny ? | Shows more towny commands. |
| /towny map – | Shows the towny map. |
| /towny prices – | Shows taxes/costs associated with running a town. |
| /towny time – | Shows time until next new-day (tax/upkeep collection.) |
| /towny top | |
| /towny residents {all/town/nation} | Shows top residents. |
| /towny land {all/resident/town} | Shows top land owners. |
| /towny spy | Admin command to spy on all chat channels |
| /towny tree | Shows lots of stuff. |
| /towny universe | Shows full towny stats, resident/town/nation/world counts as well as townblocks |
| /towny v | Shows towny version. |
| /towny war | |
| /towny war stats | |
| /towny war scores |
Plot commands
Used by town mayors to setup plots to sell/give to new residents so that they can build/destroy in there own plot within the town.
| Commands | Info |
|---|---|
| /plot | Shows the /plot commands. |
| /plot claim | Resident command to personally claims a plot that are for sale. |
| /plot claim auto | Resident command to personally claim an area of plots that are for sale, around the player typing the command. |
| /plot unclaim | Resident command to unclaim personally owned plots. |
| /plot unclaim circle/rect | Resident command to unclaim personally owned plots in a circle or rectangle shape. |
| /plot unclaim circle/rect {#radius around position} | Radius of the area to unclaim. |
| /plot {forsale/fs} | Set a plot for sale. |
| /plot {forsale/fs} circle/rect | Set a shape. |
| /plot {forsale/fs} circle/rect {# (radius around current position)} | Radius of the area to set forsale. |
| /plot {forsale/fs} $$ | Cost of plot. |
| /plot {forsale/fs} circle/rect | Set a shape. |
| /plot {forsale/fs} circle/rect {# (radius around current position)} | Radius of the area to set forsale. |
| /plot {notforsale/nfs} | Set a plot to not be for sale. |
| /plot {notforsale/nfs} circle/rect | Set a shape. |
| /plot {notforsale/nfs} circle/rect {# (radius around current position)} | Radius of the area to set notforsale. |
| /plot perm | Shows the perm line of the plot in which the player stands. |
| /plot set | Shows more info. |
| /plot set reset | Sets a shop/embassy/arena/wilds plot back to a normal plot. |
| /plot set shop | Sets a plot to a shop plot. |
| /plot set embassy | Sets a plot to an embassy plot. |
| /plot set arena | Sets a plot to an arena plot. |
| /plot set wilds | Sets a plot to a wilds plot. |
| /plot set perm ? | Shows list of all commands for this command. |
| /plot set perm {on/off} | Edits the perm line of the single plot in which the player is standing. See here for details. |
| /plot set perm {resident/ally/outsider} {on/off} | All town owners check /plot set perm outsider off so that outsiders cannot grief your town! A common mistake. |
| /plot set perm {build/destroy/switch/itemuse} {on/off} | |
| /plot set perm {resident/ally/outsider} {build/destroy/switch/itemuse} {on/off} | Resets the plot in which you stand to the default perm line of the /town or /resident screen (depending on if the plot is owned personally or by the town.) |
| /plot set perm reset | |
| /plot toggle | Shows in game list of all toggle commands… |
| /plot toggle fire | Turn on/off firespread in the plot in which you stand. |
| /plot toggle pvp | Turn on/off pvp in the plot in which you stand. |
| /plot toggle explosion | Turn on/off explosions in the plot in which you stand. |
| /plot toggle mob | Turn on/off hostile mobspawning in the plot in which you stand. |
| /plot clear | Command to remove list of block id’s from a plot, used by a mayor on town-owned land, or by a plot-owner on their personal plots. |
Resident commands
Can be used by all players on the server who are involved with a town.
/resident – Shows a player their resident screen.
/resident ? – Shows /res commands available.
/resident {playername} – Shows a player another player’s resident screen.
/resident friend
/resident friend add {playername} – Resident adds online player to their friends list.
/resident friend add+ {playername} – Resident adds offline player to their friends list.
/resident friend remove {playername} – Resident removes online player from their friends list.
/resident friend remove+ {playername} – Resident removes offline player from their friends list.
/resident friend clearlist – Removes all friends from a resident’s friend list.
/resident list – Lists residents in towny’s data folder.
/resident toggle
/resident toggle map – Turns on map which refreshes when moving across plot borders.
/resident toggle townclaim – Turns on mode where /town claim is automatically used when moving across plot borders.
/resident toggle plotborder – Turns on smokey plot-border view. Border shows when players cross to different townblocks.
/resident toggle spy – Admins can turn on chat-channel spying.
/resident toggle reset – This turns off all modes that are active.
/resident set
/resident set perm
/resident set perm {on/off} – Edits the perm line on the resident screen. See here for details.
/resident set perm {friend/ally/outsider} {on/off}
/resident set perm {build/destroy/switch/itemuse} {on/off}
/resident set perm {friend/ally/outsider} {build/destroy/switch/itemuse} {on/off}
/resident set perm reset – This takes the perm line seen in the /resident screen and applies it to all plots personally owned by the player typing it.
/resident tax – Shows taxes a player pays.
Town commands
Some commands are for all players like /town leave, and some will only work if you are a town mayor or equivalent status in the town.
/town – Shows a player their town’s town screen.
/town ? – Shows /town commands available.
/town {townname} – Shows a player another town’s town screen.
/town here – Shows you the town screen of the town in which you stand.
/town leave – Leaves a town.
/town list – Lists towns.
/town online – Shows players in your town which are online.
/town new
/town new {townname} – Creates new town.
/town new {townname} {mayor} – Admin command to create town.
/town add {resident} – Mayor command to add residents to your town.
/town kick {resident} – Mayor command to remove residents from your town.
/town spawn – Teleports you to your town’s spawn.
/town spawn {town} – Teleports you to another town’s spawn.
/town claim – Mayor command to claim the townblock in which you stand for your town.
/town claim outpost – Claims an outpost for your town.
/town claim {# (radius around current position)} – Claims an area of townblocks around you for your town.
/town claim auto – Claims as many townblocks around you as is possible given money in townbank and available townblocks.
/town unclaim – Mayor command to unclaim the townblock in which you stand.
/town unclaim all – Mayor command to unclaim all townblocks.
/town unclaim {# (radius around current position)} – Command to unclaim an area of townblocks around you.
/town withdraw {$} – Removes money from town bank.
/town deposit {$} – Adds money from player to the town bank.
/town buy
/town buy bonus {amount} – Buys available bonus townblocks.
/town delete {town name} – Admin/Mayor command to delete a town from towny’s data folder’s files.
/town outpost
/town outpost {# (where # equals the corresponding outpost’s number)} – Teleports to an outpost.
/town ranklist – Displays residents and their ranks.
/town rank {add|remove} {playername} {rankname} – Grants or removes a rank to a resident of the town.
/town set
/town set board {message} – Sets message seen by residents upon logging in.
/town set mayor {resident} – Mayor command to give mayor status to another resident.
/town set homeblock – Sets the homeblock of your town.
/town set spawn – Sets the town spawn, must be done inside the homeblock.
/town set name {name} – Change your town’s name.
/town set outpost – Sets a townblock as an outpost.
/town set perm
/town set perm {on/off} – Edits the perm line on the town screen. See here for details.
/town set perm {resident/ally/outsider} {on/off}
/town set perm {build/destroy/switch/itemuse} {on/off}
/town set perm {resident/ally/outsider} {build/destroy/switch/itemuse} {on/off}
/town set perm reset – This takes the perm line seen in the /town screen and applies it to all plots owned by the town.
/town set perm tag {upto4character} – Sets the town’s tag, which is sometimes used on that chat line.
/town set perm tag clear – Clears the tag set for the town.
/town set taxes {$} – Sets taxes collected from each resident daily. Also sets percentage if taxpercent is toggled on.
/town set plottax {$} – Set taxes collected from each resident daily, per plot that they own.
/town set plotprice {$} – Sets default cost of plot for the town.
/town set shopprice {$} – Sets default cost of a shopplot for the town.
/town set shoptax {$} – Set taxes collected from each resident daily, per shopplot that they own.
/town set embassyprice {$} – Sets default cost of a embassy plot for the town.
/town set embassytax {$} – Set taxes collected from each resident daily, per embassy plot that they own.
/town toggle – Shows ingame list of all toggles.
/town toggle explosion – Turn on/off explosions in town.
/town toggle fire – Turn on/off firespread in town.
/town toggle mobs – Turn on/off hostile mobspawning in town.v
/town toggle public – Turn on/off public /town spawning and the co-ordinates of the town’s homeblock in the /town screen.
/town toggle pvp – Turn on/off pvp in town.
/town toggle taxpercent – Turn on/off taxing by percent/flatrate.
/town toggle open – Turn on/off public joining to your town.
/town join {townname} – Command to join a town that doesn’t require invites.
Nation commands
/nation – Shows a player their nation’s nation screen.
/nation ? – Shows /nation commands.
/nation list – Lists nations.
/nation online – Shows players in your nation which are online.
/nation {nation} – Shows a player the /nation screen of another nation.
/nation leave – Mayor command to leave the nation they are a part of.
/nation withdraw {$} – King command to remove money from the nation bank.
/nation deposit {$} – King command to add money to the nation bank.
/nation new
/nation new {nationname} – Mayor command to create a nation.
/nation new {nationname} {capitaltown} – Admin command to create a new nation, set capitol.
/nation rank – Command to set assistant/custom ranks in the nation.
/nation add {town} – Invites/Adds a town to your nation.
/nation kick {town} – Removes a town from your nation.
/nation delete {nation} – Deletes your nation.
/nation ally
/nation ally add {nation} – Add a nation to your nation’s ally list.
/nation ally remove {nation} – Removes a nation from your nation’s ally list.
/nation enemy
/nation enemy add {nation} – Add a nation to your nation’s enemy list.
/nation enemy remove {nation} – Removes a nation from your nation’s enemy list.
/nation rank {add|remove} {playername} {rankname} – Grants or removes a rank to a resident of the nation.
/nation set
/nation set king {resident} – King command to change the king of the nation.
/nation set captial {town} – Sets the capitol and king of the nation.
/nation set taxes {$} – Sets nationtax applied to the towns within the nation.
/nation set name {name} – Sets the nation’s name.
/nation set title {name} {titlegoeshere} – King command to add a Title to a member of the nation.
/nation set surname {name} {surnamegoeshere} – King command to add a Suffix to a member of the nation.
/nation set tag {upto4character} – Sets the nation’s tag, which is sometimes used on that chat line.
/nation set tag clear – Clears the tag set for the nation.
/nation toggle
/nation toggle neutral – Sets whether your nation will pay daily to be neutral during towny war.
Townyadmin commands
/townyadmin – Shows Memory, Threads, War status, Health regen setting, Time, Whether daily-timer/taxes are on.
/townyadmin ? – Shows /ta commands.
/townyadmin delete {playername} – Deletes a player’s towny data.
/townyadmin town {town}
/townyadmin town add {resident} – Admin command to invite/add a resident to a town.
/townyadmin town remove {resident} – Admin command to remove a resident from a town.
/townyadmin town kick {resident} – Admin command to remove a resident from a town.
/townyadmin town rename {newname} – Admin command to rename a town.
/townyadmin town delete – Admin command to delete a town.
/townyadmin nation
/townyadmin nation {nationname} add {town} – Admin command to invite/add a town to a nation.
/townyadmin nation {nationname} rename {newname} – Admin command to rename a nation.
/townyadmin nation {nationname} delete – Admin command to delete a town.
/townyadmin reset – resets the plot you are standing in to the default generation, using your world’s seed and the current MC terrain generation.
/townyadmin toggle
/townyadmin toggle war – Turn on/off towny war.
/townyadmin toggle neutral – Turn on/off a nation’s ability to declare neutrality.
/townyadmin toggle npc {residentname} – Toggles a player’s resident file to isNPC=true, this exempts the player from taxes/upkeep.
/townyadmin toggle debug – Turns on/off debug mode.
/townyadmin toggle devmode – Turns on/off special devmode for when towny’s devs join your server to find a bug.
/townyadmin toggle withdraw – Turns on/off town/nation’s ability to withdraw money from their town/nation banks.
/townyadmin set
/townyadmin set mayor
/townyadmin set mayor {town} {resident} – Admin command to set a resident as mayor of a town.
/townyadmin set mayor{town} npc – Admin command to set a town to have an npc mayor.
/townyadmin givebonus {town} {#} – Gives extra townblocks to a town.
/townyadmin reload – Reloads towny’s config.yml.
/townyadmin backup – Creates a backup.
/townyadmin newday – Causes a new day to happen, this does not stop the next new day from happening when it was already scheduled.
/townyadmin unclaim
/townyadmin unclaim rect {radius} – Admin command to unclaim an area.
/townyadmin purge {# as in days} – Deletes old residents.
Townyworld commands
/townyworld – Shows world settings for the world in which you stand.
/townyworld ? – Shows /tw commands.
/townyworld list – Lists worlds.
/townyworld {world} – Show settings for world.
/townyworld toggle
/townyworld toggle claimable – Turn on/off whether mayors can claim townblocks in the world.
/townyworld toggle usingtowny – Turn on/off whether towny is used in the world.
/townyworld toggle pvp – Turn on/off pvp in the world.
/townyworld toggle forcepvp – Turn on/off whether pvp is forced on in all towns in the world.
/townyworld toggle explosion – Turn on/off whether explosions are on in the wilderness/towns in the world.
/townyworld toggle forceexplosion – Force explosions on in that world.
/townyworld toggle fire – Turn on/off whether firespread is on in the wilderness/towns in the world.
/townyworld toggle townmobs – Turn on/off hostile mobspawning in towns in the world.
/townyworld toggle worldmobs – Turn on/off the mobs listed in the world mobs in the world.
/townyworld toggle revertunclaim – Turn on/off the revert on unclaim feature for that world.
/townyworld toggle revertexpl – Turn on/off the reverting explosions in the wilderness feature for that world.
/townyworld set
/townyworld set wildname {name} – Sets name of the wilderness.
/townyworld regen – Regenerates the MC chunk in which back to the seed.
/townyworld undo – Undoes /tw regen.
Chat Commands
/townychat reload – Reloads chatconfig.yml and channels.yml
/townchat, /tc – Put in from of text to speak with members of your town only, or without text afterwards to enter the channel.
/nationchat, /nc – Put in from of text to speak with members of your nation only, or without text afterwards to enter the channel.
/global, /g – Put in from of text to speak in globalchat, or without text afterwards to enter the channel.
/res set mode reset – Reset chat mode to default chat.
/a – admin chat.
/m – moderator chat.
/channel leave|join {channel} – Channel leaving and joining.
/leave {channel} – Leaves a channel.
/join {channel} – Joins a channel.
/chmute {channel} {player} – Mutes a player in a channel.
/mutelist {channel} – Displays mute list for a channel.
/chunmute {channel} {player} – Unmutes a player in a channel.