ItemEnhancements
MMORPG-style item enhancement system (+1 to +20) for weapons, armor, and shields with custom scrolls, effects, sounds, and modular YAML configurations.Changelog
All notable changes to ItemEnhancements will be documented in this file.
[1.0.2] - 2026-10-04
Added & Improved
- Expanded Accessory & Trinket Support:
- Broadened accessory detection beyond
ItemType.Utilityto recognize custom modded jewelry, rings, necklaces, amulets, and trinkets. - Added support for Armor bonus and Eitr Regeneration bonuses on enhanced utility accessories and trinkets in tooltips, UI preview, and
PlayerBonusCache. - Renamed category tab filter to "Accessories" for clarity and expanded coverage.
- Broadened accessory detection beyond
- Documentation & Path Sanitization:
- Fully sanitized local machine path references across repository documentation.
[1.0.1] - 2026-09-27
Fixed & Improved
- Input & Click-Through Protection:
- Intercepted player inputs (
Player.TakeInput,PlayerAttackInput,Interact) while the enhancement GUI is active to prevent accidental weapon swings, camera jitter, and world interactions. - Consumed unhandled mouse events in window bounds to prevent IMGUI click bleed-through into underlying inventory grid.
- Intercepted player inputs (
- UI & Visual Polish:
- Redesigned active/inactive category tab palette with high-contrast amber/slate themes.
- Custom styled "Change Item" and selection buttons with MMORPG-style bronze/gold textures.
- Configuration & Hotkeys:
- Fixed configuration migration and deployment logic to preserve existing user keybindings and custom
.cfgsettings upon build and game launch.
- Fixed configuration migration and deployment logic to preserve existing user keybindings and custom
- Documentation & Packaging:
- Sanitized local repository file links and metadata for clean open-source distribution.
[1.0.0] - 2026-09-25
Added
- Full Equipment Enhancement (+1 to +20): Upgrade weapons, armor, shields, and utility accessories.
- 100% Vanilla Save-Safe: All refinement data and crafter names are saved directly into native
ItemDrop.ItemData.m_customData. - 4 Tiers of Custom Enhancement Scrolls:
- Tier 1 (+1 to +5): Dropped by Meadows & Black Forest monsters.
- Tier 2 (+6 to +10): Dropped by Swamp & Mountain monsters.
- Tier 3 (+11 to +15): Dropped by Plains & Mistlands monsters.
- Tier 4 (+16 to +20): Dropped by Ashlands, Deep North monsters, and guaranteed from World Bosses.
- Workbench Scroll Fusion: Combine 3 lower-tier scrolls into 1 higher-tier scroll at any standard workbench.
- Interactive Refinement GUI:
- Toggle with
F8or click the[⚡ Enhance]button beside the Repair button at any Crafting Station. - Live stat comparison preview (+diff view), success rates, risk level warnings, and anvil strike audio/particle feedback.
- Select items easily by clicking directly in your inventory while the enhancement window is open.
- Toggle with
- Tier-Colored Inventory Badges: Dynamic colored
+Xrank badges rendered on item quality icons in inventory grids. - Modular YAML Configurations & Safe Overrides:
- Granular control over abilities, success rates, penalties, and drop rates across 5 modular YAML files in
BepInEx/config/ckforgame.ItemEnhancements/. - Non-destructive
*.override.ymlsupport protects custom balance settings from being overwritten during mod updates. - Background live hot-reload automatically recalculates equipment stats upon saving files without restarting the game.
- Granular control over abilities, success rates, penalties, and drop rates across 5 modular YAML files in
