Skip to content

Commands

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

Admin in the tables below means ks.item.admin and kyuubisoft.itemcontrol.admin. Staff need both nodes; see Permissions.

Almost everything here is also in the Admin Hub. Some things are only there: cooldown categories and groups, temporary rules that start later or announce themselves, and clearing a single slot.

CommandDescriptionPermission
/ksitem adminOpen the Admin HubAdmin
/ksitem reloadReload config.json, languages and the item listAdmin

/ksitem reload does not start or stop modules, and it does not read the data files of the other modules again. See Configuration.

With KyuubiSoft Core installed, the Admin Hub can also be opened from the Item Control tile in the /ksadmin hub. That needs the same rights as /ksitem admin, and ks.admin for Core’s hub.

CommandDescriptionPermission
/ksitem browseOpen the Item Browser (search, filter, recipes, drops)ks.item.user.browse (everyone by default)
/ksitem compare <item1> <item2>Compare two items side by side; a green value on the right is higher than on the left, a red one is lowerks.item.user.compare (everyone by default)
CommandDescriptionPermission
/ksitem module listShow all modules, marked [ON] / [OFF]Admin
/ksitem module enable <id>Enable a moduleAdmin
/ksitem module disable <id>Disable a moduleAdmin
CommandDescriptionPermission
/ksitem give <itemId> [--amount=<n>]Give an item to yourself, one by defaultks.item.give + kyuubisoft.itemcontrol.give

The amount is a named argument: /ksitem give Weapon_Sword_Iron --amount=5.

CommandDescriptionPermission
/ksitem craft listShow blocked itemsAdmin
/ksitem craft add <itemId>Block an item (or a pattern) from being craftedAdmin
/ksitem craft remove <itemId>Unblock an itemAdmin
CommandDescriptionPermission
/ksitem death listShow protected items and current modeAdmin
/ksitem death add <itemId>Protect an item (or a pattern) on deathAdmin
/ksitem death remove <itemId>Remove protectionAdmin
/ksitem death mode <mode>Set default death mode (vanilla, keep-all, selective)Admin
CommandDescriptionPermission
/ksitem restrict listShow all restrictionsAdmin
/ksitem restrict add <itemId> [permission]Restrict equipping an item (block-equip). With a permission, only players who have it may equip the item, owner means the soulbound owner, and without one nobody may.Admin
/ksitem restrict remove <itemId>Remove restrictionAdmin

Other kinds of block, and a message for the player, are in the Usage Rules of the Admin Hub.

CommandDescriptionPermission
/soulboundCheck soulbound info of the currently held item (standalone command)ks.item.user.soulbound (everyone by default)
/ksitem soulbound bindBind the held item to yourself (stamps metadata on the item)Admin
/ksitem soulbound unbindRemove soulbound from the held itemAdmin
/ksitem soulbound checkShow soulbound details of the held item (owner, UUID, bind time)Admin
/ksitem soulbound autobind add <itemId>Add an item or pattern to the auto-soulbound list (binds on pickup)Admin
/ksitem soulbound autobind remove <itemId>Remove an entry from the auto-soulbound listAdmin
/ksitem soulbound autobind listShow all auto-soulbound entriesAdmin
/ksitem soulbound recoverGet back your own lost soulbound items. They become available 5 minutes after they were lost.Admin

Needs the drop-prevention module.

CommandDescriptionPermission
/ksitem dropprevention protectMark the held item as drop protectedAdmin
/ksitem dropprevention unprotectRemove drop protection from the held itemAdmin
/ksitem dropprevention checkShow whether the held item is protected (by its own mark or by the auto list)Admin
/ksitem dropprevention autoprotect add <itemId>Add an item or pattern to the auto-protect list (marked on pickup)Admin
/ksitem dropprevention autoprotect remove <itemId>Remove an entry from the auto-protect listAdmin
/ksitem dropprevention autoprotect listShow the auto-protect listAdmin
CommandDescriptionPermission
/ksitem cooldown set <itemId> <seconds>Set a cooldown on an exact item IDAdmin
/ksitem cooldown remove <itemId>Remove a cooldownAdmin
/ksitem cooldown listList all item cooldownsAdmin
/ksitem cooldown check <itemId>Check your own remaining cooldownks.item.admin
CommandDescriptionPermission
/ksitem watch listShow watched itemsAdmin
/ksitem watch add <itemId>Watch an exact item IDAdmin
/ksitem watch remove <itemId>Stop watching an itemAdmin
/ksitem watch alertsShow the last 20 alertsAdmin

Inv in this table means ks.item.admin and kyuubisoft.itemcontrol.inventory.

CommandDescriptionPermission
/ksitem inv view [player]View the inventory of an online player, or your ownInv
/ksitem inv history [player]View the backup history of an online player, or your ownInv
/ksitem inv snapshot <name>Save a named backup of your own inventoryInv
/ksitem inv restoreRestore your own latest backupInv
/ksitem inv clear [player]Clear the inventory of an online player, or your ownInv + ks.item.admin.clearslot
/ksitem inv wipe <itemId>Remove an item from everyone onlineInv + ks.item.admin.removeall
  • Safety backups: clear, restore and wipe store a safety backup first, and change nothing if that fails. In wipe, a player whose backup fails keeps the item.
  • restore takes the latest real backup and skips the safety backups of earlier actions.
  • Offline players: Their history is only in the Inventory place of the Admin Hub.
CommandDescriptionPermission
/ksitem drops add <npcRole> <itemId> <min> <max> <chance> [mode]Add a drop ruleAdmin
/ksitem drops remove <npcRole> <itemId>Remove a drop ruleAdmin
/ksitem drops list [npcRole]Show drop rulesAdmin
/ksitem drops listrolesShow configured NPC rolesAdmin
/ksitem drops reloadReload drop rules from fileAdmin

<chance> is a fraction from 0 to 1, so 0.5 means 50 %. The window of the Admin Hub takes percent instead. [mode] is add (the default), replace or remove.

CommandDescriptionPermission
/ksitem temprule listShow all temporary rulesAdmin
/ksitem temprule add <id> <type> <itemId> <minutes>Create a rule for one exact item ID that starts nowAdmin
/ksitem temprule remove <id>Delete a ruleAdmin
/ksitem temprule info <id>Show rule detailsAdmin

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

CommandDescriptionPermission
/ksitem override set <itemId> <field> <value>Override a fieldAdmin
/ksitem override get <itemId> [field]View overridesAdmin
/ksitem override reset <itemId> [field]Reset override(s)Admin
/ksitem override listShow all overridden itemsAdmin

Override Fields:

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

FieldDescription
maxDurabilityMaximum durability
durabilityLossOnHitDurability lost per hit
maxStackMaximum stack size
qualityIdItem quality/rarity
consumableWhether item is consumable (true or false)
dropOnDeathWhether item drops on death (true or false)
durabilityLossOnDeathWhether item loses durability on death (true or false)
toolSpeedTool mining speed
armorResistanceArmor resistance value
craftingTierRequired crafting tier
craftingOutputQtyCrafting output quantity
weaponDamageWeapon damage (proportional scaling across all types)
weaponDamage.<Type>Per-damage-type override (e.g. weaponDamage.Physical)
signatureMoveSwap signature ability to another weapon’s signature
weaponStat.<StatName>Weapon stat modifier (e.g. weaponStat.SignatureEnergy)
interaction.<idx>.<field>Per-interaction override
armor.baseDamageResistanceBase armor resistance
armor.resistance.<type>Per-type armor resistance
armor.enhancement.<type>Per-type armor enhancement
armor.kbResistance.<type>Per-type knockback resistance
armor.kbEnhancement.<type>Per-type knockback enhancement
armor.stat.<stat>Armor stat modifier
armor.classEnh.<class>Attack class enhancement (LIGHT, CHARGED, SIGNATURE)
CommandDescriptionPermission
/ksitem cmdblockToggle command block edit mode (alias /ksitem cb)Admin
/ksitem browsescriptsScript file browser (needs KyuubiSoft Core). Currently unavailable: Core’s file browser is switched off and only answers with a chat message, so type script paths into the command block editor directlyAdmin

In edit mode, hit any block to open the Command Block Editor. Blocks that run as the server console also need ks.core.admin.dialog.console; see Permissions.

CommandDescriptionPermission
/kslangShow your current language and the available languages in chatEveryone
/kslang <code>Choose a language, e.g. de-DEEveryone
/kslang autoFollow your game language againEveryone