All Towny commands
This pages lists all Towny plugin commands.
Notation
?orhelpappended to a command path shows its in-game help.{a/b}: choose one option.{value}: required value.[value]: optional value.$$: money amount.#: numeric amount (radius, count, index, etc.).
/towny
| Command | Description |
|---|---|
/towny | Shows basic towny commands. |
/towny ? | Shows more towny commands. |
/towny allowedblocks | Opens a menu where you can check what blocks might be allowed to be built/destroyed in |
/towny itemuse | Shows the items in the item_use_ids list. |
/towny map | Shows the towny map. |
/towny map hud | Activates the map in the player's scoreboard. |
/towny plotclearblocks | Shows the blocks deleted using /plot clear |
/towny prices | Shows taxes/costs associated with running a town. |
/towny switches | Shows the blocks in the switch_ids list. |
/towny time | Shows time until next new-day (tax/upkeep collection.) |
/towny top residents {all/town/nation} | Shows top residents. |
/towny top land {all/resident/town} | Shows top land owners. |
/towny spy | 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 claimed. |
/towny v | Shows towny version. |
/towny wildsblocks | Shows the blocks that are usable in wilds plots, and which are allowed to be farmed in the wilderness. |
/resident
| Command | Description |
|---|---|
/resident | Shows a player their resident screen. |
/resident ? | Shows /res commands available. |
/resident {resident} | Shows a player another player's resident screen. |
/resident friend add {resident} .. {resident} | Resident adds online player to their friends list. |
/resident friend add+ {resident} .. {resident} | Resident adds offline player to their friends list. |
/resident friend remove {resident} .. {resident} | Resident removes online player from their friends list. |
/resident friend remove+ {resident} .. {resident} | Resident removes offline player from their friends list. |
/resident friend clearlist | Removes all friends from a resident's friend list. |
/resident friend list | Returns a list of your friends. |
/resident friend list online | Returns a list of your friends which are currently online. |
/resident list | Lists residents in towny's data folder who are online. |
/resident jail paybail | Allows a player to pay to get out of jail. Funds go to the town which owns the Jail. |
/resident outlawlist {playername} | Display the list of towns in which a resident is outlawed in. Leave out the optional player name to see the towns in which you are an outlaw. |
/resident plotlist {#} | Shows a player their own list of plots, with an optional page number. |
/resident plotlist [name] {#} | Shows a list of plots for the given player name, with an optional page number. |
/resident spawn | If deny_bed_use: true and player has a current bed spawn, command will teleport player to their bed. |
/resident toggle pvp | Changes a resident's personally owned plots' PVP status. |
/resident toggle fire | Changes a resident's personally owned plots' fire status. |
/resident toggle mobs | Changes a resident's personally owned plots' mobs status. |
/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 townunclaim | Turns on mode where /town unclaim is automatically used when moving across plot borders. |
/resident toggle bedspawn | Turns on the mode where you will prefer your bed spawn over your town spawn. |
/resident toggle plotborder | Turns on smokey plot-border view. Border shows when players cross to different townblocks. |
/resident toggle constantplotborder | Turns on smokey plot-border view. Border doesn't disappear. |
/resident toggle townborder | Turns on smokey plot-border view of the town you are stood in. Border doesn't disappear. |
/resident toggle bordertitles | Turns on/off the Title messages seen when entering/leaving town, when using_titles is true in the config. |
/resident toggle plotgroup | Turns on a mode that will automatically add plots you enter into, into the plot group you are constructing. |
/resident toggle district | Turns on a mode that will automatically add plots you enter into, into the district you are constructing. |
/resident toggle spy | Admins can turn on chat-channel spying. |
/resident toggle ignoreinvites | Turns on/off receiving invites to towns. |
/resident toggle ignoreplots | Turns on/off plot notifications in town. |
/resident toggle reset | This turns off all modes that are active. |
/resident toggle infotool | Allows an admin to use the clay brick tool to determine the Bukkit names/classes of blocks and entities. |
/resident toggle adminbypass | Make admins play as non-admins. |
/resident set perm {on/off} | Edits the perm line on the resident screen. See here for details. |
/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 set about {message] | Sets a bio/about message shown in the /res status screen. |
/resident set about {clear} | Removes all of your modes. |
/resident set about {reset} | Removes all of your modes and re-assigns your default modes. |
/resident tax {resname} | Shows taxes a player pays. |
/town
| Command | Description |
|---|---|
/town | Shows a player their town's town screen. |
/town ? | Shows /town commands available. |
/town {town} | 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 by name {page #} | Order alpabetically. |
/town list by resident {page #} | Order by town with most residents. |
/town list by balance {page #} | Order by town with the highest nation bank balance. |
/town list by townblocks {page #} | Order towns by how many townblocks they have claimed. |
/town list by forsale {page #} | Order towns based on whether they are for sale, by price. |
/town list by online {page #} | Order by how many players are online at that moment. |
/town list by open {page #} | Lists open towns first, in order of most residents to least residents. |
/town list by public {page #} | Lists public towns first, in order of most residents to least residents. |
/town list by ruined {page #} | Lists ruined towns first, in order of most residents to least residents. |
/town list by bankrupt {page #} | Lists bankrupt towns first, in order of most residents to least residents. |
/town list by founded {page #} | Order by founded date, oldest first. |
/town online | Shows players in your town which are online. |
/town plots {townname} | Shows a helpful list of plots and their types/revenue which are owned by the town. |
/town new {townname} | Creates a new town. |
/town add {resident} .. {resident} | Add residents to your town. |
/town kick {resident} .. {resident} | Remove residents from your town. |
/town invite | Show a list of players who've been sent invites to your town. |
/town invite sent | Show a list of players who've been sent invites to your town. |
/town invite sent removeall | Denies all of your town's sent invites. |
/town invite received | Show a list of invites your town has received from nations. |
/town invite accept {nationname} | Accept an invite to join a nation. |
/town invite deny {nationname} | Deny an invite to join a nation. |
/town invite {playername} | Send an invite to a player to join your town. |
/town spawn | Teleports you to your town's spawn. |
/town spawn {town} | Teleports you to another town's spawn. |
/town claim | Claim the townblock in which you stand for your town. |
/town claim 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. |
/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 claim fill | Flood fills a surrounded section of plots. You must claim your border before using this command. |
/town unclaim | Unclaim the townblock in which you stand. |
/town unclaim all | Unclaim all townblocks. |
/town unclaim {# (radius around current position)} | Command to unclaim an area of townblocks around you. |
/town unclaim outpost | Unclaim glitched outposts on MySQL Towny servers pre-0.92.0.0 |
/town withdraw {$} | Removes money from town bank. |
/town withdraw all | Withdraws all of the money from the town bank. |
/town deposit {$} | Adds money from player to the town bank. |
/town deposit all | Deposits all of your money into the town bank. |
/town deposit {$} {townname} | Deposits money from player into the specified town's bank. |
/town baltop {townname} | Opens a book displaying the richest players in a town. |
/town bankhistory {#} | Opens a book GUI with # number of transactions listed, showing the town bank history. |
/town buy bonus {amount} | Buys available bonus townblocks. |
/town allylist {townname} | Displays a list of allies for the Town. |
/town enemylist {townname} | Displays a list of enemies for the Town. |
/town delete {town name} | Admin/Mayor command to delete a town from towny's data folder's files. |
/town forsale|fs [$] | Puts up a town for sale at the specified amount. |
/town notforsale|nfs | Removes a town being available for sale. |
/town buytown {townname} | Prompts a player to buy a town which is set for sale. |
/town merge {town name} | {town name} is the town which will be merged into the town owned by the mayor using the command. |
/town outlawlist {town} | Displays a list of outlaws for a town. |
/town outlaw {add/remove} {name} | Adds or removes an outlaw from a town's outlaw list |
/town outpost {# (where # equals the corresponding outpost's number)} | Teleports to an outpost. |
/town outpost {list} | Lists your town's outposts. |
/town plotgrouplist {townname} {page #} | Lists a town's plotgroups with forsale and price indicated. |
/town purge {days} | Kicks residents from the town who have been inactive for the given number of days, exempts npcs and mayors. |
/town ranklist {townname} | Displays residents and their ranks, optional townname to view another town's rank list. |
/town rank {add|remove} {playername} {rankname} | Grants or removes a rank to a resident of the town. |
/town reclaim | Allows a resident to reclaim their ruined town. |
/town reslist {townname} | See a FULL list of all residents in a town. |
/town say {msg} | Broadcast a message to online town members. |
/town set board {message} | Sets message seen by residents upon logging in. |
/town set board none | Sets an empty board which will not be seen on login or in the /town status screen. |
/town set mayor {resident} | Give mayor status to another resident. |
/town set homeblock | Sets the homeblock and spawn of your town. |
/town set spawn | Sets the town spawn, must be done inside the homeblock. |
/town set spawncost | Set the cost of spawning to a public town. Doesn't affect town residents, nation members and nation-allies. |
/town set mapcolor {color} | Sets a town's mapcolor seen in the dynmap. |
/town set name {name} | Change your town's name. |
/town set outpost | Resets the outpost's spawn point to the player location. Must be used in an existing outpost plot. |
/town set perm {on/off} | Edits the perm line on the town screen. See here for details. |
/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 tag {upto4character} | Sets the town's tag, which is sometimes used on that chat line. |
/town set tag {upto4character} 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 taxpercentcap {$} | The maximum amount that can be taken when taxpercent is enabled. |
/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 set title {name} {titlegoeshere} | Add a Title to a member of the town. |
/town set title {name} | Remove a Title from a member of the town. |
/town set surname {name} {surnamegoeshere} | Add a Suffix to a member of the town. |
/town set surname {name} | Remove a Suffix from a member of the town. |
/town set primaryjail | Sets your town's primary jail. |
/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. |
/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 nationzone | Turn on/off the town's NationZone. |
/town toggle open | Turn on/off public joining to your town. |
/town takeoverclaim | Used by a mayor to take over land from an overclaimed town, when overclaiming is allowed in the config. |
/town join {townname} | Command to join a town that doesn't require invites. |
/town jail list | Shows jail number, name, coord, cellcount and which jail is the primary jail. |
/town jail {name} | Jails the given player for 1 hour, must be a resident of your own town. |
/town jail {name} {hours} | Jails the given player for the given hours. |
/town jail {name} {hours} {jail} | Jails the given player for the given hours, in the given jail plot (which is a number.) |
/town jail {name} {hours} {jail} {cell} | Jails the given player for the given hours, in the given jail plot and jail cell (which are both numbers.) |
/town jail {name} | Jails the given player for 1 hour, must be a resident of your own town, with the default bail amount. |
/town jail {name} {hours} | Jails the given player for the given hours, with the default bail amount. |
/town jail {name} {hours} {bail} | Jails the given player for the given hours, with the given bail amount. |
/town jail {name} {hours} {bail} {jail} | Jails the given player for the given hours, with the given bail amount, in the given jail plot (which is a number.) |
/town jail {name} {hours} {bail} {jail} {cell} | Jails the given player for the given hours, with the given bail amount, in the given jail plot and jail cell (which are both numbers.) |
/town unjail {name} | Unjails someone in your town's jail. |
/town trust add {name} | Adds a player as Trusted to the entire town. |
/town trust remove {name} | Removes a player from being Trusted by the entire town. |
/town trust list | Displays a list of trusted players for the town. |
/town trusttown add [townname] | Adds an entire town as trusted in your town. |
/town trusttown remove [townname] | Removes an entire town as trusted in your town. |
/town trusttown list | Displays a list of trusted towns in your town. |
/plot
| Command | Description |
|---|---|
/plot | Shows the /plot commands. |
/plot claim | Personally claim a plot that are for sale. |
/plot claim auto | Personally claim an area of plots that are for sale, around the player typing the command. |
/plot unclaim | Unclaim personally owned plots. |
/plot unclaim circle/rect | Unclaim personally owned plots in a circle or rectangle shape. |
/plot unclaim circle/rect {# (radius around current 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 district create|new [name] | Creates a new district, with the given name. |
/plot district add {name} | Adds a townblock to the given district. If you are actively adding to a district you do not need to continue supplying the name. |
/plot district rename [name] | Changes the name of a district. |
/plot district remove | Remove the townblock you are stood in from a district. |
/plot district delete | Deletes the district you are stood in. |
/plot evict | Remove a plot from a plot owner, usually by the mayor or assistant. |
/plot evict forsale | Evicts the plot owner and puts the plot up for sale immediately. |
/plot trust add {name} | Adds a player as Trusted on the plot. |
/plot trust remove {name} | Removes a player from being Trusted on the plot. |
/plot perm | Shows the perm line of the plot in which the player stands. |
/plot perm gui | Opens the GUI to configure the plot perm override. |
/plot perm add {name} | Adds a player to the plot perm override. |
/plot perm remove {name} | Removes a player from the plot perm override. |
/plot 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. |
/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 inn | Set a plot to an inn plot. |
/plot set jail | Set a plot to an jail plot. |
/plot set farm | Set a plot to a farm plot. |
/plot set bank | Set a plot to a bank plot. |
/plot set outpost | Set a plot to an outpost plot, costs the same as /t claim outpost. |
/plot set outpost spawn | Sets the spawn point inside of an existing outpost plot to where the player is standing. |
/plot set 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. |
/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 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.) |
/plot set minjoindays {#] | Sets the # of days, or removes the minjoindays amount when clear is used. |
/plot set minjoindays clear | Removes the minjoindays requirement. |
/plot set maxjoindays {#] | Sets the # of days, or removes the maxjoindays amount when clear is used. |
/plot set maxjoindays clear | Removes the maxjoindays requirement. |
/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 toggle taxed | Turn on/off whether a plot will charge a plotowner taxes, while they own the plot personally. |
/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. |
/plot group add|new|create {groupname} | Creates a plot group where a player is standing, also adds plots to an existing group. |
/plot group remove | Removes the plot stood in from its plot group. |
/plot group delete | Deletes a plot group entirely. |
/plot group rename {newname} | Renames a plot group. |
/plot group set {plottype} | Sets the group to a specified plot type. Not able to be used for Jail plots. |
/plot group set perm ... | Set the perm line of the group you are standing in. See above section for /plot set perm for remainder of commands. |
/plot group toggle ... | Toggle plot settings. See above section for /plot set toggle for remainder of commands. |
/plot group forsale|fs {price} | Set the group for sale at the set price. |
/plot group notforsale|nfs | Set the group not for sale. |
/plot group trust add {name} | Adds a player as Trusted on the plot group. |
/plot group trust remove {name} | Removes a player from being Trusted on the plot group. |
/plot group perm gui | Opens the GUI to edit the plot perm override. |
/plot group perm add {name} | Adds a player to the plot perm override. |
/plot group perm remove {name} | Removes a player from the plot perm override. |
/plot jailcell add | Adds a jail cell to a jail plot, where the player is stood. |
/plot jailcell remove | Removes a jail cell from a jail plot, where the player is stood. |
/nation
| Command | Description |
|---|---|
/nation | Shows a player their nation's nation screen. |
/nation ? | Shows /nation commands. |
/nation list by name {page #} | Order alpabetically. |
/nation list by resident {page #} | Order by nation with most residents across all towns. |
/nation list by balance {page #} | Order by nation with the highest nation bank balance. |
/nation list by towns {page #} | Order by nation with the most towns. |
/nation list by townblocks {page #} | Order nations by how many townblocks their towns have collectively claimed. |
/nation list by online {page #} | Order by how many players are online at that moment. |
/nation list by open {page #} | Ordered by open first, number of residents second. |
/nation list by public {page #} | Order by public first, number of residents second. |
/nation list by founded {page #} | Order by founded date, oldest first. |
/nation online | Shows players in your nation which are online. |
/nation {nation} | Shows a player the /nation screen of another nation. |
/nation leave | Leave the nation they are a part of. |
/nation withdraw {$} | King command to remove money from the nation bank. |
/nation withdraw all | Withdraws all of the money from the nation bank. |
/nation deposit {$} | Command to add money to the nation bank. |
/nation deposit all | Deposits all of your money into the nation bank. |
/nation baltop {nationname} | Opens a book displaying the richest players in a nation. |
/nation bankhistory {#} | Opens a book GUI with # number of transactions listed, showing the nation bank history. |
/nation deposit {$} {townname} | King command to add money to the bank of a town who is in the nation. |
/nation new {nationname} | Create a nation. |
/nation rank | Command to set assistant/custom ranks in the nation. |
/nation add {town} .. {town} | Invites/Adds a town to your nation. |
/nation kick {town} .. {town} | Removes a town from your nation. |
/nation delete {nation} | Deletes your nation. |
/nation invite | Show a list of invites sent. |
/nation invite help | Show a list of invites sent. |
/nation invite sent | Show a list of invites sent. |
/nation invite {town} | Invites a town to a nation. |
/nation ally | Show a list of nation alliance invites sent. |
/nation ally add {nation} .. {nation} | Add a nation to your nation's ally list. |
/nation ally remove {nation} .. {nation} | Removes a nation from your nation's ally list. |
/nation ally accept {nationname} | Accepts an invitation to ally from another nation. |
/nation ally deny {nationname} | Denies an invitation to ally from another nation. |
/nation ally sent | Show a list of nation alliance invites sent. |
/nation ally received | Show a list of nation alliance invites received. |
/nation enemy add {nation} .. {nation} | Add a nation to your nation's enemy list. |
/nation enemy remove {nation} .. {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 sanctiontown add [townname] | Adds a town to the sanctioned town list. |
/nation sanctiontown remove [townname] | Removes a town from the sanctioned town list. |
/nation sanctiontown list | Lists your nation's sanctioned towns. |
/nation sanctiontown list [nationname] | Lists the sanctioned towns of other nations. |
/nation say {msg} | Broadcast a message to online nation members. |
/nation set king {resident} | King command to change the king of the nation. |
/nation set capital {town} | Sets the capitol and king of the nation. |
/nation set board {message} | Sets message seen by residents upon logging in. |
/nation set board none | Sets an empty board which will not be seen on login or in the /nation status screen. |
/nation set taxes {$} | Sets nationtax applied to the towns within the nation. |
/nation set conqueredtax {$} | Sets a nation's conquered tax, which is paid by the conquered towns. |
/nation set taxpercentcap | Sets the maximum amount that a town will pay in nationtax, when the nation has percent-based taxation. |
/nation set name {name} | Sets the nation's name. |
/nation set spawn | Sets the nation spawn point. |
/nation set spawncost | Sets the cost of public spawns to that nation's spawn point. No effect on members of the nation or nation-allies |
/nation set title {name} {titlegoeshere} | King command to add a Title to a member of the nation. |
/nation set title {name} | King command to clear a Title from a member of the nation. |
/nation set surname {name} {surnamegoeshere} | King command to add a Suffix to a member of the nation. |
/nation set surname {name} | King command to clear a Suffix from 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 {upto4character} clear | Clears the tag set for the nation. |
/nation set mapcolor {color} | Sets the colour seen on the dynmap-towny webpage. |
/nation toggle neutral | Sets whether your nation will pay daily to be neutral during towny war. |
/nation toggle open | Sets the nation to be open, so that any town can join without an invite. |
/nation toggle taxpercent | Turns on and off the percentage-based taxation of towns in the nation. |
/nation ranklist {nationname} | Displays residents and their ranks, optional nationname to view another nation's rank list. |
/townyadmin
| Command | Description |
|---|---|
/townyadmin ? | Shows /ta commands. |
/townyadmin tpplot {world} {x} {z} | Teleports an admin to the Towny chunk coordinates seen in the /towny map command. Be careful with large numbers, you could be teleported farther than you think and end up generating chunks. |
/townyadmin claim {playername} | Claim a plot for another player. Area must be a part of a town. |
/townyadmin meta | View a plot's metadata. |
/townyadmin meta set [key] [value] | Sets a metadata. |
/townyadmin meta [add|remove] [key] | Adds or removes a metadata. |
/townyadmin claimedat | Shows when the plot was claimed. |
/townyadmin {residentname} delete | Delete a resident. |
/townyadmin {oldname} rename {newname} | Manually rename a resident to a new name. Not need if TownyNameUpdater.jar is present. |
/townyadmin {residentname} friend [add|remove|clear|list] | Allows admins to manipulate a resident's friends list. |
/townyadmin {residentname} unjail | Unjail any resident. |
/townyadmin {residentname} about clear | Remove a resident's About line. |
/townyadmin {residentname} meta set [key] [value] | Sets a meta data key on a resident to the value. |
/townyadmin {residentname} meta [add|remove] [key] | Adds or removes a metadata key to/from a resident. |
/townyadmin town new {townname} {mayor} | Create a town for the mayor where the command sender is standing, does not charge money. |
/townyadmin town new {townname} npc | Creates a new town with an NPC mayor, allowing admins to make a new town without having to leave their own. |
/townyadmin nation new {nationname} {capital} | Create a nation for the capital town, does not charge money. |
/townyadmin add {resident} .. {resident} | Forcibly add a player to a town. |
/townyadmin invite {resident} | Send a town invite to a player. |
/townyadmin remove {resident} .. {resident} | Remove a resident from a town. |
/townyadmin kick {resident} | Remove a resident from a town. |
/townyadmin rename {newname} | Rename a town. |
/townyadmin spawn | Spawn at at town spawn. |
/townyadmin outpost # | Spawn at any towns outposts. |
/townyadmin delete | Delete a town. |
/townyadmin buy .... | Use the buy command as though you were a part of the town. |
/townyadmin forsale|fs [$] | Sets a town for sale. |
/townyadmin notforsale|nfs | Sets a town not for sale. |
/townyadmin rank {add/remove} {name} {rank} | Give/remove a rank to a town member. |
/townyadmin toggle [any /t toggle command]... | Use a town's toggles for them. |
/townyadmin toggle [any /t toggle command]... conquered | Set the town's conquered status off. |
/townyadmin toggle [any /t toggle command]... forcemobs | Set the town's forced-mobs setting true or false. |
/townyadmin toggle [any /t toggle command]... forcepvp | Set the town's AdminEnabledPVP setting to true or false. |
/townyadmin toggle [any /t toggle command]... forcedisablepvp | Sets the town's AdminDisabledPVP setting to true or false. |
/townyadmin toggle [any /t toggle command]... unlimitedclaims | Removes the townblock limit for the given town. |
/townyadmin toggle [any /t toggle command]... upkeep | Toggles a town's hasUpkeep flag, set to false to stop a town paying upkeep costs. |
/townyadmin toggle [any /t toggle command]... visibleontoplists | Toggles whetehr a town can be seen in the /towny top, /t list by commands (as well as the PAPI Placeholders.) |
/townyadmin toggle [any /t toggle command]... allowedtowar | Toggles whether a town can have a war made against it, (dependent on the war plugin supporting this feature.) |
/townyadmin set [any /t set command]... | Use a town's set command for them. |
/townyadmin set foundingdate [unix timestamp] | Sets a town's founding date to the given time, use https://www.unixtimestamp.com/ to get a suitable timestamp number. |
/townyadmin settownlevel #`` | Manually overrides a town's townlevel to a number, 1 through x, where x is the last townlevel. |
/townyadmin settownlevel unset | Removes the manual override and returns a town to using the normal townlevel based on resident count. |
/townyadmin giveboughtblocks #`` | Allows an admin to give purchased blocks (the ones gotten via /t buy bonus,) use negative numbers to take away purchased blocks. |
/townyadmin giveboughtblocks unset | Removes all purchased townblocks from the town. |
/townyadmin meta | View a town's metadata. |
/townyadmin meta set [key] [value] | Sets a metadata. |
/townyadmin meta [add|remove] [key] | Adds or removes a metadata. |
/townyadmin outlaw [add|remove] [name] | Add/remove outlaws from a town. |
/townyadmin leavenation | Make a town leave their nation. |
/townyadmin deposit [amount] | Deposit money into a town's bank. |
/townyadmin withdraw [amount] | Withdraw money from a town's bank. |
/townyadmin bankhistory {#} | Opens a book GUI with # number of transactions listed, showing the town bank history. |
/townyadmin unruin | Un-ruins a ruined town. |
/townyadmin merge {townname} | Send a merge request to the other town. |
/townyadmin forcemerge [townname] | Forcefully merges the 2nd town into the first, without a confirmation. |
/townyadmin checkoutposts | Checks the outpost spawns of a single town, removing any that aren't within the town. |
/townyadmin add {town} | Invite/add a town to a nation. |
/townyadmin rename {newname} | Rename a nation. |
/townyadmin delete | Delete a town. |
/townyadmin toggle [any /n toggle command]... | Use a nation's toggles for them. |
/townyadmin set [any /n set command]... | Use a nation's set command for them. |
/townyadmin set foundingdate [unix timestamp] | Sets a nation's founding date to the given time, use https://www.unixtimestamp.com/ to get a suitable timestamp number. |
/townyadmin kick [towns...] | Remove towns from a nation. |
/townyadmin deposit [amount] | Deposit money into a nation's bank. |
/townyadmin withdraw [amount] | Withdraw money from a nation's bank. |
/townyadmin bankhistory {#} | Opens a book GUI with # number of transactions listed, showing the nation bank history. |
/townyadmin ally [add|remove] {nationname} | Adds/Remove an ally for a nation. |
/townyadmin enemy [add|remove] {nationname} | Adds/Remove an enemy for a nation. |
/townyadmin merge {nationname} | Send a merge request to the other nation. |
/townyadmin meta set [key] [value] | Sets a meta data key on a nation to the value. |
/townyadmin meta [add|remove] [key] | Adds or removes a metadata key to/from a nation. |
/townyadmin forcemerge {nationname} | Forcefully merges the 2nd nation into the first, without a confirmation. |
/townyadmin recheck | Tests the towns within the nation, removing any towns which do not meet the distance rules. |
/townyadmin transfer [townname] | Places the given town into the given nation, removing any old nation if needed. |
/townyadmin sanctiontown add [townname] | Adds a town to the sanctioned town list. |
/townyadmin sanctiontown remove [townname] | Removes a town from the sanctioned town list. |
/townyadmin sanctiontown list | Lists the nation's sanctioned towns. |
/townyadmin reset | Resets the towny config.yml to its current default. |
/townyadmin neutral | Turn on/off a nation's ability to declare neutrality. |
/townyadmin npc {residentname} | Toggles a player's resident file to isNPC=true, this exempts the player from taxes/upkeep. |
/townyadmin debug | Turns on/off debug mode. |
/townyadmin devmode | Turns on/off special devmode for when towny's devs join your server to find a bug. |
/townyadmin withdraw | Turns on/off town/nation's ability to withdraw money from their town/nation banks. |
/townyadmin wildernessuse (on|off) | Turns on/off the build/destroy/switch/itemuse properties of all worlds. |
/townyadmin regenerations (on|off) | Toggles explosion regen and unclaimed revert in the wilderness of each world off or on. |
/townyadmin founder {townname} {foundername} | Sets the founder of a town. |
/townyadmin about {playername} {clear|none|reset|msg} | Sets or clears a resident About message. |
/townyadmin plot {town} | Sets a plot to a town. |
/townyadmin title {name} {title} | A command for admins to be able to set a player's title. |
/townyadmin surname {name} {surname} | A command for admins to be able to set a player's surname. |
/townyadmin capital {townname} | A command for admins to be able to change a nations capital. Town to be set must already be a member of the nation. |
/townyadmin mayor {town} {resident} | Set a resident as mayor of a town. |
/townyadmin mayor {town} npc | Set a town to have an npc mayor. |
/townyadmin nationzoneoverride [town] [size] | Sets a town's NationZone size. |
/townyadmin givebonus {town} {#} | Gives extra townblocks to a town. |
/townyadmin all | Reloads everything. |
/townyadmin database | Reloads the database. |
/townyadmin perms | Reload the townyperms.yml. |
/townyadmin config | Reloads the config.yml. |
/townyadmin lang | Reloads the language file. |
/townyadmin backup | Creates a backup. |
/townyadmin checkperm {player} {node} | Quick test of whether a player has a permission node. |
/townyadmin checkoutposts | Checks all the towns on the server for invalid outposts spawns, removing any that aren't within the town. |
/townyadmin newday | Causes a new day to happen, this does not stop the next new day from happening when it was already scheduled. |
/townyadmin rect {radius} | Unclaim an area. |
/townyadmin purge {# as in days} (townless) | Deletes old residents. |
/townyadmin purge {# as in days} {townname} | Deletes old residents. |
/townyadmin [save|load] | Saves or loads the database. |
/townyadmin remove titles | Removes all titles and surnames from all residents. |
/townyadmin grouplist | Lists all the groups in the townyperms.yml |
/townyadmin info [Town|Nation|Resident|ServerAccount] {name} | Shows you information about the given Towny object account. |
/townyadmin convert modern | Converts your Towny economy implementation from the legacy to modern system. |
/townyadmin convert {economy plugin} | Converts your Towny accounts from your existing economy plugin to the given economy plugin. |
/townyadmin depositall {amount} | Gives the amount to all Town and Nation banks. |
/townyadmin depositalltowns {amount} | Gives the amount to all Town banks. |
/townyadmin depositallnations {amount} | Gives the amount to all Nation banks. |
/townyadmin resetbanks | Removes all money from Town and Nation banks. |
/townyworld
| Command | Description |
|---|---|
/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 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 friendlyfire | Turn on/off whether town/nation/allied members can hurt each other. |
/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 forcefire | Force firespread on in that world. |
/townyworld toggle jailing | Turn on/off jailing 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 wildernessmobs | Turn on/off the mobs listed in the wilderness mobs in the wilderness. |
/townyworld toggle revertunclaim | Turn on/off the revert on unclaim feature for that world. |
/townyworld toggle revertentityexpl | Turn on/off the reverting of explosions by entities in the wilderness feature for that world. |
/townyworld toggle revertblockexpl | Turn on/off the reverting of explosions by blocks in the wilderness feature for that world. |
/townyworld toggle warallowed | Turn on/off whether war plugins should operate in this world. |
/townyworld toggle plotcleardelete | Turn on/off whether the /plot clear command can be used. |
/townyworld toggle unclaimblockdelete {on|off} | Turns on/off the delete-blocks-on-unclaim feature in the world. |
/townyworld toggle unclaimentitydelete {on|off} | Toggles a world's unclaiming-deletes-entities feature off and on. |
/townyworld toggle wildernessuse {on|off} | Turns on/off the build/destroy/switch/itemuse properties in the world. |
/townyworld set wildname {name} | Sets name of the wilderness. |
/townyworld set wildperm {perm} .. {perm} | Deprecated. |
/townyworld set wildignore {id} .. {id} | Deprecated. |
/townyworld set wildregen {Creeper,EnderCrystal,EnderDragon,Fireball, SmallFireball,LargeFireball,TNTPrimed,ExplosiveMinecart} | Sets what explosions are reverted in the wilderness. |
/townyworld set usedefault | Deprecated. |
/townyworld regen | Regenerates the MC chunk in which back to the seed. |
/townyworld undo | Undoes /tw regen. |
/invite
| Command | Description |
|---|---|
/invite | Shows subcommands. |
/invite ?|help | Shows subcommands. |
/invite list | Shows a list of invites you have received from towns. |
/invite accept {town} | Accepts an invite to join a town. |
/invite deny {town} | Denies an invite to join a town. |
/invite deny all | Denies all of a player's received town invites. |
Chat commands
| Command | Description |
|---|---|
/townychat reload | Reloads chatconfig.yml and channels.yml |
/tc | Put in front of text to speak with members of your town only, or without text to enter the channel to enter the channel. |
/nc | Put in front of text to speak with members of your nation only, or without text to enter the channel to enter the channel. |
/ac | Put in front of text to speak with members of your nation and your nation's allies, or without text to enter the channel to enter the channel. |
/g | Put in front of text to speak in globalchat, or without text to enter the channel to enter the channel. |
/l, /lc | Put in front of text to speak in localchat, or without text to enter the channel to enter the channel. |
/res set mode reset | Reset chat mode to default chat. |
/a, /admin | admin chat. |
/m, /mod | moderator chat. |
/channel leave|join {channel} | Channel leaving and joining. |
/ch list | list what channels a player is currently listening to. Courtesy of Yaiyan. |
/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. |