ckforgame-ItemEnhancements icon

ItemEnhancements

MMORPG-style item enhancement system (+1 to +20) for weapons, armor, and shields with custom scrolls, effects, sounds, and modular YAML configurations.

CHANGELOG

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.Utility to 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.
  • 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.
  • 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 .cfg settings upon build and game launch.
  • 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 F8 or 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.
  • Tier-Colored Inventory Badges: Dynamic colored +X rank 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.yml support 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.