Permissions - Rumsfield/konquest GitHub Wiki

Updated for version 1.5.0

Konquest Permissions

The plugin includes permission nodes which can be used with any permissions plugin, however there are special integrations with the LuckPerms permissions plugin. All permissions are granted to OPs by default. Normal players must be given the specific nodes you want them to have.

Each permission node has a default access, which says who has the permission without actually assigning the node to a group:

Access Type Description
OP Only server operators have access
Default All players have access
None No players have access

Typical Permissions Setup

It is recommended to set up permissions groups with the individual nodes that you want the group to have access to. Below are some examples.

All Commands

Give an admin group permission to use all commands and admin sub-commands:

konquest.command.* true
konquest.admin.* true

Restricted Commands

Give a default player group permission for most commands, except admin and fly. To revoke admin commands, set konquest.admin.* to false.

konquest.command.* true
konquest.command.fly false
konquest.admin.* false

Specific Commands

Give a unique player group access to only some specific commands.

konquest.command.* false
konquest.command.help true
konquest.command.info true
konquest.command.list true
konquest.command.map true
konquest.command.travel true
konquest.command.favor true

Top-Level Permissions

Node Description Default Access
konquest.* Gives access to all Konquest permissions OP
konquest.command Gives access to the base "/k" command Default
konquest.command.* Gives access to all regular Konquest commands OP
konquest.create.* Gives access to creating all territories Default
konquest.admin.* Gives access to all admin sub-commands OP
konquest.directive.* Gives access to all Konquest directives Default
konquest.compass Compass points to nearest enemy town Default
konquest.join.<kingdom> Allows players to join <kingdom>, when core.yml option core.kingdoms.per_kingdom_join_permissions is true. For example, to join the kingdom Rome, players would need permission "konquest.join.rome". OP
konquest.discount.<X> Applies a X% discount to all Favor withdraws, 0 < X < 100 None
konquest.prefix.<label> Grants access to a custom prefix, as defined by labels in prefix.yml None
konquest.chatcolor Allows players to use color format codes in chat messages None

Command Permissions

Node Description Default Access
konquest.command.border Toggle particle borders of territories and plots Default
konquest.command.chat Switch between global and Kingdom-only chat Default
konquest.command.claim Claim land for an adjacent town Default
konquest.command.favor Display your favor and costs Default
konquest.command.fly Fly in friendly territory OP
konquest.command.help Display help in chat Default
konquest.command.info Display info on a kingdom, town or player Default
konquest.command.kingdom Join, create or manage a kingdom Default
konquest.command.list Display a list of territories Default
konquest.command.map Display a map of surrounding land in chat Default
konquest.command.prefix Choose a prefix for your name in chat Default
konquest.command.quest Display the quest book Default
konquest.command.score Display a kingdom's score Default
konquest.command.settle Settle a new town Default
konquest.command.spy Purchase a map centered on an enemy town Default
konquest.command.stats Display the stats book Default
konquest.command.town Manage a town Default
konquest.command.travel Travel to a friendly town Default
konquest.command.unclaim Unclaim land for a town Default

Create Permissions

Node Description Default Access
konquest.create.camp Create barbarian camps Default
konquest.create.town Create towns as a kingdom member Default
konquest.create.kingdom Create new kingdoms Default

Admin Sub-Command Permissions

Node Description Default Access
konquest.admin.bypass Toggle admin bypass mode OP
konquest.admin.camp Manage player Barbarian camps OP
konquest.admin.capture Force a town to be captured by another Kingdom OP
konquest.admin.claim Claim land chunks OP
konquest.admin.flag Set kingdom flags OP
konquest.admin.help Display the admin help message OP
konquest.admin.kingdom Manage player and server Kingdoms OP
konquest.admin.monument Creates, removes or shows the Monument Template for a Kingdom OP
konquest.admin.reload Reloads configuration files OP
konquest.admin.ruin Manage a Ruin territory OP
konquest.admin.sanctuary Manage a Sanctuary territory OP
konquest.admin.save Saves Kingdoms and Players data files OP
konquest.admin.settravel Sets the travel point for the territory you're in OP
konquest.admin.stat Manage player stats OP
konquest.admin.town Manage Towns OP
konquest.admin.travel Teleport to the specified kingdom or town OP
konquest.admin.unclaim Return a chunk to the Wild OP

Directive Permissions

Node Description Default Access
konquest.directive.attack Receive a reward for attacking an enemy town, from core.yml core.rewards.attack_town Default
konquest.directive.armor Receive a reward for crafting a set of iron armor, from core.yml core.rewards.craft_armor Default
konquest.directive.build Receive a reward for building structures in a town, from core.yml core.rewards.build_town Default
konquest.directive.capture Receive a reward for capturing an enemy town, from core.yml core.rewards.capture_town Default
konquest.directive.claim Receive a reward for claiming your first 5 chunks, from core.yml core.rewards.claim_land Default
konquest.directive.enchant Receive a reward for enchanting tools and weapons, from core.yml core.rewards.enchant_item Default
konquest.directive.golem Receive a reward for creating an iron golem in a town, from core.yml core.rewards.create_golem Default
konquest.directive.kill Receive a reward for killing an enemy player, from core.yml core.rewards.kill_enemy Default
konquest.directive.kingdom Receive a reward for creating your first kingdom, from core.yml core.rewards.create_kingdom Default
konquest.directive.settle Receive a reward for settling your first town, from core.yml core.rewards.settle_town Default
⚠️ **GitHub.com Fallback** ⚠️