All Towny permission nodes

This pages lists all permission nodes for the Minecraft plugin Towny. Permission nodes can be used to fine‑tune access to commands and features. By default most nodes are assigned automatically via the townyperms.yml but can also be used withing other permission plugins. Most servers use Luckperms for that purpose.

/townyadmin

Permission node	Description
towny.admin	Allows the player to use /townyadmin and gives them unrestricted build, destroy and interact permissions in any town.
towny.admin.nation_zone	Bypasses nation zone protection so moderators without full towny.admin can enter and edit nation zones.
towny.admin.outlaw.teleport_bypass	Lets a player enter towns in which they are outlawed without being teleported away.
towny.admin.town_commands.blacklist_bypass	Allows an admin to ignore the command‑blocking lists when using town commands.
towny.admin.updatealerts	Controls whether an admin will receive update notifications.
towny.admin.spawn	Lets the user bypass the costs, warmups and cooldowns for spawn commands. Child nodes permit more granular control:
towny.admin.spawn.nocharge	No charge is taken when spawning to towns.
towny.admin.spawn.nocooldown	Removes the cooldown after using a spawn command.
towny.admin.spawn.nowarmup	Removes the warmup before teleporting.
towny.command.townyadmin.*	Grants access to all /townyadmin sub‑commands. The following nodes allow more specific permissions:
towny.command.townyadmin	Use the base /townyadmin command.
towny.command.townyadmin.set.*	Grants access to /ta set sub‑commands such as setting a resident’s about text or assigning mayors. For example, towny.command.townyadmin.set.about lets an admin alter a player’s /res about blurb.
towny.command.townyadmin.plot.*	Allows admins to claim plots for others (/ta plot claim).
towny.command.townyadmin.resident.*	Permissions relating to resident management, such as modifying a resident’s friends list.
towny.command.townyadmin.town.*	Allows /ta town add, /ta town kick, /ta town new, and other town‑level administrative commands.
towny.command.townyadmin.nation.*	Allows /ta nation add, /ta nation kick, /ta nation new and other nation‑level administrative commands.
towny.command.townyadmin.toggle.*	Grants access to /ta toggle operations such as toggling devmode, debug, NPC mode or wilderness use.
towny.command.townyadmin.eco.*	Permits economy‑related sub‑commands like depositall, depositalltowns, depositallnations, resetbanks and convert.
towny.command.townyadmin.givebonus	Allows /ta givebonus … which awards bonus town blocks.
towny.command.townyadmin.reload	Enables /ta reload, reloading Towny’s configuration.
towny.command.townyadmin.reset	Generates a fresh config.yml and performs a full Towny reload.
towny.command.townyadmin.townyperms	Allows in‑game editing of townyperms.yml.
towny.command.townyadmin.tpplot	Permission to use /ta tpplot to teleport to a plot by co‑ordinates.
towny.command.townyadmin.install	Use /ta install to generate new data files.
towny.command.townyadmin.backup	Perform a Towny backup.
towny.command.townyadmin.newday	Run a new day event for taxes and upkeep collection.
towny.command.townyadmin.newhour	Fires a new hour event.
towny.command.townyadmin.purge	Remove old resident files (/ta purge 30 purges residents inactive for 30 days).
towny.command.townyadmin.unclaim	Unclaim the plot you are standing in.
towny.command.townyadmin.resident.delete	Deletes a specific resident (/ta res delete {name}).
towny.command.townyadmin.checkoutposts	Allows /ta checkoutposts which lists available outposts for towns.
towny.claimed.*	Grants full build/destroy/switch/item‑use rights in all towns. This should only be given to moderator ranks.
towny.claimed.alltown.build.*	User can build in all towns.
towny.claimed.alltown.destroy.*	User can destroy blocks in all towns.
towny.claimed.alltown.switch.*	User can toggle switches (doors, levers, etc.) in all towns.
towny.claimed.alltown.item_use.*	User can use items in all towns.
towny.claimed.owntown.build.*	Allows building anywhere inside the player’s own town.
towny.claimed.owntown.destroy.*	Allows destroying blocks in the player’s own town.
towny.claimed.owntown.switch.*	Allows switching doors and levers in the player’s own town.
towny.claimed.owntown.item_use.*	Allows using items in the player’s own town.
towny.claimed.townowned.build.*	Permits building on plots owned by the town (not private plots).
towny.claimed.townowned.destroy.*	Permits destroying blocks on town‑owned plots.
towny.claimed.townowned.switch.*	Permits interacting with switches on town‑owned plots.
towny.claimed.townowned.item_use.*	Permits using items on town‑owned plots.

/plot

These nodes govern the /plot command.

Permission node	Description
towny.command.plot.*	Grants access to all plot‑related commands.
towny.command.plot.asmayor	Allows mayor‑level plot management: reclaim plots from residents, toggle plot settings and put plots up for sale or remove them from sale.
towny.command.plot.asmayorinunowned	Assistant‑like rank: may perform mayor‑style management tasks (manage plot groups, set plots for sale, alter jail cells, adjust plot perms and trust lists) but only on town‑owned plots with no private owner.
towny.command.plot.claim	Allows a player to personally claim a plot that is for sale (maps to /plot claim) .
towny.command.plot.unclaim	Allows a player to unclaim their own plot (maps to /plot unclaim) .
towny.command.plot.notforsale	Allows a mayor or assistant to mark a plot as not for sale (maps to /plot notforsale) .
towny.command.plot.forsale	Allows a mayor or assistant to set a plot for sale (/plot forsale) .
towny.command.plot.district.add	Add the current townblock to a district (/plot district add) .
towny.command.plot.district.remove	Remove the current townblock from a district (/plot district remove) .
towny.command.plot.district.delete	Delete the district you are standing in (/plot district delete) .
towny.command.plot.district.rename	Rename a district (/plot district rename) .
towny.command.plot.evict	Evict a plot owner, optionally marking the plot for sale (/plot evict) .
towny.command.plot.jailcell	Manage jail cells on jail plots (/plot jailcell add/remove) .
towny.command.plot.perm.*	Access to plot permission management. Child nodes allow GUI access (.gui), adding/removing players from the perm override (.add, .remove) and toggling the perm HUD (.hud) .
towny.command.plot.toggle.pvp	Toggle PvP status on a plot (/plot toggle pvp) .
towny.command.plot.toggle.explosion	Toggle explosion damage on a plot (/plot toggle explosion) .
towny.command.plot.toggle.fire	Toggle firespread on a plot (/plot toggle fire) .
towny.command.plot.toggle.mobs	Toggle hostile mob spawning on a plot (/plot toggle mob) .
towny.command.plot.trust	Add or remove a player as trusted on a plot (/plot trust add/remove) .
towny.command.plot.set.perm	Edit the perm line of the plot you stand in (/plot set perm {on/off}) .
towny.command.plot.set.reset	Reset plot type back to normal (shop/embassy/arena/wilds/inn/jail/spleef) (/plot set reset) .
towny.command.plot.set.shop	Convert a plot into a shop plot (/plot set shop) .
towny.command.plot.set.embassy	Convert a plot into an embassy plot (/plot set embassy) .
towny.command.plot.set.arena	Convert a plot into an arena plot (/plot set arena) .
towny.command.plot.set.wilds	Convert a plot into a wilds plot (/plot set wilds) .
towny.command.plot.set.inn	Convert a plot into an inn plot (/plot set inn) .
towny.command.plot.set.jail	Convert a plot into a jail plot (/plot set jail) .
towny.command.plot.set.spleef	Convert a plot into a spleef plot (/plot set spleef) .
towny.command.plot.clear	Clears blocks from a plot using /plot clear .
towny.command.plot.group.add	Create a new plot group or add plots to an existing group (/plot group add) .
towny.command.plot.group.remove	Remove the current plot from its plot group (/plot group remove) .
towny.command.plot.group.delete	Delete a plot group (/plot group delete) .
towny.command.plot.group.rename	Rename a plot group (/plot group rename) .
towny.command.plot.group.set	Set the group type (shop, embassy, etc.) for a plot group (/plot group set {type}) .
towny.command.plot.group.toggle	Toggle plot settings for the entire group .
towny.command.plot.group.forsale	Mark an entire plot group for sale (/plot group forsale) .
towny.command.plot.group.notforsale	Remove a plot group from sale (/plot group notforsale) .
towny.command.plot.group.trust	Trust management for plot groups (/plot group trust add/remove) .
towny.command.plot.group.perm	Permission override management for plot groups, including GUI, add, remove and HUD functions .

/resident

These nodes control the /resident command.

Permission node	Description
towny.command.resident.*	Grants access to all resident commands.
towny.command.resident.list	Lists residents in the data folder who are online (/resident list) .
towny.command.resident.tax	Shows taxes a player pays (/resident tax) .
towny.command.resident.jail	Allows a player to pay bail when jailed (/resident jail paybail) .
towny.command.resident.otherresident	Lets a player view another resident’s information using /resident {resident} .
towny.command.resident.outlawlist	Displays the list of towns in which the resident is outlawed (/resident outlawlist) .
towny.command.resident.plotlist	Lists plots owned by the resident (/resident plotlist) .
towny.command.resident.set.about	Set a bio/about message shown in the /resident status screen (/resident set about {message}) .
towny.command.resident.set.perm	Edit the perm line on the resident screen (/resident set perm) .
towny.command.resident.set.mode	Manage default modes for the resident (map, townclaim, etc.) (/resident set mode) .
towny.command.resident.set.mode.clear	Clears any set modes (/resident set mode clear) .
towny.command.resident.spawn	Teleports a player to their bed spawn if beds are preferred (/resident spawn) .
towny.command.resident.toggle.pvp	Toggles PvP on personally owned plots (/resident toggle pvp).
towny.command.resident.toggle.explosion	Toggles explosions on personally owned plots (/resident toggle explosion).
towny.command.resident.toggle.fire	Toggles firespread on personally owned plots (/resident toggle fire).
towny.command.resident.toggle.mobs	Toggles hostile mob spawning on personally owned plots (/resident toggle mobs).
towny.command.resident.toggle.bedspawn	Toggles preferring the bed spawn over the town spawn (/resident toggle bedspawn).
towny.command.resident.toggle.bordertitles	Toggles on/off the title messages shown when entering/leaving towns (/resident toggle bordertitles).
towny.command.resident.toggle.constantplotborder	Shows the smokey border around plots constantly (/resident toggle constantplotborder).
towny.command.resident.toggle.plotborder	Shows the smokey border when crossing plot borders (/resident toggle plotborder).
towny.command.resident.toggle.district	Enables automatic adding of plots to the district you are creating (/resident toggle district).
towny.command.resident.toggle.ignoreplots	Turns on/off plot notifications in town (/resident toggle ignoreplots).
towny.command.resident.toggle.ignoreinvites	Turns on/off receiving town invites (/resident toggle ignoreinvites).
towny.command.resident.toggle.ignoreotherchannels	Turns on/off receiving messages from other chat channels (/resident toggle ignoreotherchannels).
towny.command.resident.toggle.infotool	Allows use of the clay brick tool to inspect block/entity names (/resident toggle infotool).
towny.command.resident.toggle.map	Turns on map mode where the map updates as you cross plot borders (/resident toggle map).
towny.command.resident.toggle.plotgroup	Automatically adds plots you enter into a plot group you are constructing (/resident toggle plotgroup).
towny.command.resident.toggle.townborder	Shows the smokey border around the town you are standing in (/resident toggle townborder).
towny.command.resident.toggle.townclaim	Enables auto‑claim mode for /town claim when crossing borders (/resident toggle townclaim).
towny.command.resident.toggle.townunclaim	Enables auto‑unclaim mode for /town unclaim when crossing borders (/resident toggle townunclaim).
towny.command.resident.friend	Allows manipulation of a resident’s friend list (add, remove, clear, list) .

/town

Town nodes include general membership, spawn travel and the very large /town command family. Use these nodes to control what residents can do within their towns.

Permission node	Description
towny.town.*	Grants access to all town permission nodes.
towny.town.resident	Allows a user to join a town.
towny.town.spawn.town	Allows players to spawn to their own town (/town spawn).
towny.town.spawn.nation	Allows players to spawn to other towns in their nation.
towny.town.spawn.ally	Allows players to spawn to towns in allied nations.
towny.town.spawn.public	Allows players to spawn to unaffiliated public towns.
towny.town.spawn.outpost	Allows players to spawn to their own town’s outposts.
towny.town.spawn.nation.bypass_public	Lets a nation member travel to a non‑public allied town even when the configuration normally prohibits it.
towny.town.spawn.ally.bypass_public	As above but for players in allied nations.
towny.command.town.*	Grants access to all /town sub‑commands.
towny.command.town.here	Shows you the town screen of the town you are standing in (/town here) .
towny.command.town.allylist	Lists your town’s allies (/town allylist) .
towny.command.town.enemylist	Lists your town’s enemies (/town enemylist) .
towny.command.town.list.forsale	Lists towns for sale (/town list by forsale) .
towny.command.town.list.residents	Orders towns by number of residents (/town list by resident) .
towny.command.town.list.open	Lists open towns first (/town list by open) .
towny.command.town.list.balance	Orders towns by highest balance (/town list by balance) .
towny.command.town.list.upkeep	Orders towns by upkeep owed (/town list by upkeep) .
towny.command.town.list.name	Orders towns alphabetically (/town list by name) .
towny.command.town.list.townblocks	Orders towns by number of townblocks claimed (/town list by townblocks) .
towny.command.town.list.online	Orders towns by number of players online (/town list by online) .
towny.command.town.list.public	Orders towns by whether they are public (/town list by public) .
towny.command.town.list.ruined	Orders towns by ruin status (/town list by ruined) .
towny.command.town.list.bankrupt	Orders towns by bankruptcy status (/town list by bankrupt) .
towny.command.town.list.founded	Orders towns by founded date (/town list by founded) .
towny.command.town.new	Create a new town (/town new {townname}) .
towny.command.town.leave	Leave the current town (/town leave) .
towny.command.town.withdraw	Withdraw money from the town bank (/town withdraw {$}) .
towny.command.town.deposit	Deposit money into the town bank (/town deposit {$}) .
towny.command.town.deposit.othertown	Allows depositing into other towns’ banks.
towny.command.town.bankhistory	View town bank transaction history (/town bankhistory {#}) .
towny.command.town.forsale	Put your town up for sale (/town forsale) .
towny.command.town.notforsale	Remove your town from sale (/town notforsale) .
towny.command.town.buytown	Buy a town that is for sale (/town buytown {town}) .
towny.command.town.rank.*	Manage town ranks (/town rank {add|remove} {player} {rank}) .
towny.command.town.reslist	Show all residents of a town (/town reslist) .
towny.command.town.jail	Jail a resident of your town (/town jail {name}) .
towny.command.town.jail.list	List jail cells in your town (/town jail list) .
towny.command.town.unjail	Unjail someone in your town’s jail (/town unjail {name}) .
towny.command.town.merge	Merge another town into your town (/town merge {town}) .
towny.command.town.outlaw	Allows outlawing players in your town.
towny.command.town.outpost.list	List your town’s outposts (child of towny.town.spawn.town).
towny.command.town.plotgrouplist	Lists a town’s plot groups (/town plotgrouplist) .
towny.command.town.purge	Kick inactive residents (/town purge {days}) .
towny.command.town.reclaim	Reclaim a ruined town (/town reclaim) .
towny.command.town.set.board	Set the message shown to residents on login (/town set board {message}) .
towny.command.town.set.mayor	Assign a new mayor (/town set mayor {resident}) .
towny.command.town.set.homeblock	Sets the town’s home block and spawn (/town set homeblock) .
towny.command.town.set.spawn	Set the town’s spawn point (must be inside homeblock) .
towny.command.town.set.spawncost	Set the cost non‑members pay to spawn to your town (/town set spawncost) .
towny.command.town.set.outpost	Reset an outpost’s spawn point (/town set outpost) .
towny.command.town.set.perm	Edit the town‑wide perm line (/town set perm {on/off}) .
towny.command.town.set.taxes	Set the daily resident tax (/town set taxes {$}) .
towny.command.town.set.plottax	Set the daily tax per plot owned by residents (/town set plottax {$}) .
towny.command.town.set.shoptax	Set the daily tax per shop plot (/town set shoptax {$}) .
towny.command.town.set.embassytax	Set the daily tax per embassy plot (/town set embassytax {$}) .
towny.command.town.set.plotprice	Set the default cost of plots (/town set plotprice {$}) .
towny.command.town.set.shopprice	Set the default cost of shop plots (/town set shopprice {$}) .
towny.command.town.set.embassyprice	Set the default cost of embassy plots (/town set embassyprice {$}) .
towny.command.town.set.mapcolor	Set your town’s map colour on dynmap (/town set mapcolor {color}) .
towny.command.town.set.name	Rename your town (/town set name {name}).
towny.command.town.set.primaryjail	Set your town’s primary jail (/town set primaryjail) .
towny.command.town.set.tag	Set a short tag for your town (/town set tag {upto4character}) .
towny.command.town.set.taxpercentcap	Set the maximum percentage that can be taken when using percentage‑based taxation (/town set taxpercentcap {$}) .
towny.command.town.set.title	Give a resident a title (/town set title {name} {title}) .
towny.command.town.set.title.colours	Allows coloured titles when does_adding_colour_codes_require_permission_node is enabled.
towny.command.town.set.surname	Give a resident a suffix (/town set surname {name} {suffix}) .
towny.command.town.buy.bonus	Buy bonus townblocks (/town buy bonus {amount}) .
towny.command.town.othertown	View another town’s status screen (/town {townname}).
towny.command.town.plots	Show plots belonging to a town (/town plots {townname}) .
towny.command.town.say	Broadcast a message to online town members (/town say {msg}) .
towny.command.town.toggle.pvp	Toggle PvP in your town (/town toggle pvp).
towny.command.town.toggle.public	Toggle your town’s public status (/town toggle public).
towny.command.town.toggle.explosion	Toggle explosions in town (/town toggle explosion).
towny.command.town.toggle.fire	Toggle firespread in town (/town toggle fire).
towny.command.town.toggle.neutral	Toggle whether your town pays neutrality costs during war (/town toggle neutral).
towny.command.town.toggle.mobs	Toggle hostile mob spawning (/town toggle mobs).
towny.command.town.toggle.taxpercent	Toggle percentage‑based taxation (/town toggle taxpercent).
towny.command.town.toggle.open	Toggle public joining to your town (/town toggle open).
towny.command.town.toggle.nationzone	Toggle your town’s nation zone (/town toggle nationzone).
towny.command.town.trust	Add or remove a trusted resident (/town trust add/remove {name}) .
towny.command.town.trusttown	Add or remove a trusted town (/town trusttown add/remove {townname}) .
towny.command.town.mayor	Grants mayor commands such as renaming the town and other mayor‑only actions .
towny.command.town.delete	Delete your town (/town delete {town}) .
towny.command.town.join	Join an open town (/town join {town}) .
towny.command.town.add	Add residents to your town (/town add {resident}) .
towny.command.town.kick	Remove residents from your town (/town kick {resident}) .
towny.command.town.takeoverclaim	Take over land from an overclaimed town when overclaiming is enabled (/town takeoverclaim).
towny.command.town.claim.town	Allows claiming regular plots (/town claim).
towny.command.town.claim.outpost	Allows claiming outpost plots (/town claim outpost).
towny.command.town.claim.fill	Allows flood‑fill claiming of plots (/town claim fill).
towny.command.town.claim.town.multiple	Allows multi‑plot claims via auto, rect or circle (`/town claim auto
towny.command.town.unclaim	Unclaim the plot you are standing in (/town unclaim).
towny.command.town.unclaim.all	Unclaim all town plots (/town unclaim all) .
towny.command.town.cede.plot	Allows town cede plot {townname} to give a plot to another town .
towny.command.town.online	Shows players in your town who are online (/town online) .
towny.command.town.invite.manage.*	Manage town invites (/town invite ...); includes adding residents, accepting and denying invites.
towny.command.town.invite.sent	View sent invites.
towny.command.town.invite.received	View received invites.
towny.command.town.invite	View invite help page.

/nation

Nation nodes govern the /nation command and nation travel.

Permission node	Description
towny.nation.spawn.nation	Allows players to spawn to their own nation’s capital (/nation spawn).
towny.nation.spawn.ally	Allows players to spawn to allied nations.
towny.nation.spawn.public	Allows players to spawn to unaffiliated public nations.
towny.command.nation.*	Grants access to all /nation sub‑commands. The node towny.command.nation.default is automatically granted to everyone; it does not give any additional rights.
towny.command.nation.list	Lists nations by various criteria (/nation list by …) . Child nodes such as .residents, .towns, .open, .balance, .upkeep, .name, .townblocks, .online, .public and .founded order the nation list accordingly.
towny.command.nation.new	Create a new nation (/nation new {nationname}) .
towny.command.nation.leave	Leave your current nation (/nation leave) .
towny.command.nation.withdraw	Withdraw money from the nation bank (/nation withdraw {$}) .
towny.command.nation.deposit	Deposit money into the nation bank (/nation deposit {$}) .
towny.command.nation.deposit.other	Deposit money into a town bank that belongs to your nation (/nation deposit {$} {townname}) .
towny.command.nation.bankhistory	View the nation bank transaction history (/nation bankhistory {#}) .
towny.command.nation.baltop	Opens a book listing the richest players in your nation (/nation baltop) .
towny.command.nation.rank.*	Manage nation ranks (/nation rank {add|remove} {player} {rank}) .
towny.command.nation.king	Allows a player to become king or perform king‑only actions (/nation set king {resident}) .
towny.command.nation.othernation	View another nation’s status screen (/nation {nationname}).
towny.command.nation.sanctiontown	Manage the nation’s sanctioned towns list (/nation sanctiontown add/remove/list) .
towny.command.nation.say	Broadcast a message to nation members (/nation say {msg}) .
towny.command.nation.join	Join an open nation (/nation join {nation}) .
towny.command.nation.set.board	Set the nation’s message of the day (/nation set board {message}) .
towny.command.nation.set.spawncost	Set the cost of public spawns (/nation set spawncost) .
towny.command.nation.set.spawn	Set the nation spawn (/nation set spawn) .
towny.command.nation.set.king	Change the king of the nation (/nation set king {resident}) .
towny.command.nation.set.capital	Set the nation’s capital (/nation set capital {town}) .
towny.command.nation.set.taxes	Set the tax paid by member towns (/nation set taxes {$}) .
towny.command.nation.set.taxpercentcap	Set the maximum percentage that a town will pay when percentage‑based taxation is used (/nation set taxpercentcap {$}).
towny.command.nation.set.conqueredtax	Set the tax paid by conquered towns (/nation set conqueredtax {$}).
towny.command.nation.set.name	Rename the nation (/nation set name {name}) .
towny.command.nation.set.title	Give a title to a nation member (/nation set title {name} {title}) .
towny.command.nation.set.title.colours	Allows coloured titles when colour permissions are required.
towny.command.nation.set.surname	Give a suffix to a nation member (/nation set surname {name} {suffix}) .
towny.command.nation.set.tag	Set a short tag for the nation (/nation set tag {upto4character}) .
towny.command.nation.set.mapcolor	Sets the colour used on the dynmap to represent the nation (/nation set mapcolor {color}).
towny.command.nation.toggle.neutral	Toggle the nation’s neutral status during war (/nation toggle neutral).
towny.command.nation.toggle.open	Toggle whether towns can join without an invite (/nation toggle open).
towny.command.nation.toggle.public	Toggle whether the nation is public (/nation toggle public).
towny.command.nation.toggle.taxpercent	Toggle percentage‑based taxation (/nation toggle taxpercent).
towny.command.nation.invite.manage.*	Manage nation invites; includes adding towns, accepting and denying invites.
towny.command.nation.invite.sent	View sent nation invites.
towny.command.nation.invite.received	View received nation invites.
towny.command.nation.invite	View invite help page.
towny.command.nation.ally.manage.*	Manage ally invitations; includes adding allies, removing allies, accepting and denying ally requests.
towny.command.nation.ally.sent	View sent ally invites.
towny.command.nation.ally.received	View received ally invites.
towny.command.nation.ally	View ally help page.
towny.command.nation.enemy	Add a nation to your enemy list (/nation enemy add) or remove one (/nation enemy remove) .
towny.command.nation.delete	Delete your nation (/nation delete {nation}) .
towny.command.nation.online	Show players in your nation who are online (/nation online) .
towny.command.nation.add	Invite towns to your nation (/nation add {town}) .
towny.command.nation.kick	Remove a town from your nation (/nation kick {town}) .
towny.command.nation.spawn	Teleport to your nation spawn (/nation spawn) .
towny.command.nation.townlist	List the towns in your nation (/nation townlist) . Child nodes such as .allylist, .enemylist and .merge manage town lists.

/towny

Permission node	Description
towny.command.towny.*	Grants access to all /towny sub‑commands.
towny.command.towny.map	Show the Towny map in chat (/towny map) .
towny.command.towny.prices	Show taxes and costs associated with running a town (/towny prices) .
towny.command.towny.top.residents	Show top residents by wealth or balance (/towny top residents) .
towny.command.towny.top.land	Show top land owners (/towny top land) .
towny.command.towny.top.balance	Show towns or nations with the highest balances (/towny top balance) .
towny.command.towny.tree	Display a hierarchical overview of towns, nations and residents (/towny tree) .
towny.command.towny.time	Show time until next new day (tax/upkeep collection) (/towny time) .
towny.command.towny.universe	Show overall server statistics: counts of residents, towns, nations and claimed townblocks (/towny universe) .
towny.command.towny.version	Show the Towny version installed (/towny v) .
towny.command.towny.spy	Enable chat spy mode to see all chat channels (/towny spy) .

/townyworld

Townyworld nodes configure each world and are generally used by admins.

Permission node	Description
towny.command.townyworld.*	Grants access to all /townyworld sub‑commands.
towny.command.townyworld.list	List all worlds recognised by Towny (/townyworld list) .
towny.command.townyworld.set	Modify world settings (/townyworld set …) such as default PvP, explosion behaviour, mobs and more .
towny.command.townyworld.toggle.claimable	Toggle whether the world is claimable (/townyworld toggle claimable).
towny.command.townyworld.toggle.usingtowny	Enable or disable Towny in the world (/townyworld toggle usingtowny).
towny.command.townyworld.toggle.pvp	Toggle PvP for the world (/townyworld toggle pvp).
towny.command.townyworld.toggle.forcepvp	Force PvP on in the world (/townyworld toggle forcepvp).
towny.command.townyworld.toggle.explosion	Toggle explosions (/townyworld toggle explosion).
towny.command.townyworld.toggle.forceexplosion	Force explosions on (/townyworld toggle forceexplosion).
towny.command.townyworld.toggle.fire	Toggle firespread (/townyworld toggle fire).
towny.command.townyworld.toggle.forcefire	Force firespread on (/townyworld toggle forcefire).
towny.command.townyworld.toggle.friendlyfire	Toggle friendly fire in the world (/townyworld toggle friendlyfire).
towny.command.townyworld.toggle.jailing	Toggle whether jailing is allowed (/townyworld toggle jailing).
towny.command.townyworld.toggle.townmobs	Toggle hostile mob spawning in towns (/townyworld toggle townmobs).
towny.command.townyworld.toggle.worldmobs	Toggle hostile mob spawning in the world (/townyworld toggle worldmobs).
towny.command.townyworld.toggle.wildernessmobs	Toggle hostile mob spawning in the wilderness (/townyworld toggle wildernessmobs).
towny.command.townyworld.toggle.warallowed	Toggle whether war is allowed in the world (/townyworld toggle warallowed).
towny.command.townyworld.toggle.revertunclaim	Toggle plot block regeneration after unclaiming (/townyworld toggle revertunclaim).
towny.command.townyworld.toggle.revertentityexpl	Toggle entity explosion regeneration (/townyworld toggle revertentityexpl).
towny.command.townyworld.toggle.revertblockexpl	Toggle block explosion regeneration (/townyworld toggle revertblockexpl).
towny.command.townyworld.toggle.plotcleardelete	Toggle deletion of plot-clear blocks (/townyworld toggle plotcleardelete).
towny.command.townyworld.toggle.unclaimblockdelete	Toggle deletion of unclaimed blocks (/townyworld toggle unclaimblockdelete).
towny.command.townyworld.toggle.unclaimentitydelete	Toggle deletion of unclaimed entities (/townyworld toggle unclaimentitydelete).
towny.command.townyworld.toggle.wildernessuse	Toggle whether the wilderness can be used (/townyworld toggle wildernessuse).
towny.command.townyworld.regen	Regenerate the chunk you are standing in (/townyworld regen) .
towny.command.townyworld.undo	Undo a recent regeneration (/townyworld undo) .

TownyChat

These permissions are related to TownyChat.

Permission node	Description
towny.chat.general	Allows a player to chat in the global channel.
towny.chat.town	Allows a player to talk in town chat.
towny.chat.nation	Allows a player to talk in nation chat.
towny.chat.mod	Allows a player to talk in moderator chat.
towny.chat.admin	Allows a player to talk in admin chat.
towny.chat.local	Allows a player to talk in local chat.
towny.chat.spy	Allows a player to see all chat in all channels (/towny spy).
towny.chat.join.{channelname}	Allows a player to join a chat channel via /join {channelname}.
towny.chat.leave.{channelname}	Allows a player to leave a chat channel via /leave {channelname}.
townychat.mod.mute	Allows a moderator to mute another player in a channel (/chmute {channel} {player}).
townychat.mod.unmute	Allows a moderator to un‑mute another player in a channel (/chunmute {channel} {player}).
townychat.chat.color	Allows players to use colour codes in chat messages.
townychat.chat.format.*	Allows all chat formatting modifiers (bold, italics, magic, underline, strike).
townychat.chat.format.bold	Allows &l (bold) formatting.
townychat.chat.format.italic	Allows &o (italic) formatting.
townychat.chat.format.magic	Allows &k (magic) formatting.
townychat.chat.format.underlined	Allows &n (underline) formatting.
townychat.chat.format.strike	Allows &m (strike-through) formatting.
townychat.chat.format.reset	Allows use of &r to reset formatting.

Wilderness

Controles what players can do in the wilderness.

Permission node	Description
towny.wild.*	Grants full build/destroy/switch/item use rights in the wilderness. Without it players cannot modify blocks in unclaimed chunks.
towny.wild.build.*	Allows building in the wilderness.
towny.wild.destroy.*	Allows breaking blocks in the wilderness.
towny.wild.switch.*	Allows using switches (doors, buttons, levers) in the wilderness.
towny.wild.item_use.*	Allows using items in the wilderness.
towny.wild.build.{material}	Allows building with a specific material in the wilderness (e.g. towny.wild.build.dirt).
towny.wild.destroy.{material}	Allows breaking a specific material in the wilderness.
towny.wild.switch.{material}	Allows switching a specific material (e.g. opening iron doors) in the wilderness.
towny.wild.item_use.{material}	Allows using a specific item in the wilderness.

Miscellaneous

Permission node	Description
towny.outlaw.jailer	Required to send outlaws killed in your town to your jail. Assigned to mayors, assistants and sheriffs by default.
towny.tax_exempt	Exempts a player from paying taxes. Only works when assigned via the townyperms.yml file.
towny.bypass_death_costs	Prevents a player from paying death costs.
towny.bypass_bed_restriction	Allows a player to ignore bed‑use restrictions.
towny.receives-plot-notifications	Allows a player to see plot notifications; defaults to true.
towny.town.{townname}	Given automatically to players in a town. Useful for NPCs or scripts to check membership.
towny.nation.{nationname}	Given automatically to players in a nation. Useful for checking if a player belongs to a specific nation.
towny.townless	Automatically granted to players with no town.
towny.nationless	Automatically granted to players with no nation.
towny_maxplots.x	Info node used to limit the number of plots a player can own. Replace x with the maximum allowed. If set to –1 the player can own unlimited plots.
towny_extraplots.x	Info node used to add extra plots on top of the default limit.
towny_maxoutposts.x	Info node used to limit the number of outposts a player can claim.
towny_default_modes	Info node listing default chat modes and options a player joins with (e.g. map,townclaim,plotborder,global,local,town,nation,mod,admin). Used in the info section of permission plugins.

Info/Option/Meta

These nodes are not conventional permission nodes but meta‑values used by some permission plugins. They are added to the info: or options: section of a group. For example, towny_default_modes sets default chat channels on join, and towny_maxplots, towny_extraplots and towny_maxoutposts limit claims.

You can also create placeholder permission nodes using {townname} or {nationname}. For example, adding stargate.network.{townname} to the default Town section in townyperms.yml will assign a node like stargate.network.england to all online members of the town England. This allows NPCs or other plugins to check membership easily.