Permissions

Item Control uses a minimal set of permission nodes. Most features are gated behind a single admin permission, with dedicated nodes for specific capabilities.

Permission Nodes

Permission	Description	Used By
kyuubisoft.itemcontrol.admin	Full admin access -- all admin commands, module management, Admin Hub UI, command block editing, and all rule management commands	/ksitem admin, /ksitem reload, /ksitem module, /ksitem craft, /ksitem death, /ksitem restrict, /ksitem soulbound, /ksitem cooldown set/remove/list, /ksitem watch, /ksitem drops, /ksitem temprule, /ksitem override, /ksitem cmdblock
kyuubisoft.itemcontrol.give	Give items to yourself and access the "Give" button in the Item Browser detail view	/ksitem give, Item Browser "Give Item" button
kyuubisoft.itemcontrol.inventory	Inventory management -- view, snapshot, restore, wipe, clear, and history	/ksitem inv (all subcommands)
kyuubisoft.itemcontrol.craft.bypass	Bypass crafting restrictions (blacklist/whitelist)	Automatic -- checked when a player attempts to craft a restricted item
kyuubisoft.itemcontrol.watchlist.notify	Receive real-time watchlist alert notifications in chat	Automatic -- admins with this permission see alerts when a watched item is crafted, picked up, or dropped

Commands Requiring No Permission

The following commands and features are available to all players without any permission:

Command / Feature	Description
/ksitem browse	Open the item browser
/ksitem compare <item1> <item2>	Compare two items side by side
/soulbound	Check soulbound info of the currently held item
/ksitem cooldown check <itemId>	Check your own remaining cooldown for an item

Per-Item Permissions (Dynamic)

Some modules support dynamic per-item permissions that you define in configuration:

Usage Restrictions

When you add a usage restriction with a permission, only players who have that specific permission can use the item:

/ksitem restrict add Weapon_Legendary_Sword vip.legendary_weapons

Players without vip.legendary_weapons will be blocked from equipping the item.

Crafting Bypass

The crafting bypass permission is configurable in config.json:

{
  "crafting-rules": {
    "bypassPermission": "kyuubisoft.itemcontrol.craft.bypass"
  }
}

Players with this permission can craft items that are on the blacklist.

Custom Recipe Permissions

Custom recipes can optionally require a permission. When set, only players with that permission will see and be able to craft the recipe. This is configured per-recipe in the Custom Recipe Editor UI.

Death Rules - Permission-Based

Death rules support permission-based overrides. Rules are evaluated in order -- the first matching permission applies:

{
  "death-rules": {
    "permissionRules": [
      { "permission": "vip.keepitems", "mode": "keep-all" },
      { "permission": "vip.basic", "lossPercentage": 25 }
    ]
  }
}

Command Block Protection

Blocks marked as indestructible via the Command Block system can only be broken by players with kyuubisoft.itemcontrol.admin.

Permission Hierarchy

kyuubisoft.itemcontrol.admin
  +-- Module management (enable/disable)
  +-- Config reload
  +-- Admin Hub UI
  +-- All rule management (crafting, death, usage, soulbound, cooldowns, watchlist, drops, temp rules, overrides)
  +-- Command block editing
  +-- Indestructible block protection bypass

kyuubisoft.itemcontrol.give
  +-- /ksitem give command
  +-- "Give Item" button in Item Browser

kyuubisoft.itemcontrol.inventory
  +-- View any player's inventory
  +-- Create/restore snapshots
  +-- Wipe items from all players
  +-- Clear inventories
  +-- Browse backup history

kyuubisoft.itemcontrol.craft.bypass
  +-- Bypass crafting blacklist/whitelist

kyuubisoft.itemcontrol.watchlist.notify
  +-- Receive real-time watchlist alerts

tip

The admin permission does not automatically grant give, inventory, or craft.bypass. These are separate nodes that must be granted independently. This allows you to give staff members admin panel access without granting them the ability to give items or bypass crafting rules.