Commands

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 compare <item1> <item2>`	Compare two items side by side	All players

:::tip Item Details To view detailed properties of a specific item, open the browser with /ksitem browse and click any item in the grid. There is no standalone info command — the detail view is part of the browser UI with tabs for Info, Recipes, and Drops. :::

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 soulbound info of the currently held item (standalone command)	All players
`/ksitem soulbound bind`	Bind the held item to yourself (stamps metadata on the item)	`kyuubisoft.itemcontrol.admin`
`/ksitem soulbound unbind`	Remove soulbound from the held item	`kyuubisoft.itemcontrol.admin`
`/ksitem soulbound check`	Show soulbound details of the held item (owner, UUID, bind time)	`kyuubisoft.itemcontrol.admin`
`/ksitem soulbound autobind add <itemId>`	Add item to auto-soulbound list (binds on pickup for all players)	`kyuubisoft.itemcontrol.admin`
`/ksitem soulbound autobind remove <itemId>`	Remove item from auto-soulbound list	`kyuubisoft.itemcontrol.admin`
`/ksitem soulbound autobind list`	Show all auto-soulbound items	`kyuubisoft.itemcontrol.admin`
`/ksitem soulbound recover`	Recover lost soulbound items from the recovery system	`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:

The following fields can be used with /ksitem override set:

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 across all types)
`weaponDamage.<Type>`	Per-damage-type override (e.g. `weaponDamage.Physical`)
`signatureMove`	Swap signature ability to another weapon’s signature
`weaponStat.<StatName>`	Weapon stat modifier (e.g. `weaponStat.SignatureEnergy`)
`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 (LIGHT, CHARGED, SIGNATURE)

Command Blocks

Command	Description	Permission
`/ksitem cmdblock`	Toggle command block edit mode	`kyuubisoft.itemcontrol.admin`

In edit mode, hit any block to open the Command Block Editor UI. Alias: /ksitem cb