KbAnimation-gun v1.1.0

• Java Compatibility: Lowered JVM target version to Java 21 to ensure full compatibility with Folia/Paper servers running Java 21 LTS.
• Cancellable Reload: Enhanced WeaponReloadEvent by implementing Cancellable, allowing developers to cancel or interrupt weapon reloads (e.g., inside safe zones).
• Auto Spray Events: Added new events to detect when a player starts and stops automatic firing:
  • WeaponFireStartEvent — Fires on the first shot of a spray sequence.
  • WeaponFireStopEvent — Fires when the trigger is released, detailing the total amount of bullets shot.
• Wiki API Update: Rewrote with configuration guidelines (plugin.yml dependencies) and code examples for the new events.

• Fixed Muzzle Flash Bone Rendering: Restored immediate packet flushing specifically for muzzle flash animations to prevent the visibility state from getting lost in batch queue delays, ensuring flashes show up every shot while maintaining low packet load.
• Alternating 2-Layer Muzzle Flash Support: Added automated alternation between sub-bones representing the two muzzle flash layers (e.g. aim_0 / aim_1 or aim1 / aim2 alternating back and forth per shot) for dynamic and realistic shooting visuals.
• Fixed Shared Customization Bug on Duplicate Weapons: Resolved the issue where having multiple items of the same weapon type (e.g. customized AK12 and raw AK12 in separate slots) would render the same attachments. The plugin now tracks inventory slots and creates independent model instances.
• Live Attachment Updates: The plugin now dynamically refreshes model attachment bones in real-time as NBT attachment tags change, without requiring the player to unequip or swap the weapon.

• Reduced Ping Spikes on Mass Shooting: Optimized packet dispatch to use BetterModel's natural batching instead of immediate burst, significantly improving performance when many players shoot simultaneously.
  
  
• Fixed Crouch Camera Pitch Bug: Weapon model no longer drifts when looking up/down while crouching.

Version: 1.0.8

New Features & Enhancements​

• Complete Public API (KbAnimationAPI):
  • Exposed a clean API for third-party plugins to easily query ammo, apply/get skins, play weapon sounds, and manage weapon states simply by importing the plugin JAR into their libs folder.
• Custom Weapon & Grenade Events:
  • Added 15 new events (including cancellable pre-shoot, reload start/finish, scope change, melee hit/miss, and grenade explosions) enabling deep cross-plugin integrations.
• Native PlaceholderAPI Support (%kbanimation_*%):
  • Registered new placeholders for custom HUDs and menus:
    • %kbanimation_weapon% — Held weapon ID.
    • %kbanimation_skin% — Equipped skin ID.
    • %kbanimation_ammo% — Current magazine ammo count.
    • %kbanimation_reserve_ammo% — Current reserve ammo count.
    • %kbanimation_reloading% — Reloading state (true/false).
    • %kbanimation_scoped% — ADS/Scope state (true/false).
    • %kbanimation_firemode% — Current fire mode (AUTO, SEMI, BURST).

Changelog - Version 1.0.7​

• Added Configurable Hit Sounds: Support for headshot, body shot, and kill sounds.
• Per-Weapon Customization: Sounds, volumes, and pitches can now be overridden individually for each gun (e.g., ak12.yml, g17.yml).
• Global Fallbacks: Configured default hit sounds and a toggle (player-only) in config.yml.
• Version Bump: Updated plugin version to 1.0.7.

• Instant Muzzle Flash Z-Axis Random Rotation:
  • Randomizes the Z-axis (roll) rotation of the muzzle flash bone mesh on every shot.
  • Disabled client-side interpolation (moveDuration = 0) specifically on the muzzle flash entity so it snaps instantly to the new angle without showing a spinning line transition.
• Muzzle Flash Configurable Blinking:
  • Made the bone muzzle flash duration follow muzzle-flash.duration from configurations (set to 1 for fast automatic weapons to trigger a proper blinking effect).
• Custom Animation Sound & Blockbench Timeline Sync:
  • Added support for custom sounds inside animation configurations using a clean, structured YAML map format.
  • Uses the seconds key to specify delay offsets matching Blockbench timeline keyframes.
  • Interruption safety: cancels scheduled sounds instantly if the animation is interrupted (e.g. reloading, swapping weapons).
  • Auto-speed adaptation: dynamically scales sound delays to match the animation's active speed multipliers.

• Added a beautiful custom ASCII art logo on server startup.
• Added show-always: true feature in config.yml to keep the crosshair visible at all times (even without holding a gun), and it still hides properly when zooming.
• Added English & Thai descriptions in the config file.

• Added hold-on-last: true support for holding animation at its last frame.
• Added smooth (smooth-in) and smooth-out transition tick settings.
• Fixed a bug where weapon models wouldn't load/play equip animation when spawned directly into the hand slot.
• Updated default model config files and wiki documentation.