Skip to content

Permissions

All KyuubiSoft mods use a consistent permission system. Player commands are allowed by default — you only need to configure permissions if you want to restrict access for specific groups.

Admin commands are blocked by default and must be explicitly granted.

:::tip Compatible with LuckPerms & HyperPerms All permission nodes are automatically registered on first player join and immediately visible in your permission plugin. Use your permission plugin to deny specific nodes for groups.

Example (LuckPerms): /lp group default permission set ks.bank.user.upgrade false Example (HyperPerms): /hp group setperm default ks.bank.user.upgrade false :::


TypeMethodDefaultDescription
PlayerhasPermission(node, true)AllowedEveryone can use it. Set to false to block.
AdminrequirePermission(node)BlockedMust be explicitly granted to use.

PermissionTypeCommandDescription
ks.core.user.settingsPlayer/kssettingsKS settings window
ks.itemupdate.user.usePlayer/ksitemupdateItem update window
ks.core.shop.user.usePlayer/ksnpcshop open/sell/listCore NPC shops; decides when an admin set it
ks.shop.user.usePlayer/ksnpcshop open/sell/listCore NPC shops while ks.core.shop.user.use is not set
ks.citizen.user.repairPlayer/kscitizen repairItem repair window
ks.adminAdmin/ksadmin, /ksadmin reload, testsoundAdmin hub, NPC shop editor; also accepted for NPC tools
ks.admin.cleanupAdmin/ksadmin cleanup nametagsPlus kyuubisoft.admin in game
ks.admin.migrateAdmin/ksadmin migrate-storagePlus kyuubisoft.admin in game
ks.admin.xpAdmin/ksadmin addxp/removexpPlus kyuubisoft.admin in game
ks.admin.editorAdmin/kseditor, /kstrusteditor, /ksapplyconfigWeb editor; plus kyuubisoft.editor in game
ks.admin.devAdmin/ksdevDeveloper tools; plus dev.admin in game
ks.citizenAdmin/kscitizenOnly the bare usage list
ks.citizen.adminAdmin/kscitizen subcommandsNPC management, skin editor, NPC viewer, dialog editor (ks.admin or the old citizen.admin work too)
ks.core.admin.dialog.consoleAdminNPC, dialog and shop editors, web editor importsAdd, change or remove anything that runs as the server console

PermissionTypeCommandDescription
ks.bank.user.openPlayer/ksbank, /ksbank openOpen your bank
ks.bank.user.pagePlayer/ksbank page <nr>Switch bank page
ks.bank.user.upgradePlayer/ksbank upgradeUnlock next page
ks.bank.user.historyPlayer/ksbank historyView transaction history
ks.bank.adminAdmin/ksbank give/reset/log/reload/adminBank administration

PermissionTypeCommandDescription
ks.item.user.browsePlayer/ksitem browseBrowse items
ks.item.user.comparePlayer/ksitem compareCompare items
ks.item.user.soulboundPlayer/soulboundView soulbound info of your held item
ks.item.adminAdmin/ksitem admin/reload/module/...Item Control administration, together with kyuubisoft.itemcontrol.admin (/ksitem inv: kyuubisoft.itemcontrol.inventory)
ks.item.admin.clearslotAdminClear, Clear slot, /ksitem inv clearClear a whole inventory or a single slot. Not part of ks.item.admin, but part of ks.item.admin.*
ks.item.admin.removeallAdmin/ksitem inv wipe, Remove item from everyoneRemove an item from everyone online. Not part of ks.item.admin, but part of ks.item.admin.*
ks.item.giveAdmin/ksitem giveGive items to yourself, together with kyuubisoft.itemcontrol.give. Give Item in the Item Browser needs both, and the admin-give module

PermissionTypeCommandDescription
ks.pet.user.usePlayer/kspetOpen pet menu
ks.pet.user.combatPlayer/kscombatpetCombat pet commands
ks.pet.user.mountPlayer/ksmountMount commands
ks.pet.adminAdmin/kspetadminPet administration

PermissionTypeCommandDescription
ks.quest.user.usePlayer/ksquestOpen quest book
ks.quest.user.settingsPlayer/ksquestsettingsQuest HUD settings
ks.quest.adminAdmin/ksquestadminQuest administration and the Quests admin window

PermissionTypeCommandDescription
ks.achievements.user.usePlayer/ksachievementsView achievements
ks.achievements.user.titlesPlayer/kstitlesManage titles
ks.achievements.user.rewardsPlayer/ksrewardsClaim rewards
ks.achievements.adminAdmin/ksachievementadminAchievement administration and the admin window

PermissionTypeCommandDescription
ks.seasonpass.user.usePlayer/ksseasonpassOpen season pass
ks.seasonpass.adminAdmin/ksseasonpassadminSeason pass administration

Every /ksclaim subcommand has its own player node, allowed by default. What a player may do inside a claim comes from their role there, not from a node.

PermissionTypeCommandDescription
ks.claims.user.<action>Player/ksclaim and its subcommandsOne node per action (open, claim, trust, home, border, …); set one to false to take that command away
ks.claims.adminAdmin/ksclaimadminClaims administration and the admin window
ks.claims.admin.bypassAdmin–Ignores the protection of every claim and server zone
ks.claims.chunks.<n>, ks.claims.claims.<n>Player–Quota tiers, not granted by default; .unlimited removes the limit

See Claims permissions.


VoiceHub’s player commands have no permission nodes; every player may use them.

PermissionTypeCommandDescription
kyuubisoft.voicehub.adminAdmin/ksvoice admin, /ksvoice proximityVoiceHub administration (node name configurable)
kyuubisoft.voicehub.createPlayer/ksvoice createOnly checked when allowPlayerCreatedChannels is false

See VoiceHub permissions.


PermissionTypeCommandDescription
ks.graveyard.user.usePlayer/ksgraveyard menu/list/locateGravestone management
ks.graveyard.adminAdmin/ksgraveyard admin_list/admin_clear/admin_remove/admin_tp/admin_stats, designs, particles, reloadGraveyard administration

PermissionTypeCommandDescription
ks.info.user.usePlayerSection pages, info commandsAccess info pages
ks.info.adminAdmin/ksinfoadminInfo Hub administration and admin window (the old infohub.admin still works)

PermissionTypeCommandDescription
ks.lootbag.user.usePlayer/kslootbagsOpen lootbags
ks.lootbag.adminAdmin/kslootbagsadminLootbag administration

PermissionTypeCommandDescription
ks.shop.user.browsePlayer/ksshopBrowse player shops
ks.shop.user.createPlayer/ksshopCreate your own shop
ks.shop.user.editPlayer/ksshop editEdit your own shop
ks.shop.user.collectPlayer/ksshopCollect sold items and coins
ks.shop.user.deletePlayer/ksshopDelete your own shop
ks.shop.user.ratePlayer/ksshop rateRate shops
ks.rental.rent, ks.rental.bidPlayerRental stationsRent shops, bid on rentals
ks.shop.adminAdmin/ksshopadminShop administration (ks.admin alone is not enough)

See Player Shops permissions for listing perks and limits.


PermissionTypeCommandDescription
ks.nameplate.user.usePlayer/ksnameplateManage your nameplate
ks.nameplate.adminAdmin/ksnameplate adminNameplate administration, together with kyuubisoft.nameplates.admin (configurable)

PermissionTypeCommandDescription
ks.chat.user.usePlayer/kschatChat settings
ks.chat.user.msgPlayer/msg, /r, /ignore, /ksmailPrivate messaging
ks.chat.user.rpPlayer/me, /do, /ooc, /whisper, /shoutRoleplay commands
ks.chat.adminAdmin/kschatadminChat administration

PermissionTypeCommandDescription
ks.mastery.user.usePlayer/ksmasteryView weapon mastery
ks.mastery.adminAdmin/ksmasteryadminMastery administration

PermissionTypeCommandDescription
ks.dungeon.user.usePlayer/ksdungeon open/play/leave/partyDungeon access
ks.dungeon.user.map.usePlayer/ksdungeon maps/mapinfo, using mapsDungeon maps
ks.dungeon.user.stone.usePlayerUsing dungeon stonesDungeon stones
ks.dungeons.adminAdmin/ksdungeon givemap/givestone/testmap/browseprefabsDungeon administration

PermissionTypeCommandDescription
ks.showcase.user.usePlayer/ksshowcaseShowcase features
ks.showcase.adminAdmin/ksshowcase savepackSave into an asset pack

PermissionTypeCommandDescription
ks.mobcontrol.adminAdmin/ksmobcontrolMob control administration
ks.oreregen.adminAdmin/ksoreregenOre regeneration administration

The /kslang command has no permission requirement — it is always accessible to all players.


:::info Automatic Registration All player permission nodes are automatically registered when the first player joins the server. You don’t need to create them manually — they will appear in your permission plugin immediately. :::

To deny a specific permission for a group:

/lp group default permission set ks.bank.user.upgrade false

To grant an admin permission:

/lp group admin permission set ks.bank.admin true

To deny a specific permission for a group:

/hp group setperm default ks.bank.user.upgrade false

To grant an admin permission:

/hp group setperm admin ks.bank.admin true

Or use the visual editor:

/hp editor