Commands Reference

All commands use the /ksitem prefix. Aliases: itemcontrol, ic.

General

Command	Description	Permission
/ksitem admin	Open the admin hub UI	kyuubisoft.itemcontrol.admin
/ksitem reload	Reload config, localization, and item registry	kyuubisoft.itemcontrol.admin

Item Browser

Command	Description	Permission
/ksitem browse	Open the item browser (search, filter, recipes, drops)	All players
/ksitem info <itemId>	Open the detail view for a specific item	All players
/ksitem compare <item1> <item2>	Compare two items side by side	All players

Module Management

Command	Description	Permission
/ksitem module list	Show all modules and their status	kyuubisoft.itemcontrol.admin
/ksitem module enable <id>	Enable a module	kyuubisoft.itemcontrol.admin
/ksitem module disable <id>	Disable a module	kyuubisoft.itemcontrol.admin

Give

Command	Description	Permission
/ksitem give <itemId> [amount]	Give an item to yourself	kyuubisoft.itemcontrol.give

Crafting Rules

Command	Description	Permission
/ksitem craft list	Show blocked items	kyuubisoft.itemcontrol.admin
/ksitem craft add <itemId>	Block an item from being crafted	kyuubisoft.itemcontrol.admin
/ksitem craft remove <itemId>	Unblock an item	kyuubisoft.itemcontrol.admin

Death Rules

Command	Description	Permission
/ksitem death list	Show protected items and current mode	kyuubisoft.itemcontrol.admin
/ksitem death add <itemId>	Protect an item on death	kyuubisoft.itemcontrol.admin
/ksitem death remove <itemId>	Remove protection	kyuubisoft.itemcontrol.admin
/ksitem death mode <mode>	Set default death mode (vanilla, keep-all, selective)	kyuubisoft.itemcontrol.admin

Usage Restrictions

Command	Description	Permission
/ksitem restrict list	Show all restrictions	kyuubisoft.itemcontrol.admin
/ksitem restrict add <itemId> [permission]	Restrict an item (optionally require a permission)	kyuubisoft.itemcontrol.admin
/ksitem restrict remove <itemId>	Remove restriction	kyuubisoft.itemcontrol.admin

Soulbound

Command	Description	Permission
/soulbound	Check if held item is soulbound	All players
/ksitem soulbound bind <itemId>	Bind held item to yourself	kyuubisoft.itemcontrol.admin
/ksitem soulbound unbind <itemId>	Unbind held item	kyuubisoft.itemcontrol.admin
/ksitem soulbound check	List your bound items	kyuubisoft.itemcontrol.admin
/ksitem soulbound autobind add <itemId>	Auto-bind item for all players on pickup	kyuubisoft.itemcontrol.admin
/ksitem soulbound autobind remove <itemId>	Remove auto-bind	kyuubisoft.itemcontrol.admin

Cooldowns

Command	Description	Permission
/ksitem cooldown set <itemId> <seconds>	Set a cooldown	kyuubisoft.itemcontrol.admin
/ksitem cooldown remove <itemId>	Remove a cooldown	kyuubisoft.itemcontrol.admin
/ksitem cooldown list	List all cooldowns	kyuubisoft.itemcontrol.admin
/ksitem cooldown check <itemId>	Check your own cooldown	All players

Watchlist

Command	Description	Permission
/ksitem watch list	Show watched items	kyuubisoft.itemcontrol.admin
/ksitem watch add <itemId>	Add item to watchlist	kyuubisoft.itemcontrol.admin
/ksitem watch remove <itemId>	Remove from watchlist	kyuubisoft.itemcontrol.admin
/ksitem watch alerts	Show last 20 alerts	kyuubisoft.itemcontrol.admin

Inventory Tools

Command	Description	Permission
/ksitem inv view [player]	View a player's inventory	kyuubisoft.itemcontrol.inventory
/ksitem inv snapshot <name>	Save an inventory snapshot	kyuubisoft.itemcontrol.inventory
/ksitem inv restore	Restore the latest snapshot	kyuubisoft.itemcontrol.inventory
/ksitem inv wipe <itemId>	Remove an item from all online inventories	kyuubisoft.itemcontrol.inventory
/ksitem inv clear [player]	Clear an inventory	kyuubisoft.itemcontrol.inventory
/ksitem inv history [player]	View inventory backup history	kyuubisoft.itemcontrol.inventory

Drop Rules

Command	Description	Permission
/ksitem drops add <npcRole> <itemId> <min> <max> <chance> [mode]	Add a drop rule	kyuubisoft.itemcontrol.admin
/ksitem drops remove <npcRole> <itemId>	Remove a drop rule	kyuubisoft.itemcontrol.admin
/ksitem drops list [npcRole]	Show drop rules	kyuubisoft.itemcontrol.admin
/ksitem drops listroles	Show configured NPC roles	kyuubisoft.itemcontrol.admin
/ksitem drops reload	Reload drop rules from file	kyuubisoft.itemcontrol.admin

Temporary Rules

Command	Description	Permission
/ksitem temprule list	Show all temporary rules	kyuubisoft.itemcontrol.admin
/ksitem temprule add <id> <type> <itemId> <minutes>	Create a rule	kyuubisoft.itemcontrol.admin
/ksitem temprule remove <id>	Delete a rule	kyuubisoft.itemcontrol.admin
/ksitem temprule info <id>	Show rule details	kyuubisoft.itemcontrol.admin

Temp Rule Types: crafting-block, crafting-unlock, usage-block

Item Overrides

Command	Description	Permission
/ksitem override set <itemId> <field> <value>	Override a field	kyuubisoft.itemcontrol.admin
/ksitem override get <itemId> [field]	View overrides	kyuubisoft.itemcontrol.admin
/ksitem override reset <itemId> [field]	Reset override(s)	kyuubisoft.itemcontrol.admin
/ksitem override list	Show all overridden items	kyuubisoft.itemcontrol.admin

Override Fields:

Field	Description
maxDurability	Maximum durability
durabilityLossOnHit	Durability lost per hit
maxStack	Maximum stack size
qualityId	Item quality/rarity
consumable	Whether item is consumable
dropOnDeath	Whether item drops on death
durabilityLossOnDeath	Durability lost on death
toolSpeed	Tool mining speed
armorResistance	Armor resistance value
craftingTier	Required crafting tier
craftingOutputQty	Crafting output quantity
weaponDamage	Weapon damage (proportional scaling)
weaponDamage.<Type>	Per-damage-type override (e.g. weaponDamage.Physical)
signatureMove	Swap signature ability
weaponStat.<StatName>	Weapon stat modifier
interaction.<idx>.<field>	Per-interaction override
armor.baseDamageResistance	Base armor resistance
armor.resistance.<type>	Per-type armor resistance
armor.enhancement.<type>	Per-type armor enhancement
armor.stat.<stat>	Armor stat modifier
armor.classEnh.<class>	Attack class enhancement