[Gaeritag]

Description

This pull request introduces customization options for the item swap/equip animation, an instant swap toggle, and fixes a crash related to overlay texture handling in modern versions (26.x).

Features & Improvements

• Swap Animation Speed (swapSpeed): Allows players to adjust the duration/speed of the item re-equip animation (0.1x – 1.0x, default 0.4x). Includes automatic configuration migration from older reequipSpeed entries (config version bumped to 7).
• Instant Swap (instantSwap): Added a toggle to skip the swap animation entirely, instantly displaying the newly selected item in hand.
• Swap Animation Position (swapPositionX, swapPositionY, swapPositionZ): Added position offset sliders (-2.0 to 2.0) allowing players to configure the exact coordinates from which the player pulls the newly equipped item during a swap. Arm orientation (main-hand and off-hand) is automatically mirrored.
• Modern Rendering Fix (26.x): Fixed java.lang.IllegalStateException: PreparedFrame already in use / Texture view does not exist crash caused by RenderUtils.resetOverlayTexture() closing the active OverlayTexture. Pixel data is now reset in-place on the existing dynamic texture instead of replacing the instance.

Related Issue(s)

NONE

How to test

1. Open OverflowAnimations Settings > Items.
2. Navigate to the Swap Animation group:
   • Toggle Instant Swap on and verify switching hotbar slots instantly equips items without playing the pull-down/pull-up animation.
   • With Instant Swap disabled, adjust Swap Animation Speed to verify the animation plays slower or faster.
   • Adjust Swap Position X, Y, and Z sliders and verify the item is pulled into view from the configured offset during hotbar switches.
3. Test both main hand and offhand swapping to verify symmetric positioning.
4. Verify the client boots and renders properly in 26.x without crashing during frame preparation or entity damage tinting.

Release Notes

Add swap animation speed and swap position customization
Add instant swap toggle
Fix crash in 26.x caused by overlay texture invalidation