HyGuns Plugin: Changes and Migration Guide

Changelog:

Massive events refactor, new Ammo UI, prep for new ingredients

• Refactored gun settings pipeline to use centralized per-item config in asset JSON:
  • HyGuns.Settings is now parsed by GunRegistry.
  • Added GunRegistry.GunSettings record for structured access.
• Added interaction-to-settings fallback logic:
  • ShootGunInteraction, ReloadInteraction, ReloadCheckInteraction now read from HyGuns.Settings.
  • If a value is explicitly set in interaction JSON (Hyguns_*), it overrides HyGuns.Settings.
• Added incremental resource refresh support in GunRegistry:
  • Tracks file stamps and updates only changed item JSON resources.
• HUD/Ammo UI updates:
  • Added full root visibility control (#AmmoRoot.Visible) to hide entire Ammo UI block when weapon is not active.
  • Added support for WeaponIcon in HUD.
  • Ammo reserve display now comes from actual inventory count of AmmoItemType (fallback is 0).
  • Added support for both ammo and weapon icons visibility/background sync.
  • Updated ammo text rendering and padding utilities (StringUtil).
• Added UI assets:
  • Common/UI/Custom/Hud/DividerVR.png
  • Common/UI/Custom/Hud/ammo_block_bg.png (later renamed; see next commits)

Ammo UI background update

• Updated Ammo UI background asset content (ammo_block_bg.png) for visual improvements.

Manifest update, resource naming cleanup, templates update

• Updated mod metadata:
  • manifest.json: version -> 3.5.0
  • ServerVersion updated.
  • Added author entry: EnsoX.
• Renamed/cleaned UI assets:
  • ammo_block_bg.png -> Ammo_Block_BG.png
  • scope_overlay.png -> Scope_1.png
  • Added Scope_2.png
  • Removed old scope assets and obsolete Scope item resources.
• Updated HygunsAmmo.ui to use renamed background texture path.
• Updated weapon templates to new settings format:
  • Removed old scattered Hyguns_* stat fields from interactions.
  • Added centralized HyGuns.Settings blocks.

Build version bump

• build.gradle.kts version updated from 3.1.0 to 3.5.0.

New Weapon Settings Format
Define per-weapon values in item JSON:

Supported keys in HyGuns.Settings

• Damage (int)
• NumProjectiles (int)
• Spread (double)
• MaxAmmo (int)
• AmmoIcon (string)
• WeaponIcon (string or null)
• AmmoItemType (string item id)
• ReloadTime (double)
• ReloadAmountPerInteraction (int)
• LoadedProjectileConfigId (string, optional)
• ProjectileConfigId (string, optional)
• ProjectileId (string, optional; legacy projectile route)