Cocos Creator v2.1.1 released!

Cocos Creator v2.1.1 released!

Cocos Creator v2.1.1 released!

Since the release of Cocos Creator 2.1.0, we have received a lot of valuable suggestions from users. Based on previously announced plans, we will continue to speed up the iteration of the v2.1 series to implement user suggestions as quickly as possible. At the same time, in order to prevent these changes from affecting the stability of old projects, we only recommend upgrading projects with 3D requirements to v2.1. Other projects can continue to use v2.0, and wait until v2.2 is released before upgrading. This v2.1.1 upgrade mainly supports 3D scene editing, camera preview, lighting system, and also incorporates the latest 2.0.x changes.

What’s New

Support 3D scene editing

The Scene Editor allows you to switch to 3D editing mode with one click, making it easy to edit 3D objects, cameras, and lights. See the 3D Scenes document for details.

Add game preview panel

A separate preview panel has been added to visually preview the images seen by the camera during scene editing. Panel Open: Main Menu → Panel → Game Preview, the preview panel can be placed in a separate window or dragged into the main editor window.

Add 3D lighting and shadows

A Light component has been added to lay out lights in the scene, and a shadow effect can be set in conjunction with MeshRenderer. See the Light Source Component Reference documentation.

Upgraded EditBox component

Now, developers can set the Text Label, Placeholder Label and Background nodes separately, making them more flexible, simple, and more in line with the component development. See the EditBox Component Reference documentation.

Add text shadow rendering component

A new LabelShadow component has been added to add a shadow effect to the Label component, similar to the LabelOutline usage. See the Label Component Reference documentation.

Support for dynamically creating 3D Primitive models

Added cc.primitive module to dynamically create 3D models at runtime, including: box, cone, cylinder, plane, etc. See the Basic 3D Objects documentation.

Integrated Material System (Beta)

Added support for material systems, allowing users to create Material and Effect (Shader) resource types. It should be noted that the current material system is mainly provided to the internal use of the engine and is only for developer preview. We plan to upgrade the material system in v2.1.2, however it will not be back-ported to this version.

Improved features

Editor improvements

  • Added shortcut Ctrl/Cmd + Shift + F to align the currently selected node to the perspective of the scene editor.

  • When you click in the scene editor, you can hold down Ctrl/Cmd for multiple selections at the same time.

  • Improve fault tolerance processing for custom engines to avoid editor startup failure

  • Improve the search performance of the resource manager under very large projects

  • Add menu File -> Open project in new window to support simultaneous opening of multiple projects on Mac

  • Hide the component’s enabled checkbox when the component does not define the enabled associated lifecycle function

  • Upgrade the TypeScript version to 3.3.3333

Engine improvements

  • Make cc.Vec3 compatible with related APIs of cc.Vec2

  • Improved Label positioning accuracy in the editor and on different browsers (thanks to “Dacheng Xiaopeng” for advice)

  • Optimization 3D skeletal animation performance and volume

  • The cc.macro.CLEANUP_IMAGE_CACHE flag is enabled by default on the native platform to reduce texture memory usage

  • Native platform automatically verifies the maximum supported texture size of the current device

  • Add WeChat Mini game XMLHttpRequest support for timeout event [#87]

  • Added cc.sys.HUAWEI_GAME enumeration to determine if it is currently Huawei’s fast game platform

  • Optimized Android 5 system’s WebView compatibility

  • Allow iOS browser to play automatically when VideoPlayer is muted

Bug Fixes

Editor Fix List

  • Fixed an issue where BuildResults.getNativeAssetPath might not get the texture path

  • Fixed removal animation editor error message caused by the Animation Clip being edited

  • Fixed an object already destroyed warning that appears when you repeatedly enter Prefab edit mode

Engine Repair List

  • Fixed an issue where enabledInHierarchy is always false when the component does not define onEnable

  • Fixed an issue where ToggleGroup is not fully disabled when the active node is false

  • Fix Label’s opacity is not working

  • Fix Slider’s anchor settings will affect clicks [#4163]

  • Fix Particle System after playing, hide the node and display the problem of residual particles [#4243]

  • Fixed a memory leak issue that could be caused by too many particles in the particle system [#4256]

  • Fix native platform resources Download, XMLHttpRequest, WebSocket, SocketIO possible crash after request [#1721] [#1716]

  • Fix native platform XMLHttpRequest may crash due to timeout [#1724]

  • Fix native platform loading via IPV6 under the telecom network (WeChat avatar) file may fail [[#1713]] (

  • Fix native platform OpenGL draw error #4017

  • Fix native platform Label there may be black border issues when rendering system text [#130]

  • Fixed an issue where the audio file on the Android platform could not be loaded when it was not in OBB[#1611]

  • Fixed an issue where the Android platform received a touch event before the engine initialization was completed could cause a crash [#1715]

  • Fix Windows platform window may report an error when minimizing restore [#129]

  • Fixed Windows platform error when opening window [#1732]

  • Fixed an issue where the volume setting to 0 is invalid on Browser

  • Fix 3D Project incompatibleWeChat game Open Data Domain issue

  • Fix 3D model bone penetration problem [#4188]


  • Removed the creation entry for the CoffeeScript script. CoffeeScript scripts can still be created manually, and we plan to remove full support for CoffeeScript in v3.0.

Follow-up version plan

(The version plan is for reference only, the final version content and release order are subject to actual conditions)

  • 2.0.x

    • Continuously optimize performance and improve stability
    • Support for more small game platforms
  • 2.2.0

    • Optimized Auto Atlas
    • Enhanced compression texture support
    • Further optimize the platform compatibility of the EditBox
    • Support skeletal animation resource lazy loading
    • Optimize the small game platform build process
  • 2.3.0

    • Greatly optimize native platform base rendering performance
    • Greatly optimized TiledMap support
  • 2.3.x

    • Support for 3D physical systems and collision detection
    • Upgrade the material system added in 2.1.1 from the experimental version to the official version



pinned globally #4

Imported a model from blender.
Create a new material and texture
Got this error

when i press play

it works.but editor is broken


Lets ask @jare and the team to take a look. Can you upload the blender object?

#7 (80.6 KB)


Hi, good job on that big release and thank you! Any dates on 2.0.10 version?


The roadmap is here but as far as dates I don’t quite know yet. The team is on holiday for a few days but I am happy to ask the a time-frame when they return. Thank you for asking.


2.0.10 will be released within the month.


Dear @slackmoehrle,

when will we get the API 2.1 documentation here?

This looks like 2.0.




I looked at my build script and I am pulling from the correct branch. So perhaps the version number never got updated. I’m reaching out to the engineering team to have someone take a look. When I view the branch in GitHub it still says 2.0.0 also. The docs build nightly, FYI.

Thanks for reaching out.


is it possible to manually update TypeScript version?


Hello team,

please help me solve this problem.
i meet the same problem in 2.1.0 and 2.1.1


great job guys!


Hi, @Andres_IC
I import your model to editor, and everything is fine. How can I reproduce this problem?


Hey great job team,
facing an issue of inconsistent physics behavior ,every time I replay the output is not the same (mostly toggles between two output) anyway to solve it ?
There is no problem if I set fixed rotation to true in the editor itself.
Wanted to create new topic ,but my level is too low to do that,hope you understand thank you.


As a person who had a lot of troubles with the EditBox in the past, I am very happy to see what it become in this version. It is really customizable now, the typing is fluid and the small extra box on top of the keyboard is great.

So even if I don’t have 3D requirements, I am happy that I updated, just because of the EditBox. Thank you :slight_smile:

1 Like

i dont know. Im using windows 10 btw


how to run action such as cc.moveTo , cc.jumpTo in 3D bro


Is it possible to add a feature for camera to sort objects for rendering? Like Unity’s “Sorting Layers”.
On 2.1.1 we have cullingMask for camera but it’s locked to object groups. I’m sure we definitely need something independent to sort nodes for rendering. Unity’s Sorting Layers is very useful and it has order in layer option too. I’ve tried changing Z position of nodes but it’s not working on sprites (works only for meshes with unlit-transparent material which is not easy to manage like sprites).