Cocos Creator 3.0 announces the next-generation engine framework with several major updates, a totally new journey for Cocos. As in previous versions, Cocos Creator 3.0 continues with the same advantages of a light and efficient engine we had for 2D projects, together with a complete and efficient experience for hardore 3D games.
3.7.1
17 Feb 2023

Engine

  • Add more API docs (engine#13937, engine#14079, engine#14088)
  • [Optimize] add image asset’s zh i18n (engine#14108)
  • [Optimize] Add pointerlock function for mac platform (engine#14187)
  • [Pipeline] enable custom pipeline in the editor (engine#14084
3.7.0
17 Jan 2023

Cocos Creator 3.7.0 is another milestone on our path of constantly challenging and improving ourselves. In o

3.6.3
11 Jan 2023

In version 3.6.3, we have added support for the Taobao mini program platform and also fixed a series of critical bugs, so we strongly recommend all 3.6 users to upgrade.

 

Changes

 

- Supported Taobao mini program creative interactive platform,r

3.6.2
04 Nov 2022

Important Updates

  • Improved performance of Spine and DragonBones on native platforms 
3.6.1
23 Sep 2022

Cocos Creator 3.6.1 Release Notes

After the release of v3.6.0, we received a lot of feedbacks from developers about user experience, performance, issues and so on.

Cocos Creator 3.6.1 Release Notes

After the release of v3.6.0, we received a lot of feedbacks from developers about user experience, performance, issues and so on.

Thank you for your continued support.

In v3.6.1, we fixed many of the important ones from these feedbacks and recommend all users who are using v3.x to upgrade.

The following is the main content of this update.

Engine

  • Added the feature of saving image data on native platforms #12503
  • Support text shadow, italic on iOS platform #12421  #12382
  • Now you can play *.wav audio properly on Windows
  • Optimized the performance of animation system on some platforms which support JIT #12308
  • Optimized the performance of some parts of the UI system for iOS platform #12390
  • Refactor the Mask component. Instead of inheriting from the rendering component, it holds a rendering component so that it no longer affects its children nodes #12636
  • Modify the Websocket:onclose API on native platforms to be consistent with the web standard #12370
  • Add approxEquals method to the math library on the native platform to determine if it is approximately equal#12610
  • Optimized the efficiency of JSBClassType::findClass on native platforms #12548
  • Reduced the package size of the app built for Android platform, reducing unnecessary third-party library references #12537
  • Fixed an issue that may cause interruptions when multi-tasking downloading on iOS platform#12743
  • Fixed a problem caused by extra spaces when parsing HttpRequestHeader#12757
  • Fixed possible resource loss when cropping engine modules (e.g. particle-2d module resources lost due to cropping 2d modules)#12602
  • Fixed the problem that tiledtile cannot be moved #12377
  • Fixed spine/dragonbones engine modules cropping problem #12605
  • Optimize spine memory usage, using RGBA8 color format#12619
  • The Anisotropic Lighting parameters of Cocos Creator materials can be interfaced with the Substance material library.#12371#12376
  • Fixed the bug of Downloader connection timeout setting error on Android platform #12642
  • Fixed the problem that the configuration of jointTexture does not work on native platform #12639
  • Fixed the problem that mesh.minPosition and mesh.maxPosition return a type other than Vec3 on native platforms #12628
  • Fixed a possible crash caused by Node::isChildOf on native platforms #12493
  • Fixed the problem that ValueArrayPool::get may trigger asserts in DEBUG mode on native platforms. #12499
  • Fixed the problem that building to Android on Windows will report an error when the project path contains spaces #12754
  • Fixed some rendering issues with Fog and Debug View #12571#12343
  • Fixed the problem of possible lag when playing audios on Android platform #12589
  • Fixed a memory leak when changing clips of an AudioSource #12592

Editor

  • Support for tif and tiff format images
  • Support for displaying build progress in the taskbar on Windows
  • Allow decorators for array properties in script components to affect their elements
  • Support dragging transition to sort priority in Marionette system
  • Optimized event handling of animation editor, function name can not be nil
  • Support for command line builds using pre-configured settings from the build panel
  • Support Cocos Creator - Preferences - Engine Manager - Use Custom use relative paths
  • Optimized the scene editor launch process to speed up the launch speed
  • When the image compresse quality of png/jpg/webp is set to 100 or the compressed size is larger than the source image, the source image will be used directly.
  • Fixed the problem that Sprite in the scene editor may not be rendered after editing its SpriteFrame
  • Fixed the problem that the scale of a Prefab cannot take effect in real time in the scene editor after modification.
  • Fixed the problem that the onBeforeMake and onAfterMake callbacks are not triggered when building
  • Fixed the problem that the nodes are not displayed normally after using filters in the animation editor
  • Fixed the problem that some scene data will be left when a parent node is deleted after the children are mounted to others
  • Fixed the problem that the name may be lost when using SpriteFrame resources in scripts
  • Fixed the problem that the generated file extension is wrong after importing *.webp images as Cubemaps.
  • Fixed the problem that the 'scene:create-component' message does not correctly receive the parameter: component {string}
  • Fixed the problem of status displaying incorrectly when ui-asset / ui-component / ui-node is missing.
  • Improved some other details and experience of the editor

Known Issue

Show Less
3.6.0
17 Aug 2022

Cocos Creator 3.6 is an important milestone for Cocos Engine, and it also has the longest iteration since Cocos Creator 3.0. This version has significant improvements in rendering, editor features, performance, and enhancements in stability and compa

3.5.2
22 Jun 2022

Editor Update

  • Fixed an issue where an error might be reported when modifying properties of nested prefab.
  • Fixed the problem that the initialized width and height of the material preview are not integers, causing an e
3.5.1
01 Jun 2022

V3.5.1 adds two far-reaching experimental features without affecting the stability of the original functionality of V3.5.0. The first is the Smart Material Conversion which permit to import DCC default materials from FBX, restoring the materials and appearance created by art

3.5.0
06 May 2022

Important updates

Marionette animation system

We added the Marionette animation system in v3.4 for complex character animation. It supports state machine editing

3.4.2
10 Mar 2022

In v3.4.1, we improved the data submission and batching strategy of 2D rendering components. Since these are basic changes, it caused some problems with Tiledmap and Graphics. Also, the performance of Spine and Dragonbones on the Andr

3.4.1
25 Jan 2022

In v3.4.1, we focused on fixing problems reported by users after the release of v3.4.0 and improving the overall stability. At the same time, in order to help v2.x developers to upgrade to v3, we adjusted the batch strategy of 2D rendering components, which has greatly impro

3.4.0
20 Dec 2021

Cocos Creator v3.4 is the final version we released this year for Creator. Stability is our most important goal! The development and testing cycle of this version is longer than any previous version, and it has been publicly tested in the community for a month. Thank you to

3.3.2
11 Oct 2021

Highlights

The main function of this version is to allow native applications built by the engine to support iOS 10+. In order to support iOS 10+, the engine code removed the dependency on C++17.

Highlights

The main function of this version is to allow native applications built by the engine to support iOS 10+. In order to support iOS 10+, the engine code removed the dependency on C++17.

Some functions of the engine depend on C++17, and some functions require using the Android API. For the convenience of developers, the function configuration interface of the editor prompts for these dependencies. For example, when Android uses the delayed pipeline, Android API 21+ is required. If the configuration chooses to use the delayed pipeline, the editor will prompt the required Android API version:

Of course, we also provide a complete document explaining the requirements of each functional module for the Android API and C++ versions. For more information, please refer to the native options documentation.

Key update list

  • Cocos Store download has improved performance
  • Native GPU Instancing material switching causes rendering failure
  • Fix the problem that muti cannot be modified in the Two Curve mode of the curve component
  • Fix the problem that the override may be lost when saving immediately after undo in the prefab modification mode
  • Fix the UITransform component or Canvas node problem when adding UI nodes when editing prefab resources

Known Issues

  • Topon and Tradplus Service plugins will have exceptions when building the IOS platform, which we will fix with a hot update in the near future.

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 a 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 a 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.

Show Less
3.3.1
17 Sep 2021

Bugs Fixed

Editor

  • Optimize the display of the physical laboratory options on the WeChat byte panel. When creating a new WeChat build task, the Wasm physi
3.3.0
24 Aug 2021

What’s new!

Performance optimizations

In version 3.3, the focus continues to be optimizing the loading performance and running performance of the WeChat mini-gam

3.2.1
10 Aug 2021

What’s new!

Cocos Creator v3.2.1 is the result of merging v3.1.2 into v3.2.1, and continues to bring a more stable experience on the major ve

3.2.0
18 Jun 2021

Cocos Creator 3.2 officially supports HarmonyOS, becoming the world’s first game engine that supports HarmonyOS. At the same time, Creator has conducted in-depth cooperation with the Bytedance platform to support the use of PhysX p

3.1.2
15 Jul 2021

What’s new!

Cocos Creator 3.1.2 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 relev

3.1.1
01 Jun 2021

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 relev

3.1.0
12 May 2021

The launch of Cocos Creator v3.0 marks a new journey for Creator, and Cocos Creator 3.1 is the first cornerstone of the journey. This version update brings many great new features, including deferred rendering contributed by the Huawei HiSil

3.0.1
14 Apr 2021

What’s new

  • The option simulate global variables is removed, and the option execution scope is newly added.

What’s new

  • The option simulate global variables is removed, and the option execution scope is newly added.
  • The optional values are Global or Enclosed. When it is Global, execute the script directly in the target environment. When Enclosed, the entire script is wrapped in an IIFE function for execution, which means that variables declared with var at the top of the script will not be promoted to global variables.
  • Added functions for aligning the scene camera to a certain node.
  • Added 2D/3D mode switching shortcut key (number key + 2)

Release Notes

Improvements

  • Give clearer hints when trying to reference Node modules in the project
  • Eliminate redundant code of project scripts in the package body when building
  • Optimize the WeChat engine separation function and module removal to reduce the package body
  • Supports BMFont compressed texture using transparent channel separation format [#8364]

Editor

  • Fix the issue that the command line build will add a new build task
  • Fix the problem that the shortcut keys of the shortcut key panel may not be modified successfully under certain circumstances
  • Fixed the problem of delay in deleting multiple selected animation events by right-clicking
  • Fixed the problem of skeletal animation not being able to click on the property track and move the small red line to view normally in the animation editor
  • Fix the problem that the plugin manager needs to be manually refreshed to display after creating a build plugin
  • Fixed the problem that the plugin manager failed to import plugins on mac
  • Fix the problem of pop-up warning when plug-in mall is closed
  • Fixed the difference between the main light source of the engine and the baking effect
  • Fix the problem of baking non-n*n terrain errors
  • Fix the cache problem in the interface of editing particle nodes
  • Fix the problem that the sub-resource editing interface is not displayed when the picture is of textrue type
  • Fix the problem that the shortcut key configuration panel cannot be scrolled
  • Fixed the issue that the terrain brush of the terrain node was not reset after switching scenes
  • Fix the problem that iOS project cannot be built on M1 device
  • Fix the problem that sub-resources may be lost when glTF resources are imported
  • Fix the problem that the template file of the build plug-in created cannot be modified
  • Fix the problem that scene.name is missing when previewing

Engine

  • [SPINE] Fix the problem that the SkeletonTexture type is not exported [#8359]
  • [UI] Fix the problem of incorrect rendering of static batch components on iOS 14 [#8320]
  • [UI] Fix the incorrect line break of RichText component [#8345]
  • [UI] Fixed the problem of mask click penetration [#8313]
  • [UI] Fixed the always mode problem of Widget [#8304]
  • [UI] Fixed the memory leak of Mask [#8375]
  • [SHADOW] Fixed the problem of setting extra texture error for plane shadow under instancing[#8336]
  • [SHADOW] Fixed the problem that the transparent model renders incorrectly after opening the shadow map under the Nvidia graphics card[#8303]
  • [SHADOW] Fixed the problem that flat shadows are not displayed under multiple light sources [#8328]
  • [TWEEN] Fix the problem that Tween does not support custom easing functions [#8321]
  • [PHYSICS] Fix the problem that the initialization type of rigid body is incorrect when it is not enabled [#8307]
  • [PHYSICS] Fix the problem that setting grid does not take effect when Ammo is running [#8315]
  • [ASSET] Fixed the rendering problem of ETC1 format compressed texture in WebGL2 environment [#8351]

Native

  • Fix the problem that the native Spine/Dragonbones node cannot be displayed after the active change [#8323]
  • Fix the problem that EditBox on Win32 / macOS platform cannot end editing after pressing Enter [#3295]

Breaking Changes

  • After the easing system update timing is changed from the lateUpdate stage to the update stage, the processing timing may need to be adjusted [#8305]
  • In order to adapt to M1, the third-party library is recompiled, and the Xcode version is required to be 11.5+.

Known Issue

  • When importing FBX with negative frame animation, the editor may not work. Please make sure that there is no negative frame animation in the corresponding DCC tool. Later versions will fix this problem.
  • The native platform Spine premultiplied rendering is incorrect, this issue will be fixed in later versions.

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.

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.

Show Less
3.0.0
07 Feb 2021

After the v3.0 preview was released, the engine team received a lot of enthusiastic feedback from developers, this feedback really helped to increase the team’s motivation to release an amazing product. Creator v3.0 unifies the development workflow of 2D and 3D, taking into