Cocos Creator 3.1.1 is released!

Cocos Creator 3.1.1 is released

What’s new!

Cocos Creator 3.1.1 mainly fixes the stability problems of v3.1 and optimizes the editor workflow. All developers are welcome to use and experience! Please make a backup of relevant files before upgrading! The following is the detailed update content.

Release Notes

Improvements

  • Added the ability to create Prefab resources in the Explorer panel

  • Added a new level manager panel that can be set in batches (Alt + click) to lock the node function (after being locked, it cannot be selected in the scene editor panel)

  • When the property in the property inspector is a non-null type, but has a null value, a new creation function is added

Bug Fixes

  • [EDITOR] Fixed the issue that may report errors when building the Android platform.

  • [EDITOR] Fixed the problem that the command line build using default values ​​could not be successful.

  • [EDITOR] Fixed the problem of some boolean parameter conversion errors when building the command line.

  • [EDITOR] Fixed the invalid modification of Target Api Level when building Android platform.

  • [EDITOR] Fixed the problem that the PNG format image is generated incorrectly when the ETC1 RGB Separate A format and the PNG format are selected at the same time for the compressed texture.

  • [EDITOR] Fixed the issue that after adding skeletal animation events, it cannot be deleted all.

  • [EDITOR] Fixed the selection problem of component track in animation editor.

  • [EDITOR] Fixed the problem that the nodes or components in the nested Prefab referenced in the Prefab will be lost after saving.

  • [EDITOR] Fix the problem that the nodes or components in the Prefab will be lost after saving in the newly added components in the Prefab instance.

  • [EDITOR] Fixed the problem that the collapsed state of the property inspector interface record is invalid.

  • [EDITOR] Fixed the issue of whether to modify the child nodes together after editing the layer property of the node in the property inspector panel.

  • [EDITOR] Fixed the problem that the array in the property inspector panel does not recognize the dragged resource.

  • [EDITOR] Fixed the problem that when the SpriteFrame resource is dragged to the level manager panel to create a node, the layer property of the node is not UI_2D.

  • [EDITOR] Fixed the problem that there is no selected record for the last-level resource in the resource preview panel.

  • [EDITOR] Fixed the problem that the resource manager panel cannot accurately scroll to the internal resources in the folded folder.

  • [EDITOR] Fix the problem that the Joint Texture Layout panel cannot be scrolled.

  • [ENGINE] Fix the problem of incorrect effect of SafeArea component [[#8654]].

  • [ENGINE] Fixed the problem that the time scale of stop is not reset to 0 after calling pause on the audio of the Xiaomi Kuai game platform [[#8636]].

  • [ENGINE] Fix the issue that the audio of Huawei Quick Game Platform gets currentTime as string type [[#8656]].

  • [ENGINE] Fixed the problem that the touch event callback of the LianShang game platform will cause the stuck on the low-end machine [[#8661]].

  • [ENGINE] Fix the problem that touch events are unavailable on the iPad browser [[#8673]].

  • [ENGINE] Fix the problem that the gravity sensor of QQ browser, WeChat mini game iOS terminal, Baidu mini game cannot be turned on or is incorrect [[#8632]].

  • [ENGINE] Fix the problem of CacheManager.clearLRU call error [[#8663]].

  • [ENGINE] Fix the problem that the SubContextView node cannot be rendered due to the modification of the node layer [[#8677]].

Known Issues

  • There is a problem with the keyboard and mouse adaptation of the WeChat PC. We will fix this problem in the next version, or you can manually merge this PR fix: [[#8626]]

  • You need to manually call the Sprite.updateMaterial function after setting the RenderTexture in Sprite, otherwise it may cause image flipping problems on some platforms

  • Checking UseIBL on the scene skybox option may cause the cc_environment binding to be lost. This problem will be fixed in the next version

Downloads

Dashboard for MacOS

Dashboard for Windows

Download Creator from Dashboard

Cocos Dashboard

The Cocos Dashboard serves as a unified downloader and launch portal for Cocos Creator and Cocos Creator 3D engines. Everyone can upgrade and manage multiple versions of Cocos Creator. In addition, unified project management and a creation panel is integrated, which is convenient for everyone to develop projects with different versions of engines at the same time.

Manage projects developed under different versions:

Developer’s can choose to use a different version of Cocos Creator when creating a new project:

Upgrading

Cocos Creator 3.x version has been officially released, version 2.4 will be used as the LTS (long-term support) version, providing continuous updates for the next two years! In 2021, 2.4 will continue to update the version, providing bug fixes and new mini-game platform support to ensure that your project is successfully launched; in 2022, we will continue to provide developers with the key to 2.4 Bug fixes to ensure the smooth operation of online games! Therefore:

  1. Existing 2.x projects can continue to develop without compulsory upgrade to 3.0.

  2. For new projects, it is recommended to use version 3.0 for development. We will continue to optimize the development experience and operating efficiency of 3.0 to support the smooth launch of heavy games of different categories such as 2D and 3D.

Upgrade from version <3.1.0

  • Starting from v3.1, the priority attribute of the UITransform component has been deprecated. If you need to adjust the order of the node tree, please use the setSiblingIndex method. Prior to v3.1, nodes that were created by code and depended on the priority attribute may have inconsistencies in the performance of the node tree. Please adjust them manually.

  • RenderTexture will be inconsistent between positive and negative on different platforms. In order to solve this problem, Creator has added the SAMPLE_FROM_RT macro to the effect. When using RenderTexture, you need to set the SAMPLE_FROM_RT macro to true, and each backend will be uniformly adapted to The correct effect.

Upgrade from version <2.4.5

Cocos Creator 3.x version has been officially released, and version 2.4 will be used as the LTS (long-term support) version, providing continuous updates for the next two years! In 2021, 2.4 will continue to be updated to provide bug fixes and new mini-game platform support to ensure the successful launch of your project; in 2022, we will continue to provide developers with 2.4 key issue fixes to ensure that games that have already been launched Smooth operation! therefore:

  • Existing 2.x projects can continue to develop with peace of mind, without compulsory upgrade to 3.0.

  • If you want to upgrade an existing 2.x project to 3.x due to project requirements, you can use the 2.x resource import tool provided by Creator. This tool will support the perfect import of old project resources and the auxiliary import of codes. Code-assisted import will convert js into ts, add component type declarations, attribute declarations and function declarations. The references of components in the scene will be preserved, and the code inside the function will be imported in the form of comments, which can reduce the developer’s upgrade Difficulty. For detailed upgrade instructions, please refer to the Upgrade Guide.

  • For new projects, it is recommended to use version 3.0 for development. We will continue to optimize the development experience and operating efficiency of 3.0 to support the smooth launch of heavy games of different categories such as 2D and 3D.

The upgrade operation of Cocos Creator to the project is irreversible. Please submit or backup the old version of the project before upgrading. Most projects can usually be upgraded automatically, but because the project is inevitably unique, developers should try and evaluate the new version of the engine in advance according to the needs of the project. In addition, for stability considerations, it is recommended that projects that are about to go online or already online should be carefully upgraded. For detailed upgrade instructions, please refer to the Upgrade Guide. Those who encounter difficulties in upgrading, welcome to give us feedback and we will try our best to assist.

3 Likes

Amazing! Thanks a lot for this update.
Does anyone here knows if this version also fixes the problems with tiled?

Still not possible to build for Android 4.1. Any reasons? It was possible with 3.0 … i am very sad :disappointed_relieved:

1 Like

I am still experiencing the same bugs as the previous version “3.1.0” , i am wondering why is an issue such as game.restart() still crashing on android even if we have reported it in the previous cocos release post :thinking: :thinking: .

Cocos Creator DevTeam:

Please… Fix the tiled component… (and add a snapping tool if you can)