This is the development repo of Moai SDK. Current, but not necessarily tested or stable. For a more reliable Moai, use moai-beta.
C++ Java Lua Objective-C++ CMake Shell Other
Pull request Compare This branch is 367 commits ahead, 590 commits behind moai:develop.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
3rdparty-android
3rdparty
ant
bin
cmake
docs
host-templates
samples-legacy
samples
src
test
util
vs2008
vs2010
xcode
.gitattributes
.gitignore
.gitmodules
.travis.yml
CONTRIBUTING.md
README.md
version.txt

README.md

Welcome to Moai!

Thanks for checking out the Moai source code. Here's the scoop.

Linux CI: Build Status OSX CI: Build Status

Introduction

Moai SDK is an open source game framework for quickly developing great mobile games.

You can work in Lua or C++, and Moai SDK runs on multiple platforms including iOS, Android, Chrome, Windows, Mac and Linux.

Download

Please clone the source in the following way.

git clone https://github.com/moai/moai-dev.git
cd moai-dev
git submodule init
git submodule update

Setup

Tools needed to build the MOAI SDK.

The following tools are required to build the API documentation.

Please set the following environment variables.

Mac OSX

export MOAI_BIN=<install_path>/moai-dev/release/osx/host-sdl/bin
export MOAI_CONFIG=<install_path>/moai-dev/samples/config

Linux

export MOAI_BIN=<install_path>/moai-dev/release/linux/host-sdl/x64/bin
export MOAI_CONFIG=<install_path>/moai-dev/samples/config

Windows

set MOAI_BIN=<install_path>\moai-dev\release\win32\host-sdl\bin
set MOAI_CONFIG=<install_path>\moai-dev\samples\config

Build Hosts

Please build according to the following procedure.

Windows Host

cd moai-dev
.\bin\build-win.bat

OSX Host

# Build
cd moai-dev
./bin/build-osx.sh

# Run
cd <sample_directory>
$MOAI_BIN/moai main.lua

iOS Host

cd moai-dev
./bin/build-ios.sh <lua_dir>

Linux Host

# Build
cd moai-dev
./bin/build-linux-sdl.sh

# Run
$MOAI_BIN/moai main.lua

Android Host

# Build
export ANDROID_NDK=<path_to_android_ndk>
cd moai-dev
./bin/build-android.sh

# Edit Setting
cd release/android/host
vi settings-global.sh
vi settings-local.sh

# Run
./run-host.sh

HTML Host

#build
export EMSCRIPTEN_HOME=<path_to_emscripten_1.7.1>
cd moai-dev
./bin/build-html.sh

#run
<http-serve> cmake/build/host-template/www

#see src\host-html\readme.md for more info

Create IDE Projects

Visual Studio

Execute create-projects-win.bat in moai-dev\bin. By default, this creates a Visual Studio 2012 solution in moai-dev\cmake\projects\vs2012. To generate project files for a different version of Visual Studio, specify your desired version (vs2008, vs2010, vs2012, or vs2013) as a command-line argument.

iOS

./bin/create-projects-ios.sh
open cmake/projects/moai-ios/moai.xcproj

OSX

./bin/create-projects-osx.sh
open cmake/projects/moai-osx/moai.xcproj

Sample code

Go to the samples folder, which contains dozens of samples that can be run using one the hosts located in ant (Android), xcode (OSX and iOS), or Visual Studio (Windows).

One of our priorities is to build richer samples for Moai developers, so if you'd like to see a particular code sample, let us know by posting in the Moai forums.

License

This SDK uses the CPAL license. Refer to the for attribution screens to include with games made with Moai.

Forks

Links

Moai Pages

Tutorials

Libraries

Tools