• Stars
    star
    117
  • Rank 290,907 (Top 6 %)
  • Language
    Lua
  • License
    MIT License
  • Created almost 8 years ago
  • Updated about 2 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Cocos Creator 的 Lua 支持

Cocos Creator 的 Lua 支持

当前版本 1.1.4,支持 Cocos Creator 1.3.x

目标

让 Lua 开发者可以使用 Cocos Creator 来搭建场景和 UI,并在 Lua 游戏中正常显示和操作。

主要特征

当前支持的特征:

  • Sprite - 精灵:图像显示
  • Canvas - 画布:主要用于自动布局
  • Widget - 部件:可以配合 Canvas 设置自动布局和各种对齐方式
  • Button - 按钮:响应玩家操作
  • EditBox - 编辑框:用于玩家输入文字
  • ParticleSystem - 粒子系统:显示粒子效果
  • TileMap - 地图:显示使用 Tiled 编辑的地图
  • Animation - 动画:仅支持帧动画
  • Label (System Font) - 文字标签:仅支持系统字体
  • Component with Lifetime events - 组件及其生命周期管理

Creator 插件功能:

  • 设置目标项目(Lua 工程)路径
  • 复制需要的支持库到目标项目
  • 构建场景数据到目标项目
  • 在保存场景时自动构建

目前无法支持的功能

一些控件暂时无法支持:

  • ProgressBar
  • Layout
  • ScrollView

安装插件

Creator for Lua 1.1 插件提供了 Windows 和 Mac 下的安装程序,执行安装程序瞬间完成安装。

然后,不好意思,没有然后了。JUST DO IT!

使用插件

启动 Creator,在场景里啪啪啪放一堆内容,然后选择菜单“工程 -> Lua Support -> Setup Target Project”,就可以看到目标工程设置对话框。

在这个对话框中我们只需要做三个步骤:

  1. 点击 Project Path 旁边的 “...” 按钮选择你的 Lua 工程目录;
  2. 点击 Copy Support Library 按钮(这个步骤只需要对每一个新 Lua 工程做一次);
  3. 点击 Build 按钮。

如果你还没创建 Lua 工程,可以参考下面的命令行:

$ cocos new -l lua mygame

构建出 Lua 代码后,我们就可以愉快的在 Lua 中显示 Creator 创建的场景了。

自动构建

默认情况下,并没有启用自动构建功能。所以修改场景后要更新 Lua 代码,需要重新点击 Build 按钮,或者选择菜单“工程 -> Lua Support -> Build Now”。

更省事儿的做法是在对话框中选中 “Auto Build” 选项。这样每次保存场景,就会自动更新 Lua 代码啦。

后续计划

  • 完善控件库,支持所有 Creator 控件。
  • 完善插件,允许从插件中创建 Lua 工程,并自动设置好目标工程。
  • 在自动构建时使用增量构建,只构建修改过的场景和资源,提高工作效率。
  • 提供完善的使用文档。

More Repositories

1

cocos-engine

Cocos simplifies game creation and distribution with Cocos Creator, a free, open-source, cross-platform game engine. Empowering millions of developers to create high-performance, engaging 2D/3D games and instant web entertainment.
C++
5,018
star
2

example-projects

Example project to guide users through how to create game with Cocos Creator
JavaScript
1,271
star
3

tutorial-blackjack-deprecated

Blackjack game made with Cocos Creator.
JavaScript
798
star
4

engine-native

Native engine for Cocos Creator v2.x
C++
678
star
5

cocos-awesome-tech-solutions

Cocos' Awesome Technical Solutions
TypeScript
535
star
6

cocos-example-projects

JavaScript
449
star
7

cocos-example-dark-slash

PLSQL
288
star
8

cocos-docs

Manual docs content for Cocos Creator
TypeScript
264
star
9

cocos-tutorial-first-game

Quick start game for Fireball
JavaScript
236
star
10

cocos-test-projects

TypeScript
178
star
11

cocomat

C
170
star
12

cocos-example-ball

A jumping ball demo created by Cocos Creator 3D
TypeScript
155
star
13

cocos-example-cartoon-vegetation

TypeScript
150
star
14

cocos-tutorial-taxi-game

TypeScript
140
star
15

cocos-example-ui

TypeScript
130
star
16

cocos-tutorial-duang-sheep

tutorial repo
JavaScript
120
star
17

cocos-tutorial-airplane

video tutorial airplane
TypeScript
97
star
18

awesome-cocos

⚡️ Delightful Cocos Creator show cases, utilities, documents and more!
81
star
19

firedoc-deprecated

API Doc generator based on YUIDoc
JavaScript
70
star
20

cocos-tutorial-mind-your-step

Cocos Creator learning tutorial
TypeScript
64
star
21

cocos-example-process-build-textures

A build plugin to help you process textures in Creator 2.x after build
JavaScript
64
star
22

FBX-glTF-conv

A FBX to glTF file format converter.
C++
53
star
23

example-camera-deprecated

Camera demo for Cocos Creator
JavaScript
48
star
24

cocos-engine-external

external 3rd party modules for cocos-engine
C++
40
star
25

cocos-creator-extensions

TypeScript
27
star
26

cocos-example-marionette

This project is to demonstrate the use of Cocos Creator Marionette animation system.
TypeScript
21
star
27

example-instant-games-deprecated

JavaScript
20
star
28

cocos-example-physics

Samples for 3d physics
TypeScript
20
star
29

example-combat-animation-deprecated

turn based action rpg
JavaScript
19
star
30

i18n-example-deprecated

showcase how to implement i18n to your game.
JavaScript
19
star
31

smart-merge-tool-deprecated

JavaScript
17
star
32

cocos-tutorial-storage

Cocos Creator Demo: Save and load user profile with encryption using sys.localStorage
JavaScript
17
star
33

example-team-build-ui-deprecated

Team build ui demo for Cocos Creator
JavaScript
16
star
34

creator-api-docs-2.x

Host generated Cocos Creator 2.x API
JavaScript
15
star
35

helloworld-typescript-legacy

Typescript helloworld project template for Cocos Creator
TypeScript
13
star
36

gulp-fontello-import-deprecated

Import svg files to fontello icon font project, use svg filename as glyph name. Also provide task for auto download exported css and font files into desinated folder.
JavaScript
12
star
37

cocos-plugin-import-2.x

plugin for migrating cocos creator 2.x projects.
TypeScript
11
star
38

example-responsive-ui-deprecated

Cocos Creator - Responsive UI demo
JavaScript
11
star
39

google-game-sdk

C++
10
star
40

divine-vanity-deprecated

JavaScript
9
star
41

cocos-example-materials

TypeScript
8
star
42

cocos-template-taxi-game

TypeScript
8
star
43

cocos-example-open-data-context

TypeScript
8
star
44

cocos-benchmark

EJS
7
star
45

ui-kit-deprecated

JavaScript
6
star
46

cocos-google-admob

JavaScript
6
star
47

cocos-effect

VSCode Syntax highlight support for Cocos Effect file
TypeScript
5
star
48

avg-examples

5
star
49

example-packages-deprecated

HTML
4
star
50

overhead-benchmark-deprecated

Creator 架构层性能损耗 Benchmark
C++
4
star
51

cocos-example-render-pipeline

TypeScript
3
star
52

cocomat-docs

3
star
53

cocos-tutorial-video-src

JavaScript
3
star
54

firedoc-theme-notab-deprecated

A new theme without tab in navigation sidebar
HTML
3
star
55

cocos-web-extension-detect-engine

A Chrome extension to detect the engine running in web.
JavaScript
3
star
56

devops-workflows

Workflows for creator team.
JavaScript
3
star
57

cocos-gameplay

cocos creator gameplay
TypeScript
3
star
58

cocos-example-custom-pipeline

TypeScript
3
star
59

gulp-download-fire-shell-deprecated

gulp plugin to download atom-shell
2
star
60

node-font-lib-deprecated

built for https://github.com/fireball-x/font-editor
JavaScript
2
star
61

hello-world-legacy

Hello world new project template.
JavaScript
2
star
62

cocos-ccbuild

TypeScript
2
star
63

fireball-engine-core-deprecated

The basic classes used in fireball engine and editors
JavaScript
2
star
64

runtime-pixi-deprecated

A pixi runtime for test basic fireball features
JavaScript
2
star
65

gulp-fb-deprecated

utilities for gulp
JavaScript
1
star
66

fire-watch-deprecated

A watch module based on node-pathwatcher, the module is implemented for syncing changes between file system and asset db in fireball
JavaScript
1
star
67

tests-3d-deprecated

engine-3d test framework
HTML
1
star
68

fireball-runtime-cocos-deprecated

JavaScript
1
star
69

firedoc-theme-default-deprecated

Optimized theme for firedoc
Handlebars
1
star
70

cocos-fire-path

node's path module with some helpful additions.
JavaScript
1
star
71

cocos-fire-fs

node's fs module with some helpful additions.
JavaScript
1
star
72

preview-template-deprecated

JavaScript
1
star
73

font-editor-angular-deprecated

Font Editor
JavaScript
1
star
74

atlas-editor-polymer-deprecated

Atlas Editor for 2D games
JavaScript
1
star