PerfectItemManager - Full Item Control v1.9.2

PerfectItemManager v1.9.2
2026-05-26

Hytale Update 5 compatibility update.

Changes:

• Updated for Hytale Update 5 (Pre-Release 5).
• Recompiled against the latest server API (JOML vectors, new permission and HUD APIs).
• Fixed the red "Target Version" warning shown in the mod manager.
• No feature changes. Your existing configs, data and saved files are kept as is.

How to update:

• Stop your server.
• Replace the old PerfectItemManager jar with this one.
• Start your server. Nothing else to do.

v1.9.2 — Massive update

NEW: Tier System per-instance
Every weapon and armor can now roll a tier on drop / pickup / craft (Common → Legendary). Each rolled instance carries its own random affixes, damage multiplier and colored border — no two items are alike.

• Weapon affixes: Damage Boost, Critical Chance, Critical Damage, Lifesteal, Predator (low-HP bonus), Speed Boost, Knockback Bonus
• Armor affixes: Damage Reduction, Health Bonus, Thorns (counter damage), Knockback Resistance, Regeneration
• Common: Durability Bonus (bumps max durability at roll)
• Per-stack tooltip with colored bullets, section headers, and roll-range hints (e.g. +22% critical chance (5-25%))
• Per-stack border color from tier (Common → Legendary visual progression)

NEW: Damage Variance
Make every weapon hit feel different — slider 0-100% ± per-hit damage randomization, applied via Hytale's native randomPercentageModifier.

NEW: Per-Attack Damage editor
Override individual attacks of any weapon independently. Set distinct damage values for Stab, Thrust, Swing Down, Swing Down Left/Right, Signature attacks, etc. Available via

Code:

/itemmanager perattack <itemId>

or the EDIT… button in the Stats tab.

NEW: Item Creator card
Visible on the Landing page — full custom item builder coming in v1.9.3 (clone a base item, set new ID/name/description/stats/quality, save and ship).

UI rework — KatsuyaTV charter

• All tab panels (Stats, Craft, Quality, Drops, Restrictions, Random Tier, Settings) restyled as turquoise-accented cards
• Landing page enlarged with a 3-card layout
• Flat charter headers on CraftEditor / DropRules / ItemPicker (removed legacy DecoratedContainer)
• Dedicated Tier Config + Tier Editor + Affix Editor sub-pages with charter styling

Bug fixes

• Tooltip cache: multiple items with the same tier no longer shared the same affix value
• Stacking multiple CRITICAL_CHANCE affixes now correctly adds them (was: only the last one counted)
• Atomic crit roll per hit (no more shared global state between attacks)
• UUID-safe inventory listener (race condition on player disconnect)
• HEALTH_BONUS modifier cleaned at plugin shutdown (no more zombie buffs after /reload)

Translations
~50 new keys added across 6 supported languages (EN, FR, ES, IT, DE, PT). Switch with

Code:

/itemmanager setlang <code>

.

Credit
Per-instance tooltip & visual override system integrated and adapted from DynamicTooltipsLib by MineAndCraft (CurseForge id 1459711).

Commands

• Code:

  /itemmanager

  — open the management UI
• Code:

  /itemmanager tier <itemId> enable|disable|info|give|menu

  — manage tier config / give a rolled instance
• Code:

  /itemmanager perattack <itemId>

  — open the per-attack damage editor

Permissions

Code:

perfectitemmanager.command

,

Code:

perfectitemmanager.menu

,

Code:

perfectitemmanager.menu.stats

,

Code:

perfectitemmanager.admin

Requires Hytale server 2026-03-26 or newer.

PerfectItemManager v1.8 — Patch Notes

---

Complete UI Redesign​

The entire management interface has been rebuilt from scratch as a single-page flat design, replacing the previous 5-page system (Landing, MainMenu, DropRules, CraftEditor, ItemPicker).

New Layout:

• Dark anthracite theme with no Hytale borders
• Left sidebar (340px) with item list, search, filters, and pagination
• Right panel with tabbed content and item header (48x48 icon, name, type, quality)
• 6 tabs: Stats, Craft, Quality, Drops, Restrictions, Random Stats (coming soon)

Sidebar​

• Search with GO button and X clear
• 6 category filters: All, Weapons, Armor, Tools, Modified, Other
• 11 craft bench filters: All, Workbench, Armor, Weapon, Cooking, Alchemy, Carpenter, Loom, Tannery, Farming, Lumbermill
• MOD badge on items with active overrides
• 20 items per page with pagination
• Settings button (tooltip toggle, reload config, global actions)
• Tiers button (grayed out — coming soon)

Stats Tab​

• 6 editable stat rows: Durability, Damage, Armor, Speed, Knockback, Toughness
• Base value displayed in green for comparison
• Percentage syntax support (e.g. 50% = +50% of base)
• No Durability toggle checkbox

Craft Tab​

• Required Tier, Craft Time, Permission fields with SET buttons
• Disable Recipe toggle
• Inline ingredient editor— no more separate page
  • +/- quantity buttons per ingredient
  • X button to remove ingredients (physically removed from recipe)
  • +ADD button opens item picker to add new ingredients
  • Stable ingredient ordering

Quality Tab​

• Visual selector with 6 buttons: None, Common, Uncommon, Rare, Epic, Legendary
• Active quality highlighted with > NAME <
• Base quality and current override displayed

Drops Tab (Item-Centric)​

• Shows which NPCs and blocks drop the selected item
• Min/Max quantity and drop chance (%) per source
• + NPC and + BLOCK buttons open dedicated pickers
• NPC picker lists all NPC roles, Block picker lists all block types
• Internal items (* prefix) filtered out from block list
• SAVE button to persist changes

Restrictions Tab​

• 4 toggles: Block Use, Block Drop, Block Equip, Block Place
• Permission field per restriction with SET button

Settings Panel​

• Weapon Stats Tooltips toggle (ON/OFF)
• Language display
• Reload Config button
• Global Actions: No Durability (all items), Multiply stats x2/x5/x10, Reset All with confirmation

Notifications​

• Toast notifications on save, reset, stat update, drops save, multiply, and reset all
• Success (green), Warning (yellow), and Error (red) notification styles

Bug Fixes​

• Fixed ingredient quantity override — MaterialQuantity field was "quantity" not "count". Ingredient quantity changes via +/- never actually applied in previous versions
• Fixed ingredient deletion — Ingredients set to qty=0 are now physically removed from the recipe input array (previously remained visible in workbench)
• Fixed crash on items with * prefix — Internal items (bucket states, deco states, fish states) excluded from item list
• Fixed getRequiredTier() NPE — Integer auto-unbox on null value
• Fixed getCraftTime() NPE — Same null handling fix
• Fixed Disable Recipe causing UI crash on rebuild

Localization​

• ~60 new translation keys across 6 languages (EN, FR, ES, IT, DE, PT)
• All tabs, buttons, labels, headers, hints, toasts, and status messages fully translated
• Category filters, bench filters, stat labels, quality names all localized

Technical​

• Single .ui file (~900 lines) replaces 5 previous UI files
• Single PIMMainPage.java (~1600 lines) replaces 4 page classes
• ItemPickerPage supports 3 modes: item (ingredients), NPC targets, block targets
• Version bump: 1.7 → 1.8

Bug Fix​

• Fixed chest/container UI corruption when Violets_Wardrobe mod is active— Opening vanilla chests would display raw color tags (<COLOR IS="#55AAFF">------------ STATS ------------</COLOR>) instead of the normal container UI. This was caused by armor items from third-party mods (like Violets_Wardrobe) having an empty descriptionTranslationKey (""). The tooltip injector treated this empty string as a valid i18n key and injected stat tooltips into it, which corrupted the container display for unrelated blocks.
  • resolveDescKey() now treats empty strings as null and generates a proper fallback key
  • injectTooltip() now rejects empty description keys entirely
  • Both WeaponTooltipInjector and WeaponDamageCache are patched

PerfectItemManager v1.7.0 — Reactive Tooltips​

• Real-time tooltip sync — When an admin modifies item stats via the UI, all connected players see the updated tooltip instantly. No relog required.
• Tooltip sync on join — Players joining the server automatically receive the latest tooltip data.
• Native packet system — Uses Hytale's UpdateTranslations + UpdateItems protocol for seamless client updates.

FIX

• Tooltip cache invalidation — Stat overrides (damage, durability, quality) now correctly reflect in tooltips after modification. Previously, the tooltip cache would revert to original JSON values.
• Quality removed from tooltip — Quality/rarity is already displayed natively by Hytale (colored border + top-right label). Removed the duplicate line from injected stats to avoid showing stale values.

PerfectItemManager v1.6 — Patch Notes

API Compatibility​

• Fixed BlockState class removal — replaced with world.breakBlock() for block drop rules
• Fixed Item.getBuilderToolData() removal — builder tools now filtered by ID pattern
• Fixed cachedPacket field type change (SoftReference) for proper cache invalidation

Weapon Damage Override Fix​

• Fixed weapon damage not applying in-game
• Now modifies both baseDamage (legacy) and baseDamageRaw (new format) on the DamageCalculator
• Handles Hytale's UnmodifiableMap by replacing with mutable copy

Tooltip System Fix​

• Fixed tooltips not reflecting overridden stats at server startup
• Guaranteed execution order: stats overrides apply BEFORE tooltip injection
• Weapon damage cache updated with override values before tooltip generation
• Fixed tooltip re-injection (old tooltips cleared before re-inject)
• Note: Tooltip updates require player reconnect (Hytale I18n limitation — strings are sent to client on connect)

Important Notes​

• Durability changes affect new items only — existing items in inventory keep their original values
• After changing stats, players must reconnect to see updated tooltips

PerfectItemManager v1.5.0 — Patch Notes

API Compatibility Update​

BlockDropListener

• Fixed BlockState class removal — the package com.hypixel.hytale.server.core.universe.world.meta no longer exists
• Replaced manual chunk-level block removal (getState/setBlock/updateState) with world.breakBlock(x, y, z, 0)
• Removed unused imports: BlockType, WorldChunk, ChunkUtil

ItemPickerPage

• Fixed Item.getBuilderToolData() and Item.getBlockSelectorToolData() method removal
• Builder tools and block selector tools are now filtered by item ID pattern instead of removed API methods

PerfectItemManager v1.5 — Patch Notes​

Fixed: Tooltip Injection for Third-Party Mod Items​

Stat tooltips (damage, armor, quality, attack types...) were not injected for items coming from other mods loaded as JARs (e.g. MajorDungeons).

Root cause: The JAR indexing relied on creating a NIO FileSystem to read item JSON definitions inside plugin JARs. When the server had already opened the JAR (which happens for all loaded mods), the operation silently failed — causing the entire JAR to be skipped. No item data was extracted, so no tooltips were generated.

Fix: JAR item definitions are now read directly from the JarFile stream, bypassing the NIO FileSystem entirely. A content cache ensures reliable access regardless of how the server manages JAR files internally.

Improved: Custom Quality Colors in Tooltips​

Added proper color support for non-vanilla quality types commonly used by third-party mods:

• Eternal — Gold
• DarkMagic — Purple
• SilverMoon — Light Blue
• Superior — Teal

Previously, all custom qualities defaulted to white.