* Added base rendering logic * Hide using decorators Diffuse reflection map control and ApplyDiffuseMap whenever IBL is disabled * Added HDR toggle to scene globals * Fix bug when ApplyDiffuseMap is left checked when envmap is deleted & disable IBL when envmap is deleted * Add changes to allow rendering the diffuse convolution map * Added functions to permit setting sky and ground color (hemispheric lighting) from irradiance calculated from a set envmap. That is, when a diffuse reflection irradiance convolution is not used. Also code to discern LDR from HDR * Various mods * Permit independent Hemispheric Lighting parameters to be serialized for LDR/HDR * Add HDR normalization * Set HDR shader macro * Modify Illiminance based on global LDR/HDR setting * Add LDR/HDR versions for luminous flux * Add distinct LDR/HDR for SpotLight/SphereLight luminous flux * Adding LDR as the new serialized value, as HDR is assumed by default in previous versions * Modified hemisphericc ambient light to assume HDR as default removing the necesesity for migration code * HDR is on by default * Fix directional light constructor removal * HDR/LDR fixes for sphere, spot, and directional lights * Fix the HDR/LDR mode switching on UseHDR toggle * Switch UI to and from LDR/HDR envmap depending on HDR toggle state * Make LDR envmap and diffusemap's serializable * Partial Float32Array->Vec4 conversion * Fixed passed Vec4() into UBO for skycolor and groundalbedo * Fixed copy/paste error * Fix ambient illumination passing into global UBO * Modify UBOs to call correct luminance functions * Modification to punctual lights * Add missing dependency * Fix HDR/LDR envmap/diffuse map initialization bug * Add support for native engine * update_hdr_skybox (#9230) * update material preview when custom panel change (#9340) * update material preview when custom panel change fixed https://github.com/cocos-creator/3d-tasks/issues/8663 * update material preview when custom panel change fixed https://github.com/cocos-creator/3d-tasks/issues/8663 * Update material.js * Fix native light function invoke error * Unify API naming in light * Improve scene-globals code organization * Update jsb apis * Reverse getter setter for spotLight luminance * Fix unexpectable result of toggle HDR and ApplyDiffuseMap options * Remove fpScale, make deferred and forward uniform * Fix skybox macro recompiling error * Fix shader compiling errors Fix unlit shader in HDR/LDR output Co-authored-by: Jamie Anthony Morris <Jamie.Morris@cocos.com> Co-authored-by: Jamie Anthony Morris <47879963+Jacksparrow2525@users.noreply.github.com> Co-authored-by: jk20012001 <jkregister@163.com> Co-authored-by: linshunjun <49218738+linshunjun@users.noreply.github.com> Co-authored-by: zhangxin <59186205+chichinohaha@users.noreply.github.com>
Cocos Creator
Cocos Creator is the new generation of game development tool in Cocos family, it brings a complete set of 3D features and provides an intuitive, low cost and collaboration friendly workflow to game developers.
Cocos Creator inherited many good qualities and cool features from its previous versions, such as cross-platform support including instant gaming platforms like WeChat mini game, asset management, powerful animation editing, etc. Furthermore, Cocos Creator has pushed our technology to a whole new level. Our GFX implementation is designed to adapt to the latest graphic backend APIs, it already supports WebGL 2 and can be seamlessly fall back to WebGL 1, it will support Vulkan and Metal in the native build. The material system is built on our own effect format which uses GLSL 300 and can be easily adapted to lower version on low end devices. Developers can produce high performance, extremely expressive shaders with good compatibility. Along with physical based camera and lighting, high level game graphic can be easily achieved. Our pure GPU driven skeleton animation also make sure your game runs as smooth as possible. Besides all these exciting features, Cocos Creator have builtin physics support, terrain editing support, visual effect editing, ui system, TypeScript support, instant preview etc.
This repo is the engine part of Cocos Creator, it's mainly written in TypeScript and support users to use TypeScript or ES6 to write game logics. The engine itself is mostly self-contained, with full-fledged runtime modules including lighting, material, particle, animation, physical, UI, terrain, sound, resource and scene-graph management, etc. It supports both native and web platforms, including Windows, Mac, iOS, Android, Web. What's more exciting is that it supports rapidly expanding instant gaming platforms like WeChat Mini Game and Facebook Instant Games.
The engine is naturally integrated within Cocos Creator, designed to only be the essential runtime library and not to be used independently.
Developer
Prerequisite
- Install node.js v9.11.2 +
- Install gulp-cli v2.3.0 +
Install
In the cloned repo, run the following command to setup dev environment:
# download & build engine dependencies
npm install
This is all you have to do to setup engine development environment.
Build
-
If running inside Cocos Creator, the engine will automatically compile and build after the editor window is opened.
-
Outside the editor, you need to run the following command to build:
npm run build
Example Project
- Example Cases: Simple yet expressive demo scenes for baseline testing and topic-specific case study.
- Mind Your Step 3D: Beginner's step-by-step tutorial project repo.
- UI Demo: use cases for various kinds of UI components.
- Test Cases: Unit test scenes for every engine module.
Links
- Official site
- Download
- Documentation
- API References
- Forum
- Road Map: To be announced

