Skip to content

Changelog

A summarized history of Item Control’s development, organized by feature phases.


Release of the Design & Feature Update. It sums up the changes since 2.4.1.

  • New admin window. /ksitem admin opens 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.enabled and hud-card.showReady in Item Control’s config.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 browse a 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.
  • 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.give and the admin-give module. 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.strictTypes in config.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, wipe and restore. 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|info and /ksitem override set|get|reset work now, and restrict changes are saved. /ksitem soulbound autobind list lists the items, and /ksitem give and compare no 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 /ksadmin hub 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 list and /ksitem drops no longer show ”?”. /kslang without an argument answers in chat, and language choices are no longer lost when several KyuubiSoft mods save them at once.
  • 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 wipe needs ks.item.admin.removeall; ks.item.admin does not include them, ks.item.admin.* does. Admins who manage console command blocks need ks.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.

All admin and player windows are new. See the Admin UI page.

  • New rights: ks.item.admin.clearslot for Clear, Clear slot and /ksitem inv clear, and ks.item.admin.removeall for Remove item from everyone and /ksitem inv wipe. ks.item.admin does not include them, ks.item.admin.* does. So /ksitem inv clear and /ksitem inv wipe no longer work with ks.item.admin alone. See Permissions.
  • Give Item in the Item Browser needs ks.item.give, kyuubisoft.itemcontrol.give and the admin-give module.
  • Drop chance: The window now takes percent, so 50 is 50 %. The file and /ksitem drops add keep 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.strictTypes keeps 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, wipe and restore. 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.enabled and hud-card.showReady.
  • 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|info and /ksitem override set|get|reset read their arguments from the wrong place.
  • Old restrict entries: /ksitem restrict add wrote a wrong entry for an item called restrict. 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,5 and 50 both 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 /ksadmin hub now checks the same permissions as /ksitem admin.
  • /ksitem soulbound autobind list shows the list instead of its usage line.
  • Russian texts are fixed and translated, and the windows fit in every language.
  • Command blocks that run as the server console need ks.core.admin.dialog.console in 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.
  • 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].
  • 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 list marks modules with [ON] / [OFF] in the player’s language instead of check marks that showed as ”?”.
  • /ksitem drops messages and the recipe rows of the item browser show a readable arrow instead of ”?“.

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 /ksadmin hub 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.
  • /kslang without 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.
  • 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 example res:Fuel.
  • 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 need ks.item.admin (give needs ks.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.
  • 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_*, *_Iron or *Pickaxe*, type tokens like @weapon or @armor, and @category:<Name> / @subcategory:<Name>. See Modules.
  • death-rules.protectedCategories and crafting-rules.blockedCategories in config.json are now applied.
  • Drop rules in remove mode 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 browsescripts is skipped there).
  • 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.

  • 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
  • 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 ItemHudUI system (Legend type)
  • Graceful degradation on pre-Update 4 servers
  • parseModules() now accepts shorthand "module": true in addition to "module": { "enabled": true }
  • All config parsers have type guards preventing JsonPrimitive cannot be cast to JsonObject errors
  • Scrollable sidebar for better navigation with many modules
  • Modules content tab no longer scrollable (navigation via sidebar)

  • 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.

  • 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
  • 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
  • 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)

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_Time metadata 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”
  • 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
  • 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
  • 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
  • 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
  • NPC drop tracking and player drop tracking
  • Persistent alerts in shared SQLite database (up to 500 entries)
  • Structured alert storage with pagination
  • All modules migrated to a single itemcontrol.db SQLite 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:

  1. v1: Basic module toggles with pagination and navigation to sub-pages
  2. v2: Integrated single-page UI (920x700) with 8 sidebar tabs and full CRUD for all modules
  3. v3: UX redesign with dropdown boxes, ItemIcon previews, and column headers
  4. v4: QuestAdmin-inspired design with color-coded section headers, scrollable content, and auto-width buttons
  1. v1: Basic 24-slot grid with separate detail page
  2. v2: External info panel, scrollable grid, recipe tab
  3. 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

  • 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 give command
  • Module Management: Enable/disable modules via command
  • Localization: 9 languages with automatic detection
  • Config System: JSON-based with hot reload