Changelog
A summarized history of Item Control’s development, organized by feature phases.
v3.0.1 — 2026-11-09
Section titled “v3.0.1 — 2026-11-09”Release of the Design & Feature Update. It sums up the changes since 2.4.1.
- New admin window.
/ksitem adminopens one window for all modules in the new KyuubiSoft look, with switches, counters and a “To check” list that jumps straight to each problem. “Check item” shows every rule that applies to an item, and switched-off modules can be switched on from their tab. - Live item card. A card above the hotbar shows the item in hand: its cooldown countdown, “Ready again”, or that it is restricted or temporarily blocked, with the reason, in the player’s language. Admins set it with
hud-card.enabledandhud-card.showReadyin Item Control’sconfig.json. - Pick items by name. One item selection window with names in the player’s language, search, categories and paging is used everywhere. Item fields offer Exact, Starts with, Contains and Type with a live match count wherever patterns work.
- A page for every rule. Crafting, death, soulbound, drop protection, cooldowns, usage, temporary rules and watched items each have a page with list search, templates and undo. Blocked and protected categories, cooldown categories and cooldown groups can now be edited in game instead of only in the config files.
- Usage and temporary rules. Usage rules let you choose what is blocked and write your own message; with an empty permission nobody may use the item. Temporary rules can start later, be announced, get 30 more minutes, and expired ones can be removed.
- Recipes. The recipe list has a details column, a status filter and a duplicate button, and asks before changing many recipes at once. The recipe editor has clickable slots, resource types, templates, a preview and a check that jumps to the mistake.
- Drops, item adjustments, weapons and armor. Drop chances are entered in percent, with a preview of what the rule changes. The item adjustment, weapon and armor pages reset single fields, choose the quality, copy values to other items and change damage by a percent, with every interaction, damage type and property in reach.
- Safer inventory tools. The inventory tools list all online players instead of ten and offer item details, clearing a single slot, removing an item from everyone with a preview, and named snapshots. The inventory history can be filtered, loads older backups, compares a backup with the current inventory and restores only after a confirmation.
- Command blocks and alerts. The command block list offers edit, teleport and mode, and the editor has templates, a preview, a check of the command name and a test button. Watched-item alerts can be searched and filtered and jump to the player’s inventory.
- Item Browser and compare. In
/ksitem browsea click on an ingredient jumps to it, recipes show their resource types, and a compare button opens the compare window, which colors the differences and can swap the two items. Giving from the browser hands out 1, 10 or a full stack.
Changed
Section titled “Changed”- Console command blocks need the console right. Creating, changing or removing a command block that runs as the server console, or switching one to the console, needs
ks.core.admin.dialog.console; without it an indestructible console block cannot be broken. New command blocks run as the player, and existing ones keep working. - Giving needs the give rights. Giving from the Item Browser needs the same rights as
/ksitem give:ks.item.give,kyuubisoft.itemcontrol.giveand theadmin-givemodule. Without them the button is hidden. - Temporary rules announce their message. A temporary rule with a message now tells all online players when it becomes active; before, the message only went to the log. With the new option
temp-rules.strictTypesinconfig.json(off by default), “Block usage” no longer blocks crafting as well, and the other way round.
- Editing a vanilla recipe keeps its progression locks. Saving a vanilla recipe in the editor removed its bench upgrade, “must be learned” and memories level locks and dropped inputs such as “any wood”. Edits now keep all of this unless you choose “Locks: removed”, and locked recipes are marked in the recipe list.
- Recipes stay as you set them. Reset puts the vanilla recipe back at once and can no longer remove it, an edit no longer switches a disabled recipe back on, and disabled recipes show as off and stay listed after a restart. Edited and custom recipes for Processing, Structural and Diagram benches stay craftable there.
- No more accidental wipes. Clearing an inventory and restoring a backup now ask first, and they store a backup of the current state before anything changes, also with
/ksitem inv clear,wipeandrestore. Disabling all recipes asks too. - Drop chance input. “0,5” and “50” both became 100 % in the old window. Comma and dot work now, and invalid input saves nothing.
- Commands that never worked.
/ksitem module enable|disable,/ksitem restrict add|remove,/ksitem temprule add|remove|infoand/ksitem override set|get|resetwork now, andrestrictchanges are saved./ksitem soulbound autobind listlists the items, and/ksitem giveandcompareno longer say “not found” right after a server start. - Reliable backups. A backup fails instead of leaving out a section with items, empty inventories no longer push real backups out of the limit, and safety backups have their own limit of 20 per player. Teleport from the history goes to the world of the backup.
- Item values are kept. Added weapon damage types survive a restart and are removed again by a reset. Copying values no longer puts interaction values onto an item with different interactions, and clicking a checkbox no longer throws away typed values.
- Clear rules, any world. Cooldowns, watched items and temporary rules take exact item IDs only; patterns like
Weapon_*were accepted there without any effect. Actions on players in other worlds work, and offline players or world changes give a clear message. - Admin window only for admins. The
/ksadminhub tile checks the same rights as/ksitem admin, and the citizen used on the KyuubiSoft Showcase no longer opens the admin window on other servers. - Texts in every language. Texts that were still English are translated in all 9 languages, the Russian cooldown message shows the remaining seconds, and
/ksitem module listand/ksitem dropsno longer show ”?”./kslangwithout an argument answers in chat, and language choices are no longer lost when several KyuubiSoft mods save them at once.
Before you update
Section titled “Before you update”- Grant the new rights. Clearing an inventory or a single slot needs
ks.item.admin.clearslot, and removing an item from everyone or/ksitem inv wipeneedsks.item.admin.removeall;ks.item.admindoes not include them,ks.item.admin.*does. Admins who manage console command blocks needks.core.admin.dialog.console. - Restore progression on old recipe edits. Recipes edited with older versions keep their progression locks removed. Open them in the recipe editor and save them with “Locks: kept” to bring the vanilla progression back.
v3.0.0-beta — 2026-11-03
Section titled “v3.0.0-beta — 2026-11-03”All admin and player windows are new. See the Admin UI page.
Before You Update
Section titled “Before You Update”- New rights:
ks.item.admin.clearslotfor Clear, Clear slot and/ksitem inv clear, andks.item.admin.removeallfor Remove item from everyone and/ksitem inv wipe.ks.item.admindoes not include them,ks.item.admin.*does. So/ksitem inv clearand/ksitem inv wipeno longer work withks.item.adminalone. See Permissions. - Give Item in the Item Browser needs
ks.item.give,kyuubisoft.itemcontrol.giveand theadmin-givemodule. - Drop chance: The window now takes percent, so
50is 50 %. The file and/ksitem drops addkeep a fraction from 0 to 1. - No automatic switching on: Adding a rule no longer turns a module on. A place whose module is off stays visible and offers Turn on.
- Temporary rules with a message now announce it to everyone online when they become active. Before, the message only went to the log.
- Language files: Item Control replaces its language files on the first start and keeps a copy of the old ones next to them.
- Admin Hub: One window with a column on the left, replacing the old tabs and the fixed browse panel.
- To check lists entries that do nothing. Check item shows every rule that hits an item, also through patterns.
- Rule lists: An item selection with search, buttons for patterns, the number of affected items, templates, warnings on rows that do nothing, and Undo.
- Categories tab for crafting and death, with the number of items each entry hits.
- Cooldowns: Tabs for items, ID starts and groups. “Categories” are explained as what they are, the start of an item ID, and To check reports group items without a duration.
- Temporary rules: Start now, in an hour or tomorrow, extend by 30 minutes, and an announcement to everyone when the rule becomes active. New option
temp-rules.strictTypeskeeps Block Crafting and Block Usage apart. - Recipes: Filters, Enable filtered and Disable filtered, Duplicate, templates in the editor, and Check before saving.
- Drops: Lookup shows what a role drops today and what your rule changes. Clicking a rule loads it into the form.
- Inventory: Search for known players, Clear slot, Remove item from everyone, Compare with now, and Teleport to where a backup was made.
- Safety backups: Clearing, restoring and removing an item store a backup first, and change nothing if that fails. This also goes for
/ksitem inv clear,wipeandrestore. They have their own limit of 20 per player and never push out a normal backup. - Command Blocks: A list with search and teleport. The editor has templates, a check of the command, and Test.
- Item Adjustments: Sections with only the fields that apply to the item, reset per field, Transfer to other items, and changing all damage by a percentage.
- Item card: A small card above the hotbar with the cooldown of the held item, or the reason it is blocked. It replaces the old label. New options
hud-card.enabledandhud-card.showReady.
Changed
Section titled “Changed”- Item Browser and Item Comparison are rebuilt, with tabs for info, recipes and drops.
- The inventory view shows the first letter of a player’s name instead of a head.
- Names follow the window: Watched, Drop Protection, Item Adjustments and Command Blocks.
- Added weapon damage types were lost on a restart, and resetting did not remove them. They are now saved and resetting takes them away again.
- Commands that never worked:
/ksitem module enable|disable,/ksitem restrict add|remove,/ksitem temprule add|remove|infoand/ksitem override set|get|resetread their arguments from the wrong place. - Old
restrictentries:/ksitem restrict addwrote a wrong entry for an item calledrestrict. An old entry of that kind stays in the file. To check lists it, and you can remove it in Usage Rules. - Drop chance: In the old window,
0,5and50both became 100 %. Comma and point now work, and invalid input saves nothing. - Clearing and restoring an inventory now ask first and store a backup first.
- Recipes: Disabling all recipes now asks first. An edited recipe that was off no longer shows as on, an edit no longer switches a disabled recipe back on, a reset can no longer remove a vanilla recipe, and disabled custom recipes stay in the list after a restart.
- Patterns were accepted for cooldowns, watched items and temporary rules without having any effect. These lists now only take exact IDs.
- Backups: A backup now fails if a section with items cannot be stored, instead of leaving that section out. Empty inventories no longer create backups.
- Teleport from the history now goes to the world of the backup.
- Other worlds: Actions on a player in another world work reliably, and offline players or a world change give a clear message.
- The tile in the
/ksadminhub now checks the same permissions as/ksitem admin. /ksitem soulbound autobind listshows the list instead of its usage line.
v2.5.5 — 2026-10-30
Section titled “v2.5.5 — 2026-10-30”- Russian texts are fixed and translated, and the windows fit in every language.
v2.5.4 — 2026-10-27
Section titled “v2.5.4 — 2026-10-27”Security
Section titled “Security”- Command blocks that run as the server console need
ks.core.admin.dialog.consolein addition to the Item Control admin nodes. This is the same rule as KyuubiSoft Core’s NPC window and shop editor. Without that right, the editor shows a console block read-only with a hint (command, run mode and “indestructible” are locked, there is no delete button), it cannot be removed from the Admin Hub’s command block list, and an indestructible console block cannot be broken. Switching a block to “Console” needs the right too. The server checks again when saving or deleting. Existing command blocks keep working. See Permissions.
Changed
Section titled “Changed”- New command blocks run as the player by default. Admins with the console right can still switch them to the console.
- The Admin Hub’s command block list marks console blocks with [Console].
v2.5.3 — 2026-10-23
Section titled “v2.5.3 — 2026-10-23”- Compare window (
/ksitem compare): the two item icons are now real item slots with a rarity background; before, the game client rejected them. Higher values are green and lower values red again. Not tested in game yet. /ksitem module listmarks modules with [ON] / [OFF] in the player’s language instead of check marks that showed as ”?”./ksitem dropsmessages and the recipe rows of the item browser show a readable arrow instead of ”?“.
v2.5.2 — 2026-10-21
Section titled “v2.5.2 — 2026-10-21”Integration with KyuubiSoft Core 2.8.0.
- The language system follows Core’s default player language and its “players may choose” switch. Language choices are no longer lost when several KS mods save them at the same time.
- The Item Control tile in the
/ksadminhub shows the real mod version. - Reloading the plugin no longer registers it twice in Core, and startup no longer stops when an older Core is installed.
v2.5.1 — 2026-10-20
Section titled “v2.5.1 — 2026-10-20”/kslangwithout an argument now answers in chat (your current language, the available languages, how to change it) instead of opening a window that no longer exists.
v2.5.0 — 2026-10-16
Section titled “v2.5.0 — 2026-10-16”- Editing a vanilla recipe no longer unlocks it by accident. Saving a recipe in the recipe editor used to drop its vanilla progression locks: bench upgrades (for example the Goblin Tinkerer’s Workbench that needs its parts repaired), “must be learned first” and the world memories level. Edits now keep these locks unless you remove them on purpose.
- Edits keep everything the editor does not show: the bench type (Processing, Structural and Diagram benches), additional benches, secondary outputs and inputs beyond the fourth slot.
- Resource-type inputs (for example “any wood” or
Fuel) are kept. They were dropped when a recipe was saved in the editor. - Reset on an edited recipe puts the vanilla recipe back for all online players right away (before, the recipe was gone until the next restart).
- Re-enabling a disabled recipe also restores it on the server side, custom and edited recipes are only added to the benches they belong to, and custom recipes on Processing, Structural or Diagram benches can now be crafted there.
- Progression locks section in the recipe editor for vanilla recipes with locks, with the toggle Locks: kept / Locks: removed.
- [Locked] tag in the recipe list for recipes with a vanilla progression lock.
- Resource-type inputs can be entered as
res:<Type>, for exampleres:Fuel.
Changed
Section titled “Changed”- The recipe toggle in the Recipes tab reads KS: On / KS: Off. It only shows Item Control’s own enable/disable state, not vanilla progression.
- Edited recipes saved by older versions keep their old behaviour (locks stay removed). Open and save them with “Locks: kept” to restore vanilla progression.
v2.4.0 / v2.4.1 — 2026-10-06 / 2026-10-12
Section titled “v2.4.0 / v2.4.1 — 2026-10-06 / 2026-10-12”- Built for Hytale Update 7 (0.7.0). Mandatory update for 0.7 servers. Restricted items glow red again on 0.7.
v2.3.0 – v2.3.2 — 2026-08-21 to 2026-09-06
Section titled “v2.3.0 – v2.3.2 — 2026-08-21 to 2026-09-06”- Built for Hytale Update 6 (0.6.x).
- Command permissions moved to the 0.6 model: player commands stay open to everyone (gated by
ks.item.user.*), admin subcommands needks.item.admin(giveneedsks.item.give). See Permissions. - Death handling only drops stacks that were really removed from the inventory, so an item can no longer end up both in the inventory and on the ground.
v2.2.0 — 2026-06-11
Section titled “v2.2.0 — 2026-06-11”- Death “selective” mode kept the whole inventory as soon as one item was on the protected list. Now every item that is not protected is lost in selective mode; a player’s own soulbound gear is still kept. The same fix applies to Drop Prevention.
- Patterns in every item rule list (death protection, soulbound auto-bind, drop-prevention auto-protect, crafting blocks): wildcards like
Weapon_*,*_Ironor*Pickaxe*, type tokens like@weaponor@armor, and@category:<Name>/@subcategory:<Name>. See Modules. death-rules.protectedCategoriesandcrafting-rules.blockedCategoriesinconfig.jsonare now applied.- Drop rules in
removemode accept a pattern and strip every matching item from the vanilla loot. NPC role and block keys may also be wildcards (Trork_*,Ore_*).
v2.1.0 – v2.1.3 — 2026-05-26 to 2026-05-30
Section titled “v2.1.0 – v2.1.3 — 2026-05-26 to 2026-05-30”- Built for the Hytale 0.5.0 release.
- Armor resistance and weapon stat overrides affect gameplay again on 0.5.0.
- Item Control starts again on servers without KyuubiSoft Core (only the Core-based
/ksitem browsescriptsis skipped there).
v2.0.14 – v2.0.23 — 2026-04
Section titled “v2.0.14 – v2.0.23 — 2026-04”- The inventory backup preview uses real inventory slots with the native item tooltip and rarity glow, plus the Soulbound, Weapon Mastery and Drop Prevention tooltip lines when DynamicTooltipsLib is installed. The Tools row is no longer shown in backup previews.
- Various fixes.
v2.0.0 — 2026-03-26
Section titled “v2.0.0 — 2026-03-26”Command Blocks Module
Section titled “Command Blocks Module”- New module: Command Blocks — assign commands to any block in the world
- Edit mode toggle via
/ksitem cmdblock, hit a block to open the editor UI - Placeholders:
@p(player name),@pos(block position) - Choose execution mode per block: Console (permission bypass) or Player (position context)
- Indestructible option — only admins can break protected command blocks
- Auto-cleanup when blocks are broken
- Admin Hub tab with paginated list and delete
- JSON persistence in
command_blocks.json
Item HUD Overlays (Update 4 Prep)
Section titled “Item HUD Overlays (Update 4 Prep)”- ItemHudUI Injector: Restricted items show a “RESTRICTED ITEM” badge when held
- Cooldown items show a “HAS COOLDOWN” badge when held
- Uses the new Update 4
ItemHudUIsystem (Legend type) - Graceful degradation on pre-Update 4 servers
Config Parser Fix
Section titled “Config Parser Fix”parseModules()now accepts shorthand"module": truein addition to"module": { "enabled": true }- All config parsers have type guards preventing
JsonPrimitive cannot be cast to JsonObjecterrors
Admin Hub
Section titled “Admin Hub”- Scrollable sidebar for better navigation with many modules
- Modules content tab no longer scrollable (navigation via sidebar)
Inventory Backup Overhaul — 2026-03-14
Section titled “Inventory Backup Overhaul — 2026-03-14”- Full item data restore: Backups now serialize and restore durability, max durability, and BSON metadata (Weapon Mastery enchantments, Soulbound properties, custom data)
- Complete history preview: History page shows all 6 inventory sections (Hotbar, Armor, Utility, Tools, Storage, Backpack)
- Hover tooltips: All item slots show detailed tooltips with name, rarity tag, durability, Weapon Mastery stats, and soulbound indicator
- Rarity background colors: Slots are tinted by item quality — Uncommon (green), Rare (blue), Epic (purple), Legendary (orange)
- Shared tooltip logic: Unified tooltip builders shared between History and View pages
Weapon Interactions and Armor Editor — 2026-03-11
Section titled “Weapon Interactions and Armor Editor — 2026-03-11”A major expansion of the Item Override system with deep weapon and armor editing capabilities.
Weapon Interactions
Section titled “Weapon Interactions”- Interaction Editor: View and edit all damage interactions per weapon (Swing Left, Swing Right, Charged, Vortex, Signature, etc.)
- Per-damage-type overrides: Modify Physical, Fire, etc. individually across all interactions
- Signature Move Override: Swap a weapon’s signature ability via dropdown
- Weapon Stat Modifiers: Edit stats like SignatureEnergy directly
- EntityStatsOnHit: Configure stat gains per hit per interaction
- Knockback editing: Force and duration per interaction
Armor Editor
Section titled “Armor Editor”- Per-damage-type cards: Resistance, Enhancement, KB Resistance, KB Enhancement grouped by damage type
- Stat Modifiers and Attack Class Enhancement: Health, Speed, LIGHT/CHARGED/SIGNATURE bonuses
- Custom types: Add new damage types and stats via dropdown, persisted across restarts
Recipe Editor
Section titled “Recipe Editor”- Edit existing recipes: Both vanilla and custom recipes editable from the admin UI
- Override pattern: Vanilla recipes are preserved — edits create a
ks_edit_prefixed override - Reset to default: Edited vanilla recipes can be reverted to their original state
Drop Rules: Block Drops and Soulbound Fixes — 2026-03-10
Section titled “Drop Rules: Block Drops and Soulbound Fixes — 2026-03-10”- Block drop rules: Drop Rules now apply to blocks (not just NPCs), supporting all 3 modes (add, remove, replace)
- Vanilla block drops: Reads BlockGathering config for correct drops (ores drop their actual loot)
Soulbound System Hardening
Section titled “Soulbound System Hardening”A series of critical fixes to the Soulbound system:
- Per-instance metadata binding: Complete rewrite from ID-based to BSON metadata stamped on each item stack
- Tooltip integration via DynamicTooltipsLib: Replaced custom PacketAdapter filter (272 lines) with the shared tooltip library
- Container guard: Full transaction support (Move, ItemStack, List transactions), re-entrancy guard preventing server freezes
- Chunk coordinate fix: Corrected 16x16 assumption to Hytale’s actual 32x32 chunks
- Multi-world support: ContainerGuard now activates on world entry (not just initial connect)
- Block-break protection: Containers with soulbound items cannot be destroyed
- Binding timestamps:
SB_Timemetadata with UTC display in check command
Item Override System and Admin UI — 2026-03-09
Section titled “Item Override System and Admin UI — 2026-03-09”Item Overrides
Section titled “Item Overrides”- Runtime modification of item stats (damage, durability, stack size, quality, tool speed, armor, crafting tier, etc.)
- Reflection-based application with client sync via UpdateItems packets
- JSON persistence in
item_overrides.json - Full Admin UI page with search, filter, and field editor
Custom Recipe System
Section titled “Custom Recipe System”- Create new recipes from the admin UI with up to 4 inputs, bench selection, and crafting time
- Recipe visibility management — disable/enable individual recipes with instant client sync
- Custom recipes persist across restarts and player relogs (delayed sync after asset init)
- Recipe editing, copying, and permission-based visibility
Drop Management
Section titled “Drop Management”- NPC drop rules with 3 modes (add, replace, remove) and wildcard support
- Vanilla drop interception with correct system ordering
- Drop List browser (728+ lists) and vanilla drops lookup in admin UI
Inventory Tools Expansion
Section titled “Inventory Tools Expansion”- SQLite-based backup system with auto-backup on death and join
- Visual inventory viewer with avatar, item details, and backup history
- Snapshot migration from JSON to SQLite
- Offline player support for history browsing
Watchlist Enhancements
Section titled “Watchlist Enhancements”- NPC drop tracking and player drop tracking
- Persistent alerts in shared SQLite database (up to 500 entries)
- Structured alert storage with pagination
Shared Database
Section titled “Shared Database”- All modules migrated to a single
itemcontrol.dbSQLite database - Automatic migration from legacy
inventory_backups.db
Admin Hub Evolution — 2026-03-08 to 2026-03-09
Section titled “Admin Hub Evolution — 2026-03-08 to 2026-03-09”The Admin Hub went through multiple design iterations:
- v1: Basic module toggles with pagination and navigation to sub-pages
- v2: Integrated single-page UI (920x700) with 8 sidebar tabs and full CRUD for all modules
- v3: UX redesign with dropdown boxes, ItemIcon previews, and column headers
- v4: QuestAdmin-inspired design with color-coded section headers, scrollable content, and auto-width buttons
Browser Evolution
Section titled “Browser Evolution”- v1: Basic 24-slot grid with separate detail page
- v2: External info panel, scrollable grid, recipe tab
- v3: 60 items per page, recipe icons, drops tab, drop source registry
Phase 3: Soulbound, Cooldowns, Watchlist — 2026-03-08
Section titled “Phase 3: Soulbound, Cooldowns, Watchlist — 2026-03-08”- Soulbound Module: Drop prevention via ECS system, player-specific bindings, auto-soulbound list, JSON persistence
- Cooldowns Module: Per-item and per-category cooldowns, shared cooldown groups, in-memory tracking
- Item Watchlist Module: Admin alerts on craft/pickup, file logging, recent alerts list
Phase 2: Crafting, Death, and Usage Rules — 2026-03-08
Section titled “Phase 2: Crafting, Death, and Usage Rules — 2026-03-08”- Crafting Rules: Blacklist per item ID, bypass permissions, ECS-based blocking via
CraftRecipeEvent.Pre - Death Rules: 3 modes (vanilla, keep-all, selective), automatic item restoration on respawn
- Usage Rules: Item restrictions with permission system and custom denial messages
Phase 1: MVP — 2026-03-08
Section titled “Phase 1: MVP — 2026-03-08”- Initial release of Item Control v1.0.0-alpha1
- Modular architecture with independent, toggleable modules
- Item Browser: Search, filter by 7 categories, paginated browsing, detail view
- Admin Give:
/ksitem givecommand - Module Management: Enable/disable modules via command
- Localization: 9 languages with automatic detection
- Config System: JSON-based with hot reload