loyalwind / cocos2dx-lite

Cocos2d-x with 2D, just 2D, productivity boost for games

cocos2dx-lite

中文

NOTE : From tag v5, this repo remove all templates, just provide a runable lua app and a tool for rename the app.

It bases on cocos2d-x v3 branch, but remove 3D and other features. It works on iOS, Android, macOSand Windows.

The major change:

• Only support iOS,OS X,Android and Windows.
• Remove 3D features
• Remove support for JS script
• Remove deprecated classes and functions
• Remove Camera
• Remove Physics integration
• Remove C++ implementations of Component
• Remove C++ implementations of CocoStudio parser
• Remove C++ implementations of CocosBuilder parser
• Remove AssetsManager, AssetsManagerEX
• Remove support for WebP,S3TC,ATITC
• Remove FastTileMap, TileMap
• Remove Menu
• Improve module compile cocos/base/ccConfigUser.h
• Improve curl library, only support socket and http protocol
• Add CC_MINI_2D / CC_USE_FREETYPE / CC_ONLY_PNG
• Add CC_USE_SPINE
• Add CC_USE_AUDIO_ENGINE
• Add CC_USE_NETWORK
• Restore ui module (NOT depend CocoStudio)
• Restore Focus event (need by ui)
• Restore CocoStudio module
• Keep working with CocosStudio after 3.14.1 (cocos2d/cocos2d-x#17349 (comment))

Lua

0. lua 5.1.x as default, not LuaJIT

1. lua-cjson

2. luafilesystem Version 1.7.0 [15/Sep/2017]

3. lpeg

4. lpack

5. sproto

6. luasocket

7. lsocket 1.4.1

8. pbc, maybe switch to google/upb, pure C99, also support Lua.

9. LuaBitOp 1.0.2

10. Node "destroy" event

display.newNode()
:onNodeEvent('destroy', function (  )
    print('node destroy event.')
end)

-- or
cc.Node:create()
:registerScriptHandler(function ( state )
    print('> Node event', state)
end)

How to start

1. setup env

   $ # clone repo
   $ git clone https://github.com/c0i/cocos2dx-lite.git
   $ cd cocos2dx-lite
   $ ./setup.py
   $ source ~/.bash_profile
   

2. try with player project

   $ open player/proj.ios_mac/player.xcodeproj/
   $ or
   $ cocos run -p mac # ios, android
   $ cocos run -p android --build-type ndk-build
   

Bugs

1. ANR with Android 7.x

Contributing to the Project

Cocos2dx-lite is licensed under the MIT License. We welcome participation!

Others

There are lots of better cocos2d-x forks:

• https://github.com/stubma/cocos2dx-classical (v2)
• https://github.com/IppClub/Dorothy (v2)
• https://github.com/Sheado/cocos2d-x (v3)
• https://github.com/mafiagame/quick-cocos2d-x (v3)