📃
Towny Commands
All the commands you will need for your town
All these commands can be viewed in an easier format to explore in game with /towny menu.
- /towny
-
- Shows basic towny commands.
- ? - Shows more towny commands.
- allowedblocks - Opens a menu where you can check what blocks might be allowed to be built/destroyed in
- itemuse - Shows the items in the item_use_ids list.
- map - Shows the towny map.
- hud - Activates the map in the player's scoreboard.
- plotclearblocks - Shows the blocks deleted using
/plot clear
- prices - Shows taxes/costs associated with running a town.
- switches - Shows the blocks in the switch_ids list.
- time - Shows time until next new-day (tax/upkeep collection.)
- top
- residents {all/town/nation} - Shows top residents.
- land {all/resident/town} - Shows top land owners.
- spy - Admin command to spy on all chat channels
- tree - Shows lots of stuff.
- universe - Shows full towny stats, resident/town/nation/world counts as well as townblocks claimed.
- v - Shows towny version.
- wildsblocks - Shows the blocks that are usable in wilds plots, and which are allowed to be farmed in the wilderness.
- /plot
-
- Shows the /plot commands.
- claim - Resident command to personally claims a plot that are for sale.
- auto - Resident command to personally claim an area of plots that are for sale, around the player typing the command.
- unclaim - Resident command to unclaim personally owned plots.
- circle/rect - Resident command to unclaim personally owned plots in a circle or rectangle shape.
- {# (radius around current position)} - Radius of the area to unclaim.
- {forsale/fs} - Set a plot for sale.
- circle/rect - Set a shape.
- {# (radius around current position)} - Radius of the area to set forsale.
- $$ - Cost of plot.
- circle/rect - Set a shape.
- {# (radius around current position)} - Radius of the area to set forsale.
- {notforsale/nfs} - Set a plot to not be for sale.
- circle/rect - Set a shape.
- {# (radius around current position)} - Radius of the area to set notforsale.
- evict - Used to remove a plot from a plot owner, usually by the mayor or assistant.
- trust
- add {name} - Adds a player as Trusted on the plot.
- remove {name} - Removes a player from being Trusted on the plot.
- perm - Shows the perm line of the plot in which the player stands.
- gui - opens the GUI to configure the plot perm override.
- add {name} - Adds a player to the plot perm override.
- remove {name} - Removes a player from the plot perm override.
- perm hud - Toggles on/off the plot perm hud scoreboard which shows the perm line of the plot in which the player stands along with more useful plot info.
- set
- reset - Sets a shop/embassy/arena/wilds plot back to a normal plot.
- shop - Sets a plot to a shop plot.
- embassy - Sets a plot to an embassy plot.
- arena - Sets a plot to an arena plot.
- wilds - Sets a plot to a wilds plot.
- inn - Set a plot to an inn plot.
- jail - Set a plot to an jail plot.
- farm - Set a plot to a farm plot.
- bank - Set a plot to a bank plot.
- outpost - Set a plot to an outpost plot, costs the same as /t claim outpost.
- name - allows a mayor or plot-owner to rename plots they own, overwriting the ~Unowned message. Personal-plots display both the plot's given name and the name of the plot-owner.
- perm
- {on/off} - Edits the perm line of the single plot in which the player is standing. See here for details.
- {resident/ally/outsider} {on/off}
- {build/destroy/switch/itemuse} {on/off}
- {resident/ally/outsider} {build/destroy/switch/itemuse} {on/off}
- reset - 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.)
- toggle
- fire - Turn on/off firespread in the plot in which you stand.
- pvp - Turn on/off pvp in the plot in which you stand.
- explosion - Turn on/off explosions in the plot in which you stand.
- mob - Turn on/off hostile mobspawning in the plot in which you stand.
- 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.
- group
- add|new|create {groupname} - Creates a plot group where a player is standing, also adds plots to an existing group.
- remove - Removes the plot stood in from its plot group.
- delete - Deletes a plot group entirely.
- rename {newname} - Renames a plot group.
- set {plottype} - Sets the group to a specified plot type. Not able to be used for Jail plots.
- set perm ... - Used to set the perm line of the group you are standing in. See above section for /plot set perm for remainder of commands.
- toggle ... - Used to toggle plot settings. See above section for /plot set toggle for remainder of commands.
- forsale|fs {price} - Set the group for sale at the set price.
- notforsale|nfs - Set the group not for sale.
- trust
- add {name} - Adds a player as Trusted on the plot group.
- remove {name} - Removes a player from being Trusted on the plot group.
- perm
- gui - Opens the GUI to edit the plot perm override.
- add {name} - Adds a player to the plot perm override.
- remove {name} - Removes a player from the plot perm override.
- jailcell
- add - Adds a jail cell to a jail plot, where the player is stood.
- remove - Removes a jail cell from a jail plot, where the player is stood.
- /resident
-
- Shows a player their resident screen.
- ? - Shows /res commands available.
- {resident} - Shows a player another player's resident screen.
- friend
- add {resident} .. {resident} - Resident adds online player to their friends list.
- add+ {resident} .. {resident} - Resident adds offline player to their friends list.
- remove {resident} .. {resident} - Resident removes online player from their friends list.
- remove+ {resident} .. {resident} - Resident removes offline player from their friends list.
- clearlist - Removes all friends from a resident's friend list.
- list - Returns a list of your friends.
- list - Lists residents in towny's data folder who are online.
- jail paybail - Allows a player to pay to get out of jail. Funds go to the town which owns the Jail.
- spawn - If deny_bed_use: true and player has a current bed spawn, command will teleport player to their bed.
- toggle
- map - Turns on map which refreshes when moving across plot borders.
- townclaim - Turns on mode where /town claim is automatically used when moving across plot borders.
- plotborder - Turns on smokey plot-border view. Border shows when players cross to different townblocks.
- constantplotborder - Turns on smokey plot-border view. Border doesn't disappear.
- bordertitles - Turns on/off the Title messages seen when entering/leaving town, when using_titles is true in the config.
- spy - Admins can turn on chat-channel spying.
- ignoreplots - Turns on/off plot notifications in town.
- reset - This turns off all modes that are active.
- infotool - Allows an admin to use the clay brick tool to determine the Bukkit names/classes of blocks and entities.
- adminbypass - Used to make admins play as non-admins.
- set
- perm
- {friend/ally/outsider} {on/off}
- {build/destroy/switch/itemuse} {on/off}
- {friend/ally/outsider} {build/destroy/switch/itemuse} {on/off}
- reset - This takes the perm line seen in the /resident screen and applies it to all plots personally owned by the player typing it.
- tax {resname} - Shows taxes a player pays.
- /town
-
- Shows a player their town's town screen.
- ? - Shows /town commands available.
- {town} - Shows a player another town's town screen.
- here - Shows you the town screen of the town in which you stand.
- leave - Leaves a town.
- list
- by name {page #} - order alpabetically.
- by resident {page #} - order by town with most residents.
- by balance {page #} - order by town with the highest nation bank balance.
- by townblocks {page #} - order towns by how many townblocks they have claimed.
- by online {page #} - order by how many players are online at that moment.
- by open {page #} - lists open towns first, in order of most residents to least residents.
- by public {page #} - lists public towns first, in order of most residents to least residents.
- by ruined {page #} - lists ruined towns first, in order of most residents to least residents.
- by bankrupt {page #} - lists bankrupt towns first, in order of most residents to least residents.
- by founded {page #} - order by founded date, oldest first.
- online - Shows players in your town which are online.
- plots {townname} - Shows a helpful list of plots and their types/revenue which are owned by the town.
- new {townname} - Creates a new town.
- add {resident} .. {resident} - Mayor command to add residents to your town.
- kick {resident} .. {resident} - Mayor command to remove residents from your town.
- invite - Show a list of players who've been sent invites to your town.
- sent - Show a list of players who've been sent invites to your town.
- received - Show a list of invites your town has received from nations.
- accept {nationname} - Accept an invite to join a nation.
- deny {nationname} - Deny an invite to join a nation.
- {playername} - Send an invite to a player to join your town.
- spawn - Teleports you to your town's spawn.
- spawn {town} - Teleports you to another town's spawn.
- claim - Mayor command to claim the townblock in which you stand for your town.
- outpost <#|{name}|{name:#} - Claims an outpost for your town. {name} uses the plot name. {name:#} is used when a plot name begins with a number.
- {# (radius around current position)} - Claims an area of townblocks around you for your town.
- auto - Claims as many townblocks around you as is possible given money in townbank and available townblocks.
- unclaim - Mayor command to unclaim the townblock in which you stand.
- all - Mayor command to unclaim all townblocks.
- {# (radius around current position)} - Command to unclaim an area of townblocks around you.
- outpost - Used to unclaim glitched outposts on MySQL Towny servers pre-0.92.0.0
- withdraw
- {$} - Removes money from town bank.
- all - Withdraws all of the money from the town bank.
- deposit
- {$} - Adds money from player to the town bank.
- all - Deposits all of your money into the town bank.
- {$} {townname} - Deposits money from player into the specified town's bank.
- baltop {townname} - Opens a book displaying the richest players in a town.
- bankhistory {#} - Opens a book GUI with # number of transactions listed, showing the town bank history.
- buy
- bonus {amount} - Buys available bonus townblocks.
- allylist {townname} - Displays a list of allies for the Town.
- enemylist {townname} - Displays a list of enemies for the Town.
- delete {town name} - Admin/Mayor command to delete a town from towny's data folder's files.
- merge {town name} - {town name} is the town which will be merged into the town owned by the mayor using the command.
- outlawlist {town} - Displays a list of outlaws for a town.
- outlaw {add/remove} {name} - Adds or removes an outlaw from a town's outlaw list
- outpost
- {# (where # equals the corresponding outpost's number)} - Teleports to an outpost.
- {list} - lists your town's outposts.
- plotgrouplist {townname} {page #} - Lists a town's plotgroups with forsale and price indicated.
- purge {days} - Kicks residents from the town who have been inactive for the given number of days, exempts npcs and mayors.
- ranklist {townname} - Displays residents and their ranks, optional townname to view another town's rank list.
- rank {add|remove} {playername} {rankname} - Grants or removes a rank to a resident of the town.
- reclaim - allows a resident to reclaim their ruined town.
- reslist {townname} - See a FULL list of all residents in a town.
- say {msg} - Broadcast a message to online town members.
- set
- board
- {message} - Sets message seen by residents upon logging in.
- none - Sets an empty board which will not be seen on login or in the /town status screen.
- mayor {resident} - Mayor command to give mayor status to another resident.
- homeblock - Sets the homeblock and spawn of your town.
- spawn - Sets the town spawn, must be done inside the homeblock.
- spawncost - Set the cost of spawning to a public town. Doesn't affect town residents, nation members and nation-allies.
- mapcolor {color} - Sets a town's mapcolor seen in the dynmap.
- name {name} - Change your town's name.
- outpost - Resets the outpost's spawn point to the player location. Must be used in an existing outpost plot.
- perm
- {resident/ally/outsider} {on/off}
- {build/destroy/switch/itemuse} {on/off}
- {resident/ally/outsider} {build/destroy/switch/itemuse} {on/off}
- reset - This takes the perm line seen in the /town screen and applies it to all plots owned by the town.
- tag {upto4character} - Sets the town's tag, which is sometimes used on that chat line.
- clear - Clears the tag set for the town.
- taxes {$} - Sets taxes collected from each resident daily. Also sets percentage if taxpercent is toggled on.
- taxpercentcap {$} - The maximum amount that can be taken when taxpercent is enabled.
- plottax {$} - Set taxes collected from each resident daily, per plot that they own.
- plotprice {$} - Sets default cost of plot for the town.
- shopprice {$} - Sets default cost of a shopplot for the town.
- shoptax {$} - Set taxes collected from each resident daily, per shopplot that they own.
- embassyprice {$} - Sets default cost of a embassy plot for the town.
- embassytax {$} - Set taxes collected from each resident daily, per embassy plot that they own.
- title {name} {titlegoeshere} - Mayor command to add a Title to a member of the town.
- surname {name} {surnamegoeshere} - Mayor command to add a Suffix to a member of the town.
- primaryjail - Sets your town's primary jail.
- toggle
- explosion - Turn on/off explosions in town.
- fire - Turn on/off firespread in town.
- mobs - Turn on/off hostile mobspawning in town.
- public - Turn on/off public /town spawning and the co-ordinates of the town's homeblock in the /town screen.
- pvp - Turn on/off pvp in town.
- taxpercent - Turn on/off taxing by percent/flatrate.
- nationzone - Turn on/off the town's NationZone.
- open - Turn on/off public joining to your town.
- join {townname} - Command to join a town that doesn't require invites.
- jail
- list - Shows jail number, name, coord, cellcount and which jail is the primary jail.
- {name} - Jails the given player for 1 hour, must be a resident of your own town.
- {name} {hours} - Jails the given player for the given hours.
- {name} {hours} {jail} - Jails the given player for the given hours, in the given jail plot (which is a number.)
- {name} {hours} {jail} {cell} - Jails the given player for the given hours, in the given jail plot and jail cell (which are both numbers.)
- unjail {name} - Unjails someone in your town's jail.
- trust
- add {name} - Adds a player as Trusted to the entire town.
- remove {name} - Removes a player from being Trusted by the entire town.
- list - Displays a list of trusted players for the town.
- trusttown
- add [townname] - Adds an entire town as trusted in your town.
- remove [townname] - Removes an entire town as trusted in your town.
- list - Displays a list of trusted towns in your town.
- /nation
-
- Shows a player their nation's nation screen.
- ? - Shows /nation commands.
- list
- by name {page #} - order alpabetically.
- by resident {page #} - order by nation with most residents across all towns.
- by balance {page #} - order by nation with the highest nation bank balance.
- by towns {page #} - order by nation with the most towns.
- by townblocks {page #} - order nations by how many townblocks their towns have collectively claimed.
- by online {page #} - order by how many players are online at that moment.
- by open {page #} - ordered by open first, number of residents second.
- by public {page #} - order by public first, number of residents second.
- by founded {page #} - order by founded date, oldest first.
- online - Shows players in your nation which are online.
- {nation} - Shows a player the /nation screen of another nation.
- leave - Mayor command to leave the nation they are a part of.
- withdraw
- {$} - King command to remove money from the nation bank.
- all - Withdraws all of the money from the nation bank.
- deposit
- {$} - Command to add money to the nation bank.
- all - Deposits all of your money into the nation bank.
- baltop {nationname} - Opens a book displaying the richest players in a nation.
- bankhistory {#} - Opens a book GUI with # number of transactions listed, showing the nation bank history.
- deposit {$} {townname} - King command to add money to the bank of a town who is in the nation.
- new
- {nationname} - Mayor command to create a nation.
- rank - Command to set assistant/custom ranks in the nation.
- add {town} .. {town} - Invites/Adds a town to your nation.
- kick {town} .. {town} - Removes a town from your nation.
- delete {nation} - Deletes your nation.
- invite - Show a list of invites sent.
- help - Show a list of invites sent.
- sent - Show a list of invites sent.
- {town} - Invites a town to a nation.
- ally - Show a list of nation alliance invites sent.
- add {nation} .. {nation} - Add a nation to your nation's ally list.
- remove {nation} .. {nation} - Removes a nation from your nation's ally list.
- accept {nationname} - Accepts an invitation to ally from another nation.
- deny {nationname} - Denies an invitation to ally from another nation.
- sent - Show a list of nation alliance invites sent.
- received - Show a list of nation alliance invites received.
- enemy
- add {nation} .. {nation} - Add a nation to your nation's enemy list.
- remove {nation} .. {nation} - Removes a nation from your nation's enemy list.
- rank {add|remove} {playername} {rankname} - Grants or removes a rank to a resident of the nation.
- say {msg} - Broadcast a message to online nation members.
- set
- king {resident} - King command to change the king of the nation.
- capital {town} - Sets the capitol and king of the nation.
- board
- {message} - Sets message seen by residents upon logging in.
- none - Sets an empty board which will not be seen on login or in the /nation status screen.
- taxes {$} - Sets nationtax applied to the towns within the nation.
- taxpercentcap - Sets the maximum amount that a town will pay in nationtax, when the nation has percent-based taxation.
- name {name} - Sets the nation's name.
- spawn - Sets the nation spawn point.
- spawncost - Sets the cost of public spawns to that nation's spawn point. No effect on members of the nation or nation-allies
- title {name} {titlegoeshere} - King command to add a Title to a member of the nation.
- surname {name} {surnamegoeshere} - King command to add a Suffix to a member of the nation.
- tag {upto4character} - Sets the nation's tag, which is sometimes used on that chat line.
- clear - Clears the tag set for the nation.
- mapcolor {color} - Sets the colour seen on the dynmap-towny webpage.
- toggle
- neutral - Sets whether your nation will pay daily to be neutral during towny war.
- open - Sets the nation to be open, so that any town can join without an invite.
- taxpercent - Turns on and off the percentage-based taxation of towns in the nation.
- join {nation}
- Used by a town mayor to join an open nation.
- merge {nationname}
- Requests the given nation to merge into your nation.
- Can only be used by the nation king, and requires the king of the other nation to be online to accept the merger.
- The soon-to-be-ex-king will receive a confirmation message asking if they will accept the dissolution of their nation.
- If accepted the towns of the nation transfer to the remaining nation. The nation's bank money is also transferred.
- ranklist {nationname} - Displays residents and their ranks, optional nationname to view another nation's rank list.
- townlist (nation)
- (nation) is optional, to show townlist of a nation you aren't a part of.
- lists all towns in a nation.
- allylist (nation)
- (nation) is optional, to show allylist of a nation you aren't a part of.
- lists all allies of a nation.
- enemylist (nation)
- (nation) is optional, to show enemylist of a nation you aren't a part of.
- lists all enemies of a nation.
Last modified 4mo ago