Bug Fixes

• Provided more detailed error messages on incompatible systems
• Fixed the issue of repeated attribute synchronization when health is a non-integer value
• Improved the handling logic of some synchronized attributes
• Fixed rendering issues with translucent faces in encrypted models exported from version 2.2.1 and below
• Fixed the roaming variable synchronization issue for vehicle models
• Fixed crashes caused by other mods extending SlotType
• Fixed the issue where some mods may cause potion effects to be null
• Fixed the issue of async animation updates not working
• Fixed the issue of ysm.in_shield_block_cooldown not working
• Fixed the issue of arrow replacement not working in legacy encrypted models (requires manual cache deletion to take effect)
• Fixed several client crash issues

Performance Optimizations

• Improved the handling logic of some synchronized attributes
• Significantly improved the loading speed of zip models and legacy encrypted models
• Significantly improved the encoding/decoding speed of PNG images
• Optimized model audio processing performance
  • Added server-side config option AcceptSoundFX to optionally disable model audio loading, improving model loading speed and reducing bandwidth usage

Feature Improvements

• Improved UV handling
  • Mainly affects faces with UV size or area of 0
  • Scope: Encrypted models below version 2.2.1 and above version 2.5.4, and all unencrypted models
  • Drafted YSM UV specification: https://www.yuque.com/flrscn/uwdwcf/uap5og621pfqulm3
• Added default texture name placeholder - for the /ysm model set command
• Improved runtime environment detection, displaying a warning window in unsupported environments
• Refined animation update context
• No longer adds Jade information to entities with disabled models
• Updated some language files
• Updated new icons drawn by Blue Rose

Animation and Model Updates

• Added KLUO model

• Default Fox Spirit model optimization and fixes

  • Optimized tacz gun usage animation, no longer causes issues in flight state (Thanks to @Chiyogami)
  • Changed Fox Spirit flight animation to helicopter style (Thanks to @Xiaomomo)
  • Added Large Fox Spirit model (Thanks to @Can't Stand Teacher)
  • Optimized and updated Magic Fox Spirit animation (Thanks to @Starry Sea)

• New Molang variables:

  • Attack swing related Molang:
    • ysm.swinging: Boolean, returns true when the player is swinging
    • ysm.swing_time: Integer, returns the swing count when the player is swinging, usually within 10
    • ysm.swinging_arm: The swinging arm, main hand is 0, off hand is 1
    • ysm.attack_time: Float, attack windup counter; between 0-1, attack triggers when it reaches 1
  • query.rotation_to_camera: Consistent with Bedrock Edition usage, returns yaw and pitch of the player camera view
  • ctrl.tac_fire_mode: Returns the tacz fire mode string
  • ysm.hit_target_id: Returns the block or entity ID pointed at by the mouse cursor
  • ysm.hit_target_type: Returns the target type pointed at by the mouse cursor, returns block for blocks, entity for entities
  • ctrl.bcombat_attack_animation: Returns Better Combat attack animation, note that this animation does not distinguish between main/off hand, additional conditions are needed
  • Immersive Music mod related:
    • ctrl.im_pitch: Pitch, usually between 0-2
    • ctrl.im_volume: Volume, usually between 0-2
    • ctrl.im_current: Level intensity, range 0-1
    • ctrl.im_delta: Time elapsed since last note output (in milliseconds)
    • ctrl.im_time: Time elapsed since playback started (in milliseconds)
  • ctrl.iss_animation: Iron's Spells casting animation

Mod Compatibility

1. Better Combat Mod

Better Combat can currently be implemented through the default swing animation, with no additional dedicated animations for now.

More refined Better Combat animations can be achieved by using ctrl.bcombat_attack_animation Molang with animation controllers.

Fixed several Better Combat compatibility issues:

• Fixed the issue of weapon swinging not triggering animations
• Fixed rendering issues in first-person view when shaders are enabled
• Fixed the issue of swing animation not synchronizing in multiplayer games

2. Immersive Melodies Mod

Added dedicated im.animation.json animation file, containing default animations for 11 instruments.

Added 5 Molang variables related to current music playback for creating dynamic animations.

Thanks to @lucia2048 for creating the music animations.

3. Iron's Spells 'n Spellbooks

Added dedicated iss.animation.json animation file for Iron's Spells casting animations (extensible for compatibility with other addon mods).

Added 1 Molang variable related to current casting animation.

Thanks to @Acreia and @lucia2048 Sea for creating the casting animations.