LayaAir 3.3.1 Engine Library

更多版本日志以及IDE的下载，请前往LayaAir官网：https://layaair.com/#/engineDownload

Bug Fixes

Engine

1. Fixed the bug where video textures could not be used in the native-windows installer package.
2. Fixed the bug where post-processing effects were incorrect when using openGL in the native engine.
3. Fixed the bug where looped background music in the published Android apk only looped a small initial segment.
4. Fixed the bug where volume settings were ineffective when replaying background music.
5. Fixed the issue of incorrect pixel color picking in Alipay Mini Games.
6. Fixed the bug where 2D post-processing glow effect caused UI position offset.
7. Fixed the bug where 2D post-processing effect was oddly cropped on real devices.
8. Fixed the bug where dynamically added nodes with 2D post-processing did not display content on the stage.
9. Fixed the bug where child nodes appeared incomplete when parent node had 2D post-processing applied while children were skewed.
10. Fixed the bug where removing a 2D node caused post-processing effect errors.
11. Fixed the bug where stage scaling caused incorrect coordinates in 2D physics raycasting.
12. Fixed the reference count bug in spine component (Spine2DRenderNode) mesh.
13. Fixed the bug where spine animation opacity could not be modified in real-time.
14. Fixed various rendering anomalies caused by memory cleanup or other issues in spine animations.
15. Fixed the bug where switching spine resources could cause VRAM overflow.
16. Fixed the bug where resetting the source of a playing spine and delaying play caused errors.
17. Fixed the bug where sprite matrices used in spine did not include anchor offset (after fix, sprite's (0,0) is always the origin, following sprite position).
18. Fixed the bug where timeline animations triggered events that were not reached.
19. Fixed the bug where 2D timeline animations could not loop.
20. Fixed the bug where animations with total frames less than FPS would stutter.
21. Fixed the bug where looping animations shorter than 1 second would stay on the last keyframe until 1 second.
22. Fixed the bug where parent node alpha did not affect masked child node alpha.
23. Fixed the bug where Laya.Scene.gc() could not clear resources.
24. Fixed the bug where Area2D offset caused mouse detection area to misalign with original UI position.
25. Fixed the bug where program blueprints overlapped when copied.
26. Fixed the bug where 2D particles with Simulation Space set to world mode emitted from incorrect positions.
27. Fixed the bug in classic UI system where repeatedly copying a panel container and changing scrollbar type caused incorrect scrollbar type values.
28. Fixed the bug where drawing rounded rectangles with rotated nodes resulted in straight corners.
29. Fixed the display bug of graphics drawCircle when scaled.
30. Fixed the bug where setting a 2D camera as main camera caused 2D physics collision shapes to be offset.
31. Fixed the bug where 2D rigidbody circular collision shapes displayed anchor at (0,0).
32. Fixed the batch processing anomaly of UI material.
33. Fixed the bug where text components on mobile devices with width over 2048 were not fully displayed.

IDE

1. Fixed the bug where tileMap edges could not be edited in IDE viewport when zoomed in.
2. Fixed the bug where modifying tileMap in prefabs could not be dragged and edited in scene.
3. Fixed the bug where alternative tiles created by tileMap had incorrect flipping.
4. Fixed the bug where 2D physics helper lines displayed incorrectly at resolutions other than 100%.
5. Fixed the bug where ogg resources could not be dragged into audio nodes.
6. Fixed the bug where 2D shader changes did not immediately take effect in the scene.
7. Fixed the bug where objects with masks could not be hidden by clicking the eye icon in scene editor.

New Features and Optimizations

1. Added: Refactored the statistics system. IDE now supports customizable statistics display and engine provides interfaces for custom statistics. Developers can freely choose what to display and organize.
2. Added: 2D DrawCall auto-optimization feature.
   1. The new 2D system supports dynamic batching: consecutive elements meeting certain conditions (e.g., from the same atlas, same material) are automatically merged into a single DrawCall (DC).
   2. LayaAir will adjust objects with the same material to consecutive rendering order without changing final display, allowing dynamic batching. This adjustment is transparent to developers.
   3. Enabled via node property DrawCallOptimize; all child and grandchild nodes of the node will be automatically merged. Note: when element count exceeds ~500, CPU usage may increase.
3. Added: Text/Label (classic UI)/GTextField (new UI) has a "single-character rendering" option. When enabled, identical characters of same size share one cache globally, reducing memory and performance overhead for dynamic text.
4. Added: Sprite now has zIndex property to control rendering order. Higher zIndex renders on top. By default, this order is global. When stackingRoot = true, zIndex only affects internal rendering order.
5. Added: Classic UI layout containers HBox/VBox now support autoSizeMode and skipHidden options for automatic layout.
6. Added: 3D scene viewport coordinate axis widget with quick keys for front, back, left, right, top, bottom views (Ctrl+Shift+1 to Ctrl+Shift+6).
7. Added: Timeline panel now supports selecting all keyframes vertically below the clicked frame when holding Ctrl+Shift.
8. Added: TileMap can now be dragged with middle mouse button for editing.
9. Added: TileMap editing now supports Ctrl+Z undo and Ctrl+Y redo.
10. Added: Third-party TiledMap exports now support CSV format.
11. Added: Audio resources can be dragged into the hierarchy panel to create audio nodes directly.
12. Added: Blueprint panel now supports custom shortcuts; developers can assign keys to frequently used panels.
13. Optimized: Blueprint materials now support Chinese.
14. Optimized: Animation state machine parameter panel now uses input fields for parameter names, avoiding confusion about editing.
15. Optimized: Refactored native engine audio playback.
16. Optimized: Improved list and panel component property panel display in IDE.
17. Optimized: Refactored 2D physics helper lines to no longer depend on Line2D library, avoiding errors when Line2D is not checked.
18. Optimized: Native installer now prompts network error if no connection on startup.

LayaAir 3.3.0 Engine Library

更多版本日志以及IDE的下载，请前往LayaAir官网：https://layaair.com/#/engineDownload

Engine Updates

New Features

1. Added 2D navigation pathfinding components, such as static navigation surfaces and agent pathfinding.
2. Added 2D lighting and shadow components, including directional light, sprite light, free-form light, spotlight, and light occluder.
3. Added 2D renderer components, such as mesh, trail, line, and tilemap layers.
4. Added a 2D particle system.
5. Added 2D camera.
6. Added 2D area node.
7. Added full support for 2D custom shaders. Previously, only custom materials were supported in 2D.
8. Added brand-new tile map; the old TiledMap is now deprecated and not recommended, but still temporarily compatible.
9. Added Windows platform custom extensions. Developers can use LayaAir's extension tools to generate dynamic libraries to extend project functionality, such as Steam integration.
10. Added 2D global lighting properties: lightDirection, ambientColor, ambientLayerMask, multiSamples, order, antiAlias, lightMode, sceneMode, and shadowDistance.
11. Added normal map support (normalTexture) for 2D mesh renderer.
12. Added position property setting to 2D physics rigid bodies.
13. Added Additional rendering architecture supporting material batching based on BaseRender. Material batching reduces draw calls and improves GPU performance by merging render data for objects sharing the same material.
    Example: Two hundred spheres with different colors rendered with only one draw call.
14. Added support for Spine 4.2 runtime library, allowing physical properties on Spine animations.
15. Added get position and get rotation for 2D rigid bodies, with coordinate conversion from world to local space.
16. Added mixed layout of text and frame animation, e.g. <img src='animation.atlas'>.
17. Added percent property to graphics.drawCircle.
18. Added compound colliders and sleep detection for 3D physics.
19. Refactored 2D rendering with a brand-new architecture. Static graphics performance increased by over 200%, dynamic graphics by over 50%.
20. Added zIndex optimization. In a test with 4000 composites and 12,000 sprites, FPS improved from 4 to 60.
21. Added material UBO-based instance batching, enabling batching even with many variables (Note: requires platform UBO support).
22. Added 2D post-processing effects.

Feature Optimizations

1. Refactored the Tween system:
   • Compatible with Laya.Tween.to / Laya.Tween.from, but new Tween() is no longer supported.
   • Supports number, Vector2/3/4, Color, Point, and string color values.
   • Lightweight Tween objects, no reuse by default to avoid confusion.
   • Avoids using Handler to prevent handler reuse issues.
   • Supports richer options and serial/parallel tasks.
2. Optimized 3D UI with camera-locked mode, suitable for VR UIs.
3. Further modularized the engine library for minimal builds, helpful for ad demos.
4. Optimized particle compilation with mulShaderDefineMode setting in ShuriKenParticle3DShaderDeclaration.
5. Refactored 2D sequence frame player Animation, simplified interface, added new component FrameAnimation.
6. Improved WebGL performance under Native.
7. Improved new UI system: image components now support flipping, fill progress, circular clipping, etc.
8. Added a Gears button to control visibility in the new UI system.
9. Added release-time cleanup for GTextField and GLoader in the new UI system.
10. Added GMovieClip to the new UI system.
11. New UI system now fully supports multi-language (i18n).
12. Fully refactored and open-sourced mini-game adaptation libraries across platforms.
13. Optimized blueprint database with many missing classes/functions added; trimmed during release to reduce size.
14. Refactored Native JS/C++ interaction layer, removed redundant call paths, significantly improved rendering performance.
15. Added mutual masking disable & warnings to prevent display issues.

IDE Updates

New Features

1. Added a new UI system with architecture similar to FairyGUI.
2. Added visual editing for 2D navigation pathfinding.
3. Added visual editing for 2D lighting and shadows.
4. Added visual editing for 2D particle system.
5. Added template creation for 2D custom shaders - basic rendering.
6. Added visual editor for new TileMap (old TiledMap not supported).
7. Added Linux build process and UI.
8. Added definitions for 2D render layer names.
9. Added global settings for 2D lighting in project settings.
10. Added options in engine modules to support both traditional LayaAir UI and FairGUI system, along with modular engine components.
11. Added blueprint support for new UI system.
12. Added support for importing maps (tsx, tmx, tx) made in third-party TiledMap editor into LayaAir3-IDE, auto-converted to internal tileMap format (tres).
13. Added terrainSets accessor in TileSet to define tile connection rules for automatic terrain stitching.
14. Added animation property support to sprite atlases; a regular atlas can now become an animated resource.
15. Added addMenuItem API as an alternative to @menu decorator, supporting default handlers:

    Editor.extensionManager.addMenuItem("Hierarchy/MyPrefab/Button", null,
        { id: "67b6743c-3e75-446c-bdf2-8d1c4e320062" });

16. Added WASM subpackage support in split modules.
17. Added stat info toggle in preview panel.
18. Added source map protection in preview server (enabled by default).
19. Added support for single-page HTML publishing with compression.
20. Added prefab replacement function in node menu, keeping same name and matching property types.
21. Added right-click on property title in inspector to copy, paste, or reset property.
22. Added 2D post-processing effects (replaces filters; old filters still usable via code).
23. Added project config for UI system.

Feature Optimizations

1. Optimized 3D render layer name definitions.
2. Hid unconfigurable properties in 2D particle editor.
3. Added auto-import for 2D line renderer library.
4. Optimized new UI system.
5. Enhanced menu shortcut customization with dynamic key binding.
6. Hierarchy panel now shows image thumbnails for Image and GImage nodes.
7. Improved appearance and positioning of drawing-related buttons.
8. Unified 2D and 3D physics usage:
   • Removed 2D collider component; now added to rigid body.
   • Added static collider for static bodies.
   • Rigid body no longer supports static type directly.
9. Optimized showall mode to avoid canvas overdraw on PC browser zoom-out; adjusted full mode to prevent UI clipping.
10. Exposed animation state machine events (OnStartEnter, EVENT_OnStateUpdate, EVENT_OnStateExit, EVENT_OnStateLoop) for better animation logic control.
11. Centered prefab preview display for better visibility even if origin is offset.
12. Improved new UI system with quick prefab creation entries under Tools menu (usable for plugin UI too).
13. Optimized WebIFrame class in plugin system to avoid reload on tab switch.
14. Fully refined the FairyGUI-based new UI system.
15. Optimized blueprint system for better stability and usability.

LayaAir 3.2.7 Engine Library

更多版本日志以及IDE的下载，请前往LayaAir官网：https://layaair.com/#/engineDownload

BUG Fixes

Engine

1. Fixed a bug where the Box2D wasm version could not be used in Android installation packages.
2. Fixed a bug where destroying unused resources would prevent button state switching.
3. Fixed a bug where s_Blend set to 2 conflicted with s_BlendDstRGB, causing native Android crashes.
4. Fixed an issue where moving the camera to follow a moving object in physics caused jittering.
5. Fixed an error in time update calculation when 3D physics steps were greater than 0.
6. Fixed an error in parsing render states of 3D materials.
7. Fixed a memory overuse bug in Spine animations caused by multiple bones and multiple animations.
8. Fixed the issue with text ellipsis in Text.
9. Fixed a bug where HttpRequest.send() in the Edge browser sometimes concatenated headers incorrectly.
10. Fixed an issue when adding scenes with multiple character controllers.

IDE

1. Fixed an issue where modified custom type objects registered in scripts did not refresh promptly in the IDE.
2. Fixed a stack overflow bug when the camera's RenderTarget color format included an Alpha channel.
3. Fixed a bug where the alignment function did not consider the pivot.
4. Fixed an issue where selecting nodes from the hierarchy panel did not preserve selection order.
5. Fixed incorrect key-value pairs in the WeChat publishing description file.
6. Fixed an issue with right-click menu search positioning in the blueprint editor.
7. Fixed a bug where files with spaces could not generate thumbnails.

New Features and Optimizations

1. New: Added support for publishing as a single-page HTML file.

2. New: Optimized physics simulation update and added isGrounded method for 3D character controllers to get ground state.

3. New: Added support for compressed texture publishing on platforms like Alipay and Taobao for iOS.

4. New: Added support for setting width and height by percentage when filling textures in 2D drawing.

5. Optimization: Changed connstant in startRotationConstantSeparate of 3D particles in the IDE property panel to use degrees (still in radians in code).

6. Optimization: Improved event dispatching for physics components.

LayaAir 3.2.6 Engine Library

更多版本日志以及IDE的下载，请前往LayaAir官网：https://layaair.com/#/engineDownload

BUG Fixes

Engine

1. Fixed the bug with the initial anchor point of the 2D physics mouse joint.
2. Fixed the issue with rendering element updates in the skybox renderer.
3. Fixed the assignment bug of the camera's SkyRenderElement.
4. Fixed the memory leak issue in particle effects.
5. Fixed the crash bug when packaging for Android x86 architecture.
6. Fixed the issue of certain nodes not displaying after Android packaging.

IDE

1. Fixed the bug that caused a rendering error in the scene after closing a prefab in the IDE.
2. Fixed the bug where the 3D particle shader template created in the IDE differed from the engine's built-in particle shader.
3. Fixed the calculation error of joint line positions in 2D physics when a rotation value is set on a node.
4. Fixed the bug where a gear joint bound to a non-first joint of its node caused issues.
5. Fixed the bug that caused errors when resetting IDE joint components (prismatic, motor, pulley, distance).
6. Fixed the bug where the shader importer incorrectly added nullable=true by default when handling uniforms.
7. Fixed the bug where Backspace could not delete keyframes on Mac.
8. Fixed the error that occurred when selecting over a thousand images.
9. Fixed the issue where an extra checkbox was shown in the material panel for custom shader scripts.
10. Fixed the issue where shader.json was not recognized in Alipay mini games.

New Features and Optimizations

1. Added: Support for changing the component addition order in the IDE.
2. Added: Platform icons have been added to the build and publish interface for all platforms, making platform differences easier to identify.
3. Optimized: Gear joints are now limited to binding with prismatic and revolute joints to prevent errors caused by incorrect joint types.
4. Optimized: The initial rotation constants of the 3D particle system in the IDE are now input and displayed in degrees (still radians in code).
5. Optimized: Added filtering for connected joint types in gear joints to enhance robustness.
6. Optimized: Compressed the default skybox image size.
7. Optimized: Export user-defined extension name conversion configurations to the engine during publishing.
8. Optimized: Added a favicon to the IDE preview server.

LayaAir 3.2.5 Engine Library

更多版本日志以及IDE的下载，请前往LayaAir官网：https://layaair.com/#/engineDownload

BUG Fixes

Engine

1. Fixed a bug where the dynamic Nav Mesh Modifier Volume became invalid due to incorrect bounding box min values.
2. Fixed errors with 3D physics composite collider shapes, character controller friction settings, and incorrect PhysX method usage.
3. Fixed a bug where using scrollRect with scaled Sprites caused incorrect globalToLocal calculations.
4. Fixed the issue where camera viewport ray conversion did not take pixel ratio into account.
5. Fixed the issue where modifying SkinnedMeshRender's LocalBounds value did not immediately redraw the bounding box wireframe.
6. Fixed a bug where setting cacheAs caused an incorrect invertY state, leading to 3D-UI masks flipping when changing width and height.
7. Fixed a bug where adding multiple instances of the same prefab under the same hierarchy with Spine effects caused filter effects to incorrectly affect other objects.
8. Fixed a bug where background music set to loop in a packaged android-apk would only play once.
9. Fixed a bug where the rendering order of certain 3D nodes in a packaged android-apk was incorrect.

IDE

1. Fixed a bug where during IDE preview runtime, destroying a 3D rigidbody’s collider caused continuous fd_write errors, leading to a dead loop and IDE freeze.
2. Fixed a bug where after animation baking, animation node names identical to prefab resource names were mistakenly recognized as resource paths, causing some mesh animations to be lost after publishing.
3. Fixed a bug where after deleting a script in the runtime input field, the missing reference warning could not be cleared properly.
4. Fixed a bug where after opening a Panel in the scene view, the scroll area did not enlarge according to the Panel’s content.
5. Fixed a bug where the preview view became unusable after encountering a GUEST_VIEW_MANAGER_CALL error caused by infinite loops or certain user code conditions.
6. Fixed several bugs related to Program Blueprint:
   • Fixed the real-time refresh issue after blueprint data changes.
   • Fixed incorrect array connection validation.
   • Fixed the Type list to be sorted in ascending order.
   • Fixed mouse dragging of nodes where movement was not smooth and gradually became offset.
   • Fixed the issue where calling as on a base class incorrectly executed the base method instead of the actual overridden method.
   • Fixed the inability to use Node.addChild within blueprints.

New Features and Optimizations

1. New: Added support for setting the allow-sleep attribute in 3D physics.
2. New: Added support for MCP (Model Context Protocol) standard, providing developers with extensible secondary development interfaces. Developers can create custom Tool tools and Prompt modules for MCP clients like Claude and Cursor to invoke.
3. New: Enhanced Program Blueprint, including:
   • Added support for function overloading in blueprints; variables in blueprints can now define constraint attributes such as isAsset, assetTypeFilter, fractionDigits.
   • Improved link validation logic for generics.
   • Added copy and paste options to the node right-click menu.
   • Optimized search logic in the right-click menu.
4. Optimization: In the hierarchy panel, after searching for a node name and selecting a node, exiting search will automatically expand to and highlight the selected node.
5. Optimization: Adjusted the display position of prefab previews to avoid inconsistency between edit-time and run-time preview when anchor points are set.
6. Optimization: The canvas for rendering text is no longer width-limited, preventing issues where overly long text (exceeding 2048 in width or height) gets clipped.
7. Optimization: Deprecated the APIs for setting up-axis and jump speed in the 3D physics character controller (alternative APIs are available), to avoid developer confusion.

LayaAir 3.2.4 Engine Library

更多版本日志以及IDE的下载，请前往LayaAir官网：https://layaair.com/#/engineDownload

Version 3.2.4 Release Changelog

Bug Fixes

Engine

1. Fixed a bug where the random number sequence for some emission shapes was not fixed when the automatic random seed was not selected in the 3D particle system.
2. Fixed a bug where the 2D physics velocity became faster when clicking a node in the IDE hierarchy panel during preview runtime.
3. Fixed a bug where switching to different types caused errors after IMAGE resources were destroyed due to lost resource types.
4. Fixed a bug where text input in the Native Windows package was not functional.
5. Fixed a bug where text and images appeared blurry in the Native Windows package.
6. Fixed a bug where changing mesh vertex data of a 3D node did not update the display.
7. Fixed a bug where input text occasionally had a background color due to the reuse of Graphics drawing commands.
8. Fixed a bug where the GraphicsBounds might not refresh after the drawing commands were updated.

IDE

1. Fixed a bug where the color setting for the FillTexture drawing command was invalid.
2. Fixed a bug where cascading failed if EnumField was a numeric type.
3. Fixed a bug where the up and down arrow functionality in the hierarchy panel became invalid after renaming using F2.
4. Fixed a bug where the image release compression format might incorrectly include the source file.

Additions and Optimizations

1. Decoupled the engine library reference relationships, solving the issue where .glsl files could not be loaded if the 3D core module was not checked in the IDE.
2. Added the mulDefine macro configuration setting in ShurikenParticleShaderDeclaration, allowing developers to choose whether to enable it, optimizing shader compilation efficiency in different scenarios.
3. By default, the texture source file option is checked when publishing on Douyin and WeChat platforms to avoid confusion for developers.
4. Upgraded the API documentation website with a brand-new interface, supporting both light and dark modes (URL: https://layaair.com/3.x/api/index.html).
5. Added a shape editing tool button for 3D physics colliders and optimized the display of component properties and descriptions for 3D physics components.
6. Removed deprecated parameters from OPPO (which caused errors).
7. Removed the restriction on the required suffix when publishing to the vivo platform (vivo platform update).
8. After publishing a vivo mini-game, command-line QR code debugging is now supported.

LayaAir 3.2.3 Engine Library

更多版本日志以及IDE的下载，请前往LayaAir官网：https://layaair.com/#/engineDownload

Version 3.2.3 Release Changelog

Bug Fixes

Engine

1. Fixed a rendering error when all slot.alpha values in a Spine animation are set to 0, and an issue with the last frame not updating correctly.
2. Fixed the incorrect playState return after a non-looping Spine animation finishes playing.
3. Fixed an issue where enabling fast rendering in Spine caused rendering to freeze on the first frame after playback in certain scenarios.
4. Fixed inconsistencies between Spine editor effects and engine rendering under specific conditions.
5. Fixed incorrect brightness when using additive blending in Spine.
6. Fixed errors in Spine under WebGPU mode when sceneData is null.
7. Fixed an issue where child node scripts continued executing after the parent node was disabled and the child node was removed.
8. Fixed an issue with HTML text formatting where overflow handling and truncation with ellipsis displayed abnormally.
9. Fixed a bug where frequent changes to button skins could cause display confusion.
10. Fixed unit conversion issues when retrieving linear velocity for 2D rigid bodies.
11. Fixed an error when enabling 2D rigid bodies.
12. Fixed an issue where canvas transparency settings were ineffective.
13. Fixed incorrect masking effects when mask nodes were rotated.
14. Fixed an issue where setting texture repeat on PBR materials with non-power-of-two textures was ineffective.
15. Fixed incorrect video texture effects in the native engine.
16. Fixed the bug where the ray function modified the input values.

IDE

1. Fixed incomplete display of a polygon set as a mask node in the scene panel of the IDE.
2. Fixed an error in the atlas creation tool when texture scaling was set to 0.8.
3. Fixed an error during undo (Ctrl+Z) after deleting a polygon point using Alt.
4. Fixed an error when converting a text node to a label node.
5. Fixed an issue where multiple settings of Constant in timeline animations could not be saved.
6. Fixed an issue where new vertices could not be added to the last edge of a polygon in the scene editor.
7. Fixed an issue where the Tree component's tree node rendering callback was triggered twice.
8. Fixed an issue where replacing images in prefabs displayed correctly in preview but not after publishing.
9. Fixed an issue where the 2D scene editing area would not display in certain scenarios.
10. Fixed a bug where the order of serialized properties for prefab root nodes differed from the definition order.
11. Fixed an error when extracting template files with a large number of compressed files, causing decompression failures on some computers.
12. Fixed an issue on macOS where the Command+Option+I shortcut remained occupied by the IDE even when it lost focus, preventing the same shortcut from being used in other applications.
13. Fixed an issue where more than 30 scenes in the build and publish settings could not be displayed.
14. Fixed a bug in the texture processing tool where scaling to a power of two was skipped.

Additions and Optimizations

1. Optimized a series of resource memory recycling issues, thanks to detailed feedback from the community developer (ID: codetypes).

2. Optimized particle compilation duration by adding the mulShaderDefineMode configuration to the ShuriKenParticle3DShaderDeclaration class. When set to true, it enables multi-macro mode, reducing single-particle compilation time but increasing macro variables and shader count. When set to false, it disables multi-macro mode, increasing single-particle compilation time but reducing macro variables and shader count.

3. Disabled setting button state color transparency in the IDE to prevent developer misuse.

4. Added the maxDeltaTime interface to Spine, allowing developers to remove playback speed limits when controlling playback speed via Laya.timer.scale.

   It is recommended to use playbackRate() to control playback speed instead of modifying Laya.timer.scale for Spine playback.

LayaAir 3.2.2 Engine Library

更多版本日志以及IDE的下载，请前往LayaAir官网：https://layaair.com/#/engineDownload

Version 3.2.2 Release Changelog

Bug Fixes

Engine

1. Fixed the issue where using play("specific animation name") to play a specific animation in Spine was ineffective.
2. Fixed the issue where applying multiple filters or alpha settings on a node caused it to not display or rendered Spine effects invalid.
3. Fixed the issue where setting the position of a CharacterController immediately after addChild resulted in delayed effect.
4. Fixed the issue where enabling "color over lifetime" in the 3D particle system affected animation movement.
5. Fixed the issue where using drawTriangle prevented drawTexture from rendering images.
6. Fixed the issue where condition transitions in 3D animation failed in CrossFade state.
7. Fixed the issue where setting the viewport of a camera caused 3D UI to be unclickable.
8. Fixed the issue of rendering layer errors for transparent materials on native platforms.
9. Fixed the issue where calling getRenderTextureData on native platforms resulted in a "not found" error.
10. Fixed the issue where rich text with img tags displayed image-text layout inconsistencies.
11. Fixed the issue where cone shapes failed to perform proper collisions.
12. Fixed the issue where TiledMap and Spine animations failed to correctly handle occlusion.

IDE

1. Fixed the issue where shader code generated by Blueprints was out of sync with the engine.
2. Fixed the issue where pressing Ctrl + to zoom in on the 2D stage in the IDE did not work on the numpad.
3. Fixed the issue where dragging a property icon from a non-input field in the property panel to the left was ineffective.
4. Fixed the issue where modifying shaders did not immediately refresh the material panel.
5. Fixed the issue where cone shapes failed to perform proper collisions in the IDE.

Updates and Optimizations

1. New: Opened IDE's built-in icon resources for direct use by plugins.
2. New: Automatically opens the export directory after exporting resource packages locally, making it easier for users to locate the packages.
3. New: Added support for importing local templates. Developers can export frequently used project resources or code templates as a zip package, share it with team members, and create new projects using custom local templates.
4. New: Added support for WebP format textures.
5. New: Resource Store now features a plugin for creating 2D nodes and UI elements, allowing developers to manage created objects based on resource names or extensions, and initialize property values.
6. New: IDE now supports loading .mjs JavaScript files as modules if defined as plugins.
7. New: Added a compression option under "Project Settings -> Script Compilation -> Release Version," allowing users to exclude the removal of unused variables and functions, preventing runtime errors in certain third-party libraries after compression.
8. Optimized: Switched the HarmonyOS v8 engine in Native to the jsvm engine.
9. Optimized: Improved API examples and official demos, fixing errors in the 2D physics collision filter example caused by outdated interfaces.
10. Optimized: Enhanced the Resource Store's action baking plugin to terminate baking and provide alerts when the skeleton count exceeds 255, helping developers identify issues.
11. Optimized: Added error prompts for missing component scripts.
12. Optimized: Improved the project settings interface.
13. Optimized: Enhanced the build and publish interface.

LayaAir 3.2.1 Engine Library

更多版本日志以及IDE的下载，请前往LayaAir官网：https://layaair.com/#/engineDownload

Version 3.2.1 Release Changelog

Detailed description of the new features in version 3.2:

https://mp.weixin.qq.com/s/wAf1dShrZBa1LNal8AH8GQ

https://mp.weixin.qq.com/s/vkSsOk-0PERFSaSoZF-5cA

BUG Fixes

Engine

1. Fixed a bug where the position of UI objects under a 2D parent node using filters did not match the actual position.
2. Fixed a bug where text displayed incorrectly in child nodes when DrawCallOptimize was set for a Box containing multiple text components.
3. Fixed a bug where setting different scales on spine caused incorrect display when setting rotation.
4. Fixed a bug where spine animations might flicker when switching actions repeatedly.
5. Fixed a bug where filters applied to spine animation nodes caused them not to display.
6. Fixed a bug where using blended color filters in spine 4.0 led to incorrect import effects in the IDE.
7. Fixed a bug where static collision groups for prefabs resulted in incorrect collision body positions when placed in the scene.
8. Fixed a bug where collider properties set in prefabs did not take effect.
9. Fixed an anomaly in rigid body simulation under the Physx physics engine.
10. Fixed a bug that caused a white screen in the Taobao mini-game adaptation library in certain cases.
11. Fixed a bug where 2D animations targeting Graphics played correctly in the IDE preview but failed in the browser.
12. Fixed a bug where PixelLine colors were incorrect.
13. Fixed a bug where the nodeCommonMap was not cloned when recording Shader variant data.
14. Fixed a bug in the Android file extension mechanism.
15. Fixed a bug that caused crashes when running released Android packages in certain cases.
16. Fixed a problem in the iOS packaging environment where background music could not be switched and there were dependencies on 3D libraries in 2D projects.
17. Fixed a bug with precompiled shaders in the Native installation package.
18. Fixed a bug where resources would still be downloaded over the network after packaging with DCC in Native release.

IDE

1. Fixed a bug where property tips for expanded items in the IDE did not display.
2. Fixed an issue where deleting the last point in the gradient color editing panel caused an exception.
3. Fixed a bug where enabling worker loader led to web packaging failures.
4. Fixed a bug that resulted in decimal coordinates appearing in certain operations.
5. Fixed a bug where changing the center point position and box size of BOX type NavMeshObstacles did not reflect correctly in the editor.
6. Fixed a bug where entry scripts for subpackages did not participate in version management when building for Web and other non-mini-game platforms.

Optimizations

1. New: Support for wasm library adaptation on Douyin mini-games, OPPO, and vivo platforms.
2. New: Automatically convert spine nodes in older version scene files to the 3.2 spine component.
3. New: All plugin system APIs have been supplemented with comments; please update usage through “Developer Menu -> Update Engine d.ts”.
4. New: Added shortcut key settings for file tags such as "Close" and several other operations.
5. Optimization: Ensure text formatting does not place punctuation at the start of a line.
6. Optimization: Improved the gradient color editing panel and particle gradient color settings with compatibility for single values; added copy and paste for gradients and curves.
7. Optimization: Removed support logic for LayaAir2 data formats in the engine; for upgraded old projects that need to dynamically load LayaAir2's ls and lh files, check the laya.legacyParser library in the IDE's engine module options.
8. Optimization: When adding scenes in the general settings for IDE build publishing, duplicate additions will be filtered out.
9. Optimization: In the IDE property panel, when the displayed quantity of array and dictionary elements exceeds a certain number, a "More" button will appear to optimize performance.
10. Optimization: Added a prompt when the same vertex in spine has more than four bones (the fast rendering optimization scheme for spine cannot be used).
11. Optimization: When opening a resource interface in the package manager, an active refresh request is added to help users check if the resource has an upgraded version.
12. Optimization: Improved the smoothness and fluidity of operations like translation and rotation in the scene.

LayaAir 3.2.0 Engine Library

更多版本日志以及IDE的下载，请前往LayaAir官网：https://layaair.com/#/engineDownload

Version 3.2.0 Release Changelog

Bug Fixes

Engine

1. Fixed the issue where 3D video textures were displayed incorrectly on the Native Android platform in OpenGLES mode.
2. Fixed the error caused by the unsupported spine.PathAttachment.
3. Fixed the bug where a part of the image was missing, and the animation could not play after using path constraints in Spine.
4. Fixed the display anomaly when the number of Spine bones exceeded 100.
5. Fixed the error in Spine caused by using the loading timing in the onEnable lifecycle.
6. Fixed the flickering issue in Spine animation frames.
7. Fixed the position offset bug caused by setting both filters and anchor points simultaneously.
8. Fixed the bug where video nodes could not play in Native standalone packages.
9. Fixed the bug where the 3D navigation navAgent.getCurrentPath() interface reported an error.
10. Fixed the bug where the engine would freeze if the nine-slice data was unreasonable.
11. Fixed the bug where the first click on a PC touch screen triggered onmouseclick twice.
12. Fixed the bug where setting the speed of a 2D animation to a negative value caused incorrect event calls.

IDE

1. Fixed the issue with particle curve editing.
2. Fixed the bug where selecting multiple UI components and dragging them to change the X/Y values of the bounding properties in the properties panel would misplace the UI components.
3. Fixed the bug where FBX animation files exported from 3D Max could not play because the start time was not at frame 0.

Updates and Optimizations

1. New: Added the strikethrough text feature.

2. New: Added a package manager.

   Note: Package manager import and management is supported only when the package contains package.json and has the relevant fields configured.

3. New: Added the ability to set the entry function:

   Note: This script must export a function named main. After the engine initializes, this function will be called directly, and the default scene will not be opened. Developers can decide which scene to open within the entry function.

4. New: Added support for using the engine's WASM library on the WeChat Mini Game platform.

5. New: Added support for scene hooks, allowing custom logic insertion in specific processes like creating, loading, or saving objects in the scene. For example, if you want the pivot of all newly created UI nodes to initialize at (0.5, 0.5), you can write a plugin like this:

   @IEditorEnv.regSceneHook()
   export class TestSceneHook implements IEditorEnv.ISceneHook {
       //载入场景后调用
       onLoadScene() {
       }
   	//保存场景后调用
       onSaveScene(scene: IEditorEnv.IGameScene, data: any) {
       }
   	//新建节点对象后调用
       onCreateNode(scene: IEditorEnv.IGameScene, node: Laya.Node) {
           
           if (node instanceof Laya.Sprite)
               node.anchorX = node.anchorY = 0.5;//初始化锚点
       }
   	//场景中创建组件后调用
       onCreateComponent(scene: IEditorEnv.IGameScene, comp: Laya.Component) {
       }
   }

6. New: Added the option to include or exclude source code when generating source maps during release.

7. New: The script collection feature now correctly isolates the code between different script collections. During development, scripts from different collections can be imported directly. The IDE will automatically convert these imports into indirect references during compilation to achieve bundle splitting.

8. New: Script collections can now choose whether to load before the main script collection.

9. New: The release interface now supports setting the main package as remote.

10. New: Spine resources can now be dragged directly from the asset library to the hierarchy or scene, automatically creating Spine render nodes and Spine components.

11. New: Added support for preset texture types. Since the default value sets imported textures as 3D textures, for 2D projects, this can be changed to sprite textures, eliminating the need for manual adjustments. UI components can now automatically recognize them as 2D sprite textures.

12. Optimization: When using the 2D empty project template, the default texture type is automatically adjusted to sprite texture, making it more user-friendly.

13. Optimization: After adding engine components, the corresponding engine libraries are automatically referenced to avoid runtime errors caused by missing engine libraries.

14. Optimization: Added destruction detection for Spine nodes to prevent errors caused by asynchronously loading already destroyed nodes.

15. Optimization: Performance improvements for handling a large number of files when using caching on the WeChat Mini Game platform.

16. Optimization: Improved the efficiency of Native standalone packages, reducing the initial black screen time.

17. Optimization: Resource management no longer generates meta files for all files in node_modules folders or files and folders ending with “~”.

18. Optimization: If developers choose to use WASM libraries from the engine modules, such as physics and navigation, the platform will automatically switch to the corresponding pure JS library for platforms that do not support WASM.

19. Optimization: The build task interface has been changed from a dialog box to a panel.

3.2.0-beta.3 Changelog

Update Date: 2024-08-27

Bug Fixes

Engine

1. Fixed an issue where a Spine animation within a Box would be occluded when another Spine animation was present on the Box.
2. Fixed the discrepancy between Spine animations in LayaAir and previews in SpineTrial.
3. Fixed a bug where Spine effects would not scale in certain situations.
4. Fixed an issue where the official Cannon physics engine plugin could not add a 3D rigid body in the IDE under certain conditions.
5. Fixed a bug in the 3D physics engine where spheres would slide but not roll on slopes.
6. Fixed a bug in the 2D physics rigid body component where the linear velocity was not converted to pixel units.
7. Fixed a compatibility issue in version 3.1 where particles using the default ParticleShuriken shader would not render.
8. Fixed a shader error in WebGL1 for particles.
9. Fixed a memory leak in 3D UI caused by the context initialization holding a Texture2D.
10. Fixed an issue with abnormal shadow rendering in WebGPU mode.
11. Fixed a memory leak caused by continuously updating masks.
12. Fixed a bug in the beforeInit method related to the newly added afterInit method.
13. Fixed a screen tearing issue on certain platforms when caching 2D as a static image.

IDE

1. Fixed an issue where file extensions would change from uppercase to lowercase after enabling version control.
2. Fixed a bug in multi-agent scene pathfinding where adding multiple identical navMesh components to a node would prevent them from being fully baked.
3. Fixed an issue where exiting the timeline animation and clicking the close button on the popup did not return to the editing interface.
4. Fixed an issue in the plugin system where creating two radio buttons using the IEditor.Menu.create interface would only allow one selection and prevent a second selection.
5. Fixed a bug where the IBuildPlugin.onCollectAssets interface in the plugin system was not called during the build process.

Major New Features

1. Added a visual programming module (Blueprint).
2. Added support and build publishing for the HarmonyOS NEXT platform.

General Updates and Optimizations

1. Removed Spine from widgets. Starting from version 3.2, the node mode for Spine is no longer supported and has been replaced with the Spine skeleton animation component.
2. Improved engine performance, especially noticeable in iOS environments.
3. Added useFrame and updateFrame properties to videoTexture for optimizing video playback, addressing video playback stutter issues in the Android WeChat browser.
4. Added support for simultaneous touch screen and mouse operations on laptops that support both inputs.
5. Hid the unsupported destroy array function in the particle emitter to prevent misuse that could cause errors.
6. Deprecated the drawToTexture interface in Sprite, replacing it with the drawToRenderTexture2D interface.
7. Changed the ES5 conversion function in Alipay mini-game publishing to be built into the IDE, no longer using Alipay's converter to prevent large files from being ignored by Alipay.
8. Added a debug log window to the Native mode of Window. The ShowDebugConsole=true option in the config.ini file will display the log window, which is hidden by default.
9. Added support for modifying boolean properties in the 2D timeline animation panel.
10. Added an option to change the layer property of all child nodes when modifying the layer property in the 3D node property panel.
11. Added support for automatic edge adaptation based on polygon shapes in 2D physical polygon collisions.
12. Improved the type property of the custom node in the shader blueprint.
13. Enhanced the novice user experience: a popup will guide users to download the official Visual Studio Code website if VSCode is not installed. Added a Help menu entry for a beginner's guide (development environment and process).

3.2.0-beta.2 Changelog

Update Date: 2024-06-27

Bug Fixes

Engine

1. Fixed a bug where skeletal animation examples would not play in the native environment.
2. Fixed a bug where Windows projects published natively would not run if the path included Chinese characters.
3. Fixed a bug causing crashes in certain cases when running natively.
4. Fixed an issue on native iOS where multi-light source examples displayed abnormally in OpenGLES mode.
5. Fixed an issue on n...