FrontierSMP
Search
⌃K
📃

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

  • /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

  • /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

  • /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
        • {on/off} - Edits the perm line on the resident screen. See here for details.​
        • {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

  • /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
        • {on/off} - Edits the perm line on the town screen. 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 - 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

  • /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.
Towny - Previous
Introduction to Towny
Next
Towny Resources
Last modified 4mo ago