Item Control

13 modules — all individually toggleable — covering everything from crafting restrictions and custom drops to soulbound items and inventory management. Disabled modules have zero overhead.

One plugin. One config. Full control over every item on your server.

Main Command: /ksitem (Aliases: itemcontrol, ic)

Modules at a Glance

Item Browser

Browse all 1000+ items with pagination, search, and category filters.

Detailed stats: damage, defense, speed, durability, crafting recipe, quality, resource types
Item Comparison — side-by-side stat view of two items with diff highlighting
Categories: Weapons, Armor, Tools, Consumables, Blocks, Utility, Gliders
Inline detail panel with recipe and drop source tabs
Give button directly from the detail page (admin)
Accessible for all players — no permission needed to browse

Crafting Rules

Control what can and cannot be crafted on your server.

Blacklist / Whitelist — block or allow specific items from being crafted
Custom Recipes — create entirely new recipes from the admin UI
Define inputs (up to 4 items), output, bench type, and crafting time
Recipe Editor — edit existing vanilla recipes (override pattern preserves originals)
Recipe Visibility — disable/enable individual recipes; changes sync to clients instantly
Built-in item browser for selecting ingredients
Permission bypass for admins
Recipes register on the client immediately — no restart needed

Drop Rules (NPC + Block)

Configure custom drop tables for NPCs and blocks.

3 modes: add (extra drops), remove (filter vanilla drops), replace (full override)
Configurable quantity range (min-max) and drop chance (0-100%)
Wildcard support: * applies rules to all NPCs
Block drops read the vanilla gathering config — ores drop their actual loot, not the block itself
Drop List browser with all 728+ drop lists from the game data
Managed via admin UI or commands

Soulbound System

Bind items to individual players with per-instance metadata.

Per-instance binding — metadata stamped directly on the item (owner UUID + name + timestamp)
Drop protection — soulbound items cannot be dropped
Container protection — cannot be placed in chests; “Take All” is dupe-proof
Pickup protection — other players cannot pick up your soulbound items
Block-break protection — containers with soulbound items cannot be destroyed
Auto-soulbound — configure items that bind automatically on pickup
Tooltip integration — optional “Soulbound: PlayerName” in item tooltip (via DynamicTooltipsLib)
/soulbound command for all players to check their held item

Death Rules

Control what happens to items when players die.

3 modes: vanilla, keep-all, selective
Protect specific items or entire categories from being lost on death
Permission-based rules — different behavior per rank (e.g. VIP keeps all, free players lose a percentage)
Optional durability preservation on death
Fully configurable via admin UI

Usage Restrictions

Restrict who can equip or consume specific items.

Block equipping or consuming specific items
Permission-based: require a specific permission to use an item
Custom denial messages per item
Integrates with Temp Rules for time-limited restrictions
Perfect for progression systems or rank-exclusive gear

Item Cooldowns

Prevent item spam with configurable cooldown timers.

Per-item and per-category cooldowns (e.g. healing potions: 30s)
Shared cooldown groups — multiple items share one timer
Per-player tracking with remaining-time feedback in chat
Only triggers on active interactions (not passive slot switches)
Fully configurable via admin UI or commands

Item Watchlist

Monitor specific items across your server.

Track when specific items are obtained, crafted, picked up, or dropped
Real-time admin alerts in chat
Persistent alert history in SQLite (up to 500 entries)
NPC drop tracking — alerts when watched items drop from NPCs
Alert history viewable in admin UI with pagination
Perfect for tracking rare or potentially duped items

Inventory Tools

Full inventory management toolkit for administrators.

View any player’s inventory in a paginated UI with item tooltips and rarity colors
Automatic backups on death and join (SQLite database)
Manual snapshots with custom names
Restore from any backup — includes durability, metadata, and enchantments
Item wipe — remove a specific item from ALL online players’ inventories
Backup history browser with preview of all 6 inventory sections (Hotbar, Armor, Utility, Tools, Storage, Backpack)
Offline player support — browse history for players who are not currently online

Item Overrides

Modify item properties at runtime without a server restart.

Overridable fields: maxDurability, maxStack, qualityId, consumable, dropOnDeath, toolSpeed, armorResistance, weaponDamage, craftingTier, and more
Changes sync to all connected clients via packet
Persistent across restarts (item_overrides.json)
Reset individual fields or entire items

Weapon Interactions

Deep editing of weapon behavior and stats.

Weapon Interaction Editor — view and edit all damage interactions (Swing Left, Swing Right, Charged, Vortex, Signature, etc.)
Per-damage-type overrides — modify Physical, Fire, etc. individually or scale proportionally
Signature Move Override — swap a weapon’s signature ability to another weapon’s signature
Weapon Stat Modifiers — edit SignatureEnergy and other weapon stats
EntityStatsOnHit — configure stat gains per hit (e.g. energy per strike)
Knockback — edit force and duration per interaction
Category filter by DamageClass (Light / Charged / Signature)

Armor Editor

Edit armor properties grouped by damage type.

Per-damage-type cards — Resistance, Enhancement, KB Resistance, KB Enhancement
Base Damage Resistance — global resistance value
Stat Modifiers — Health, Speed, and other stats directly editable
Attack Class Enhancement — LIGHT/CHARGED/SIGNATURE class bonuses
Custom damage types and stats — add new types via dropdown, persisted across restarts

Temporary Rules

Time-limited rules that expire automatically.

Time-limited crafting blocks, unlocks, or usage restrictions
Automatic expiry — rules remove themselves when the timer runs out
Optional broadcast on activate/expire
Ideal for weekend events, maintenance windows, or limited-time recipes

Command Blocks

Assign commands to specific blocks in the world.

Edit Mode — toggle with /ksitem cmdblock, then hit any block to open the editor
Placeholders — @p (player name), @pos (block position as x y z)
Execution Mode — Console (permission bypass) or Player (position context)
Indestructible — mark blocks as unbreakable; only admins can destroy them
Auto-Cleanup — when a command block is broken, the assignment is automatically removed
JSON persistence in command_blocks.json

Admin Hub

One central panel to manage everything, accessible via /ksitem admin.

The Admin Hub features a grouped sidebar with color-coded section headers:

Section	Tabs
Modules	Enable/disable any module live
Crafting	Manage blacklist/whitelist, browse recipes, create custom recipes
Recipes	Toggle, copy, edit, and delete recipes
Drops	Configure NPC and block drop rules, browse drop lists
Death	Set modes, protect items/categories, permission rules
Usage	Manage item restrictions
Soulbound	Configure auto-soulbound items
Cooldowns	Set item/category/group cooldowns
Watchlist	Monitor items, view alert history
Inventory	View/backup/restore player inventories
Overrides	Edit item properties, weapon interactions, armor stats
Temp Rules	Manage time-limited rules
Cmd Blocks	View and manage command block assignments

Commands

See the Commands Reference for the full command list.

Command	Description	Permission
`/ksitem admin`	Open admin hub	Admin
`/ksitem browse`	Open item browser	All players
`/ksitem compare <item1> <item2>`	Compare two items	All players
`/soulbound`	Check held item	All players
`/ksitem give <itemId> [amount]`	Give items	`kyuubisoft.itemcontrol.give`
`/ksitem reload`	Reload config	Admin

Permissions

See the Permissions Reference for the complete permission table.

Permission	Description
`kyuubisoft.itemcontrol.admin`	Full admin access (all admin commands + UI)
`kyuubisoft.itemcontrol.give`	Give items
`kyuubisoft.itemcontrol.inventory`	Inventory management
`kyuubisoft.itemcontrol.craft.bypass`	Bypass crafting restrictions
`kyuubisoft.itemcontrol.watchlist.notify`	Receive real-time watchlist alerts

Localization

9 languages included out of the box — auto-detected per player:

English, German, Spanish, French, Italian
Polish, Portuguese (BR), Russian, Turkish
Freely extensible — just add a new JSON file

Technical Details

Modular architecture — 13 independently toggleable modules, zero overhead when disabled
ECS integration — Native Hytale ECS systems for drops, death, pickup, block events
Client sync — UpdateItems / UpdateRecipes / UpdateTranslations packets
SQLite database — Shared database for inventory backups, watchlist alerts, and more
JSON config — Everything configurable, hot-reloadable
Thread-safe — Concurrent access to all services
Core API integration — Registers in Core admin menu (soft dependency)
Soft dependency on DynamicTooltipsLib for soulbound tooltips — graceful fallback

Requirements

Hytale Server (Update 3+)
Java 25.0.1
Optional: DynamicTooltipsLib for soulbound tooltip display
Optional: KyuubiSoft Core for admin menu integration