Default Townyperms.yml - TownyAdvanced/Towny GitHub Wiki
#############################################################################################
# This file contains custom permission sets which will be assigned to your players #
# depending on their current status. This file uses YAML formatting. Do not include tabs #
# and be very careful to align the spacing preceding the - symbols. Improperly editing this #
# file will prevent Towny from loading correctly. #
# #
# This is all managed by towny and pushed directly to CraftBukkit's SuperPerms. #
# These will be give in addition to any you manually assign in your specific permission #
# plugin. Note: You do not need to assign any Towny permission nodes to your players in #
# your server's permission plugin, ie: LuckPerms. #
# #
# You may assign any Permission nodes here, including those from other plugins. #
# #
# You may also create any custom ranks you require. Creating ranks can be done using the #
# /ta townyperms townrank addrank [name] or by carefully editing this file. #
# You can add permission to a rank/group using the #
# /ta townyperms group [name] addperm [node] command. #
# #
# You may change the names of any of the ranks except: nomad, default, mayor, king, ranks, #
# peaceful. #
# #
# If you want to, you can negate permissions nodes from nodes by doing the following: #
# Ex: #
# - towny.command.plot.* #
# - -towny.command.plot.set.jail #
# In this example the user is given full rights to all of the /plot command nodes, #
# but has had their ability to set a plot to a Jail plot type disabled. #
# #
# The towns.ranks and nations.ranks sections support adding prefix and priorities, this #
# is done using two nodes: towny.rankpriority.# and towny.rankprefix.<prefix_here>. #
# Residents will have their ranks parsed until one rank is determined to be the highest #
# priority, this rank will then be searched for a prefix node. This prefix can be shown #
# using the %townyadvanced_resident_primary_rank% placeholder for PlaceholderAPI. A prefix #
# from a Nation rank will take precendence over a prefix from a Town rank. #
# Ex: #
# - towny.rankpriority.100 #
# - towny.rankprefix.&a<&2Sheriff&a> #
# #
#############################################################################################
# The 'nomad' permissions are given to all players in all Towny worlds, townless and players who are part of a town.
nomad:
- towny.command.towny.map
- towny.command.towny.prices
- towny.command.towny.tree
- towny.command.towny.time
- towny.command.towny.universe
- towny.command.towny.version
- towny.command.towny.war
- towny.command.town.online
- towny.command.town.here
- towny.command.town.new
- towny.command.town.join
- towny.command.town.list.*
- towny.command.town.ranklist
- towny.command.town.reslist
- towny.command.resident.friend
- towny.command.plot.group.*
- towny.command.plot.perm
- towny.command.plot.perm.hud
- towny.command.plot.trust
- towny.command.nation.list.*
- towny.command.nation.townlist
- towny.command.nation.allylist
- towny.command.nation.enemylist
- towny.command.nation.ranklist
- towny.town.resident
- towny.town.spawn.public
- towny.chat.general
- towny.command.towny.war.hud
- towny.command.resident.set.about
- towny.command.resident.jail
- towny.command.resident.outlawlist
# This section of permissions covers players who are members of a town.
towns:
# 'default' is the permission set which is auto assigned to any normal town member.
default:
- towny.command.resident.*
- towny.command.plot.claim
- towny.command.plot.unclaim
- towny.command.plot.forsale
- towny.command.plot.notforsale
- towny.command.plot.toggle.*
- towny.command.plot.set.perm
- towny.command.plot.set.reset
- towny.command.town.online
- towny.command.town.leave
- towny.command.town.deposit
- towny.command.town.reclaim
- towny.town.spawn.town
- towny.chat.town
# Mayors get these permissions in addition to the default set.
mayor:
- towny.tax_exempt
- towny.command.towny.top
- towny.command.town.*
- towny.command.plot.*
- towny.claimed.owntown.*
- towny.command.nation.new
- towny.outlaw.jailer
- towny.command.nation.join
- towny.command.nation.leave
# Ranks contain additional permissions residents will be
# granted if they are assigned that specific rank.
ranks:
# assistants are able to grant VIP and helper rank.
assistant:
- towny.tax_exempt
- towny.command.town.claim.*
- towny.command.town.invite.add
- towny.command.plot.*
- towny.command.town.toggle.public
- towny.claimed.owntown.switch.*
- towny.command.town.rank.vip
- towny.command.town.rank.helper
- towny.outlaw.jailer
helper:
- towny.claimed.townowned.switch.*
# Currently only an example rank holder with no extra permissions.
donator:
- foo.bar
# Currently only an example rank holder with no extra permissions.
vip:
- foo.bar
# Sheriff rank is able to jail other town members.
sheriff:
- towny.command.town.jail
- towny.command.town.unjail
- towny.command.town.jail.list
- towny.outlaw.jailer
# This section of permissions covers players who are members of any town in a nation.
nations:
# All nation members get these permissions.
default:
- towny.command.nation.online
- towny.command.nation.deposit
- towny.command.nation.spawn
- towny.nation.spawn.nation
- towny.nation.spawn.ally
- towny.town.spawn.nation
- towny.town.spawn.ally
- towny.chat.nation
- towny.chat.alliance
# Kings get these permissions in addition to the default set.
king:
- towny.command.nation.*
- towny.command.nation.deposit.other
ranks:
assistant:
- towny.command.nation.rank.helper
- towny.command.nation.invite.add
- towny.command.nation.ally.*
- towny.command.nation.enemy
- towny.command.nation.deposit.other
helper:
- towny.command.nation.add