cocos-creator.md

Cocos Creator is a flexible, efficient and data-driven game engine, focused on content creation.

• Official Blog, Download Cocos Creator
• cocos-engine: This repo is the engine framework for Cocos Creator. Cocos Creator's in-editor scene view and web runtime share the same framework, which is the content of this repo. It's originally forked from Cocos2d-html5, we build up an Entity Component architecture on it to meet the needs of Cocos Creator.
• engine-native, the native backend of Cocos Creator. It works on iOS, Android, Mac OS and Windows.
  • AKA: cocos2d-x-lite: Lite version [[cocos2d-x]] based on Cocos Runtime; Cocos2d-x compact version, It is based on cocos2d-x[version 3.9], but remove 3D and other features. It works on iOS, Android, macOS and Windows.

Learn

• Cocos Creator 用户手册
  • 配置代码编辑环境
• 3.0 TypeScript 问题答疑及经验分享
• Creator星球游戏开发社区文章列表

tutorials

• cocos-creator/tutorial-first-game, Quick start game for Cocos Creator
• cocos-creator/tutorial-blackjack, 21点游戏 - Cocos Creator 制造
• cocos-creator/tutorial-dark-slash, 暗黑斩游戏制作演示 - Cocos Creator制造
• demo-ball A jumping ball demo created by Cocos Creator 3D
• Tutorial-Taxi-Game: This is an open source demo game using Cocos Creator 3D v1.0.x, with 17 episodes of video tutorial on Bilibili. From this project, you can learn how to use Cocos Creator 3D to develop a 3D game from sratch.

examples

• Cocos Creator 开发范例: 本项目同时面向 Cocos Creator 引擎开发人员和最终用户，目的是建立一套贯穿开发、测试、学习使用的完整的功能范例。 在线演示
• cocos creator 一些使用实例(刚体挖洞/流体效果/shader/纹理处理)
• CococsCreator 技术方案分享, 来源自论坛、github 开源仓库、gitee 开源仓库、热心开发者、Cocos 引擎开发团队、cocos 技术支持团队。

creator 编辑器插件

• 编辑器 API 参考文档
• Editor API
• 《creator插件开发常用API命令列表》备忘录

Practice

• Cocos Creator—最佳构建部署实践
• 腾讯在线教育部技术博客
  • 基于 Cocos 的高性能跨平台开发方案
  • 拒绝 evalString 进行回调，使用 JSB 进行手动绑定（流程篇）
  • 最佳实践：JavaScript兼容性问题规避
  • 人生苦短，我们为 Cocos Creator 开发的插件和工具
  • TinyCocosFix -- Cocos热更新的非官方解决方案

crypto

• 建议creator提供图片资源加密功能
• 一种「无侵入」资源加密方案
• 适用于 Cocos 的 JSC 加解密工具
  • cocos-jsc-endecryptor

texture compression

• 支持ETC1 + Alpha 纹理压缩
  • 纹理压缩插件化
    • 纹理压缩插件
• 一个操作让游戏内存立减50+% - Creator性能优化之压缩纹理
  • 针对不支持 GLES3.0 的设备，etc2 软解方案 https://github.com/google/angle
• etc 压缩格式，使用 Mac 压缩后透明度不对（已解决）

optimize

• Cocos Creator性能调优优化集锦
• Cocos Creator 性能优化：DrawCall

hot-update

• Cocos Creator 热更新
  • Cocos Creator 大厅+子游戏模式
• Cocos Creator 实现大厅+子游戏模式
• ⭐Cocos Creator 大厅+子游戏，从入门到进阶！
  • 我理解的 cocosCreator asset Bundle 版本2.4.4（跨域资源服务器+大厅子游戏模式+热更新+相关详细功能+相当易懂的介绍+demo）

[[TypeScript]]

• JavaScript 标准支持
  • Creator 使用的是标准的 JavaScript，JavaScript 目前常见的标准是几乎所有平台都支持的 ES5，如果你还想要使用更高版本的特性，需要先确认支持情况：
  • Creator 集成了 babel 编译器，能够自动转译项目里除了插件以外的所有 JavaScript 脚本。这步操作会将一部分常用的 ES2015(ES6) 特性翻译为原生的 ES5，这样开发者就不用担心跨平台的兼容性。
  • ES2015 入门教程及 Creator 支持的特性列表请参考 Learn ES2015（在这份列表中，标记为“Support via polyfill”的部分暂不支持）。
  • 编辑器部分支持到常用的 ES2015，支持程度取决于 Creator 采用的 Node.js 引擎，截至 Creator 1.1，支持到了 Node.js 5.1.1（详情）。
  • 在 Creator 的控制台中输入 process.versions.node 可以显示当前的 Node.js 版本号。
• 使用 TypeScript 脚本
  • 语言支持
    • Creator 3D 使用 babel 而非 tsc（Microsoft TypeScript Compiler） 编译 TypeScript 脚本
  • Cocos Creator TypeScript断点调试

Libraries

• CocosCreator TypeScript项目引用第三方库的方法和问题记录
• Creator | TS项目中引入第三方JS库的两种方式
• CocosCreator TypeScript使用protobuf
• Creator | 微信小游戏使用 protobuf 的两种加载方式
• 综上，使用代码引入（无需依赖 creator 编辑器插件功能）+ 静态加载 proto (支持微信小游戏) 最佳，以 macOS 为例：
  • brew install node ，并 npm install -g protobufjs
    • 方便复制起见，可以在 creator 项目根目录也执行 npm install protobufjs
  • 编译 .proto 文件，假设所在 creator 项目目录为 myproj/assets/script/*.proto
    • pbjs -t static-module -w commonjs -o proto.js *.proto
    • 得到：myproj/assets/script/proto.js
  • 将 node_modules/protobufjs/dist/minimal/ 中内容，移至 myproj/assets/script/protobufjs/minimal/
    • 移动依据见 proto.js 前几行中，可自行修改：

    var $protobuf = require("protobufjs/minimal");

  • 在需要处理 protobuffer 的地方，如： myproj/assets/script/main.ts 引入

    import { AwesomeMessage } from "./proto.js";
    // example code
    let message = AwesomeMessage.create({ awesomeField: "hello" });
    let buffer  = AwesomeMessage.encode(message).finish();
    let decoded = AwesomeMessage.decode(buffer);

  • Usage with TypeScript - Using generated static code

FAQs

• 王哲 - Cocos引擎首席客服，知乎上的回答
  • Cocos 引擎的创始人是谁？Cocos2d-x 和Cocos 有什么区别？
• 序列化和反序列化支持 Cocos Creator 中类的绝大多数公有属性，这些属性通过属性检查器面板暴露给开发者。
  • 开发者可以在编辑器中随意修改并保存，保存的过程就是将资源和场景数据序列化到资源数据库（Asset Database）中。反之，在加载场景的过程中，反序列化机制会根据场景数据实例化相应的对象，并加载编辑器中设置的所有属性。
  • 也就是说，序列化会将这些修改后的属性保存到场景中。而反序列化是每次启动场景的时候，这些属性都会被加载。
  • 不仅如此，数据驱动的强大之处在于，用户自己编辑的组件也可以进行属性声明。这些属性可以在编辑器中被编辑，也会被保存到场景数据中，最后在运行时被反序列化到游戏场景中。
  • serializable参数
    • 指定了 default 默认值的属性默认情况下都会被序列化，序列化后就会将编辑器中设置好的值保存到场景等资源文件中，并且在加载场景时自动还原之前设置好的值。如果不想序列化，可以设置serializable: false。

    @property({serializable:false})
    private num = 0;

• cocos meta 文件 git 显示
  • git config --global core.autocrlf false
  • git config --global core.safecrlf false

Resources

• cocos-creator/awesome Delightful Cocos Creator Utilities, Documents and more!
• awesome-cocos-creator Cocos Creator 资源汇总
• pomelo-cocos-creator-awesome 学习 pomelo 和 Cocos Creator 过程中收集的教程、麻将、斗地主棋牌项目