Cocos Creator v2.4 User Manual
Welcome to the Cocos Creator User Manual! Cocos Creator is a free, cross-platform, game development tool based on Cocos2d-x. This is a comprehensive and detailed guide to help you get started with designing and developing games.
Note: please select the corresponding version of the manual in the upper right corner according to the version of Cocos Creator you are using.
Product Line Overview
Over the years, Cocos (Xiamen Yaji Software) has been continuously developing and has released several product lines closely related to Cocos Creator. To avoid confusion, here is a brief introduction to these products:
- Cocos Creator 3.x: Released in early 2021, it is the latest version of Cocos Creator, and has been validated through numerous commercial projects. 3.x completely abandons the Cocos2d-x base, adopting a brand new high-performance cross-platform 3D core. This marks the official development of Cocos Creator into a comprehensive pan-mobile 3D game engine. Since the 3.x base has been completely rewritten, Cocos Creator is no longer considered a direct extension and upgrade of Cocos2d-x.
- Cocos Creator 2.x: Released in 2018, updates ceased in 2023. All capabilities have been inherited by Cocos Creator 3.x, so it is recommended that new projects use the latest Cocos Creator 3.x.
- Cocos Creator 3D: Initiated in 2017, it underwent small-scale testing in China for over a year as Cocos Creator 3D at the end of 2019, and later officially merged into Cocos Creator 3.0. Since it has been replaced by Cocos Creator 3.x and is no longer updated separately, Cocos Creator 3D usually refers to Cocos Creator's own 3D capabilities rather than this specific version.
- Cocos2d-x: Released in 2010, it ceased updates in 2019. This is the most active branch of the Cocos2d community, and the underlying runtime initially adopted by Cocos Creator 2.x was the upgraded Cocos2d-x.
- Cocos: When Cocos appears as the engine name alone, it usually represents Cocos Creator 3.x, rather than Cocos2d-x.
After years of rapid development, there are significant differences in usage between Cocos Creator 3.x and Cocos Creator 2.x, and their APIs are not fully compatible. Therefore, when developers consult documentation, APIs, and tutorials, please pay attention to distinguish whether the target version is 2.x or 3.x to avoid errors due to version inconsistency.
- As of v2.4.1, Cocos Creator supports publishing to HUAWEI AppGallery Connect.
- As of v2.4.0, Cocos Creator has completely rewritten the Resource Management module and is compatible with most of the original APIs. Most of the projects will still work fine with the original code, except for a few projects that use incompatible special usage APIs that must be upgraded manually. We recommend that all developers upgrade. See both v2.4 Asset Manager Upgrade Guide and v2.4 Subpackage upgrade guide for details.
- As of v2.4.0, Cocos Creator officially supports Asset Bundle, providing more powerful remote resource loading capabilities, dynamic subproject loading capabilities, and further reducing the size of the first package. See Asset Bundle documentation for details.
- As of v2.4.0, the build process of the editor will be in Asset Bundle, and if you have extended the build process with plugins in the editor prior to v2.4, you will need to upgrade some of the API's usage. See Custom Build Process Upgrade Guide documentation for details.
- As of v2.3.0, Cocos Creator has added support for 3D Physics and Collision and 3D Particle System, while the Material System has been upgraded to the official version.
- Spine ReplaceTexture.
- DragonBones ReplaceTexture.
- As of v2.1.4, Cocos Creator supports publishing to Alipay Mini Games.
- As of v2.1, Cocos Creator introduced 3D support. Please refer to v2.1.0 Release Notes.
- As of v2.0.10, Cocos Creator supports publishing to Xiaomi Quick Games and Cocos Play.
- As of v2.0.7, Cocos Creator supports publishing to Huawei Quick Games.
- As of v2.0.5, Cocos Creator supports publishing to OPPO Mini Games and vivo Mini Games.
- As of v2.0.4, Cocos Creator supports publishing to Google Play Instant.
- v2.0 Upgrade Guide.
- As of v1.10, Cocos Creator refactored the underlying resource types, most of which are unaffected, but some projects may receive warnings, please refer to v1.10 Resource Upgrade Guide.
- Getting Started
- Asset Workflow
- Scene Creation Workflow
- Renderer and Graphics
- 2D Physics and Collision
- 3D System
- 3D Physics and Collision
- Editor Extension
- Advanced Topics
- SDK Integration
- Example Collections: You can also get access to it by creating a new project using that template. It's a case by case introduction of most Cocos Creator components and features.
- Your first Cocos Creator game: Star Catcher, please read Quick Start Tutorial.
- Blackjack Demo co-developed with Tencent Games
- UI Demo
- Dark Slash: Original Dark Slash resources authorized by Veewo Games to recreate Dark Slash in Cocos Creator as a demo.
Note: these projects are not always brought up to date with the most recent version of Cocos Creator. Their default branches on GitHub are
master, which corresponds to the latest Cocos Creator version. If you are still using the old version of Cocos Creator, these projects may not be able to open, and you can try to switch to the same named branch as the old version.