Item Control
12 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)
/soulboundcommand 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
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 |
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 | Admin |
/ksitem reload | Reload config | Admin |
Permissions
| 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 |
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 — 12 independent 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