PerfectItemManager

The most powerful item management tool for Hytale servers. Override stats, crafting recipes, quality, drop rules, and now roll per-instance tiers with random affixes on weapons and armor -- Common to Legendary, with colored borders and styled tooltips.

Buy on BuiltByBit

Installation

1. Drop PerfectItemManager-1.9.2.jar in UserData/Mods/
2. Start the server
3. Use /itemmanager to open the Landing page

Tier System (new in v1.9)

Every weapon and armor can roll a tier at drop / pickup / craft. Each rolled instance carries:

• A colored slot border from the tier (Common → Legendary visual progression)
• A damage multiplier applied at combat time
• A pool of random affixes with min/max ranges shown in the tooltip
• A styled per-stack tooltip with section headers, colored bullets, and roll-range hints

Enable on any item via /itemmanager tier <itemId> enable (auto-detects weapon vs armor for default affix pool), then configure via the in-game Tier Config UI (probability per tier, damage multiplier, min/max affixes, affix pool with editable min/max values).

Test rolls with /itemmanager tier <itemId> give -- each call produces a fresh random instance.

Affixes

Weapon affixes (offensive)

Armor affixes (defensive)

Common affix

Damage Variance (new in v1.9)

Per-item slider (0-100%) that drives Hytale's native randomPercentageModifier. Each hit deals ±X% random damage spread. Set it from the Stats tab → Damage Substats section.

Per-Attack Damage editor (new in v1.9)

Override individual attacks of any weapon independently. A sword exposes Stab / Thrust / Swing Down / Swing Down Left/Right / Signature attacks, and you can set distinct damage values for each.

Open via /itemmanager perattack <itemId> or the EDIT… button in the Stats tab's Damage Substats section.

Other Features

• Item Stats Override -- Modify damage, durability, armor, attack speed, knockback, armor toughness
• Crafting Override -- Change or remove crafting recipes; control which benches can craft what
• Quality Override -- Set custom quality levels per item
• Block Drop Rules -- Customize what drops when any block is broken
• Entity Drop Rules -- Customize what any mob drops on death
• Restrictions -- Block use, drop, equip or place of items, with optional per-permission gating
• Weapon Tooltips -- Display damage values in tooltips (toggleable). Layers cleanly with the per-instance tier tooltip.
• Bulk Edit & Global Overrides -- Apply changes to multiple items, set global multipliers
• Item Creator -- Coming in v1.9.3 -- clone an item, set new ID/name/stats/quality/icon and ship it in your asset pack

Commands

Permissions

Configuration

{"lang": "EN", "weaponTooltips": true}

Override data lives in UserData/Saves/<world>/mods/KatsuyaTV_PerfectItemManager/ as JSON, plus per-instance rolled tiers stored as BSON metadata on each ItemStack (survives restart).

Credits

Per-instance tooltip and visual override system integrated and adapted from DynamicTooltipsLib by MineAndCraft (CurseForge id 1459711). Source is shaded -- no external dependency required.

FAQ

Changes don't appear in-game?

Use /itemmanager reload. Some changes (asset reloads) may require a server restart.

Can I override vanilla items?

Yes, any item in the game can be overridden.

Why does my item not roll a tier?

Tier rolls only apply to weapons and armor by default. Make sure the item override exists and the tier config is enabled. Items already in inventories don't re-roll -- use /itemmanager tier <itemId> give to test with a fresh instance.

Do rolled tiers persist across restarts?

Yes. Each item's rolled tier is stored in BSON metadata on the ItemStack itself, so it survives drops, container moves, server restarts, and world transfers.

Can multiple Critical Chance affixes stack?

Yes -- as of v1.9.2 they stack additively (capped at 100%). Same for Damage Boost.