> For the complete documentation index, see [llms.txt](https://wiki.incredibleplugins.com/lands/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.incredibleplugins.com/lands/permissions-and-staff-tools/permissions.md). # Permissions ## Permissions Use a permission plugin such as LuckPerms to assign Lands permissions. Players with operator status usually have every permission, so test with real permission groups when possible. Limits such as max lands, chunks, members, and upkeep limits are configured in `player-limits.yml`. See the general limits guide for those. ## Command Permissions | Permission | Gives access to | | ----------------------- | ---------------------------------------- | | `lands.command.*` | All player `/lands` commands. | | `nations.command.*` | All player `/nations` commands. | | `wars.command.*` | All player `/wars` commands. | | `lands.admin.command.*` | All `/lands admin` commands. Staff only. | | `wars.admin.command.*` | All `/wars admin` commands. Staff only. | For the exact admin command list, see [Admin Commands](/lands/permissions-and-staff-tools/commands.md). For player command permission nodes, see [Player Commands](/lands/permissions-and-staff-tools/player-commands.md). ## Flag Permissions Flags have their own permission nodes. | Flag type | Permission format | Full list | | -------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------- | | Natural flag toggle permissions | `lands.setting.` | [Natural Flags](/lands/rules-flags-and-gameplay/natural-flags.md) | | Land role flag toggle permissions | `lands.role.setting.` | [Roles and Role Flags](/lands/rules-flags-and-gameplay/roles-and-their-flags.md) | | Land role flag bypass permissions | `lands.bypass.` | [Roles and Role Flags](/lands/rules-flags-and-gameplay/roles-and-their-flags.md) | | Protected wilderness role bypass permissions | `lands.bypass.wilderness.` | [Roles and Role Flags](/lands/rules-flags-and-gameplay/roles-and-their-flags.md) | | Nation role flag toggle permissions | `nations.setting.` | [Roles and Role Flags](/lands/rules-flags-and-gameplay/roles-and-their-flags.md) | | Nation role flag bypass permissions | `nations.bypass.` | [Roles and Role Flags](/lands/rules-flags-and-gameplay/roles-and-their-flags.md) | | Personal setting toggle permissions | `lands.player.setting.` | [Player Personal Settings](/lands/rules-flags-and-gameplay/player-personal-settings.md) | ## Teleport Permissions These permissions limit teleport actions started by Lands. They are set to `true` by default in `plugin.yml`. If you want to block one of them, set the permission to `false` in your permission plugin. Example with LuckPerms: `/lp group default permission set lands.teleport.sub_area false` | Permission | Allows | | -------------------------------- | ------------------------------------------------------ | | `lands.teleport.chunk` | Teleporting to claimed chunks from `/lands claimlist`. | | `lands.teleport.rentable` | Teleporting to rentable areas or areas for sale. | | `lands.teleport.land_spawn` | Teleporting to a land spawn. | | `lands.teleport.random_teleport` | Random teleporting with `/lands wild`. | | `lands.teleport.war` | Teleporting to a war spawn with `/wars spawn`. | | `lands.teleport.sub_area` | Teleporting to a sub area. | | `lands.teleport.unstuck` | Teleporting with `/lands unstuck`. | ## General Bypass Permissions | Permission | Allows | | ----------------------------------- | ------------------------------------------------------------- | | `lands.bypass.*` | All Lands bypass permissions. Staff only. | | `lands.bypass.selection` | Bypass other plugins cancelling a Lands selection. | | `lands.bypass.land_claim_border` | Bypass the configured claim distance to other lands. | | `lands.bypass.shape` | Bypass the configured claim shape restriction. | | `lands.bypass.encirclement` | Bypass encirclement prevention. | | `lands.bypass.member.untrust` | Untrust players or remove invites in other players' lands. | | `lands.bypass.spawn.private` | Teleport to private land spawns. | | `lands.bypass.expiration` | Bypass land expiration. Requires LuckPerms support. | | `lands.bypass.priority` | Ignore role priority checks when managing members or roles. | | `lands.bypass.wilderness.worldedit` | Use WorldEdit in worlds protected by wilderness restrictions. | ## Cooldown Bypass Permissions | Permission | Allows | | --------------------------------------- | ---------------------------------- | | `lands.bypass.cooldown.wild` | Bypass `/lands wild` cooldown. | | `lands.bypass.cooldown.rename_land` | Bypass `/lands rename` cooldown. | | `lands.bypass.cooldown.teleport` | Bypass chunk teleport cooldown. | | `lands.bypass.cooldown.spawn` | Bypass `/lands spawn` cooldown. | | `lands.bypass.cooldown.unstuck` | Bypass `/lands unstuck` cooldown. | | `nations.bypass.cooldown.rename_nation` | Bypass `/nations rename` cooldown. | ## War Bypass Permissions | Permission | Allows | | -------------------------- | --------------------------------------------- | | `lands.bypass.war.trust` | Trust players during war. | | `lands.bypass.war.claim` | Claim chunks during war. | | `lands.bypass.war.unclaim` | Unclaim chunks during war. | | `lands.bypass.cmd.war` | Bypass the command blacklist from `wars.yml`. | ## Command Blacklist Bypass Permissions | Permission | Allows | | -------------------------------------- | ---------------------------------------------------------------- | | `lands.bypass.cmd.untrusted.*` | Bypass the untrusted-player command blacklist from `config.yml`. | | `lands.bypass.cmd.untrusted.` | Bypass the untrusted-player blacklist for one command. | | `lands.bypass.cmd.general.*` | Bypass the general command blacklist from `config.yml`. | | `lands.bypass.cmd.general.` | Bypass the general blacklist for one command. | Replace `` with the command name without `/`. ## Teleport Bypass Permissions | Permission | Allows | | ----------------------------- | ------------------------------------------------- | | `lands.bypass.teleport.delay` | Skip teleport delay. | | `lands.bypass.teleport.cmd` | Execute commands while waiting for teleportation. | ## Non-command Admin Permissions | Permission | Allows | | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `lands.admin.*` | All Lands admin actions. Staff only. | | `lands.admin.disabled-features` | Use some features that are disabled for regular players, such as claiming in disabled worlds or setting rental areas while rent is disabled. | | `lands.admin.command.edit` | Edit other lands through `/lands edit ` and admin command contexts. | | `lands.admin.land_delete` | Delete other players' lands or unclaim chunks from them. | | `lands.admin.land_setowner` | Use `/lands setowner` for lands the player does not own. | | `lands.admin.setting_edit_land` | Edit natural flags of other players' lands. | | `lands.admin.setting_edit_role` | Edit role flags of other players' lands. | | `lands.admin.setting_edit_taxes` | Edit tax settings of other players' lands. | | `lands.admin.sign.top` | Create and edit leaderboard signs. | | `nations.admin.nation_edit` | Edit other players' nations from the `/lands edit ` context. | | `nations.command.menu.others` | Open the menu of a specific nation with `/nations menu `. | ## Wildcard Groups Wildcard groups are useful for staff, but use them carefully. | Permission | Gives | | ----------- | ----------------------------------------------------------------- | | `lands.*` | All Lands permissions listed under the Lands permission tree. | | `nations.*` | All Nations permissions listed under the Nations permission tree. | | `wars.*` | All Wars permissions listed under the Wars permission tree. |