ldeffenb / moai-dev

This is the development repo of Moai SDK. Current, but not necessarily tested or stable.

Welcome to Moai!

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

Linux CI: OSX CI:

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.

• Android SDK
• Android NDK (32bit Only, r8e or earlier)
  • windows: http://dl.google.com/android/ndk/android-ndk-r8e-windows-x86.zip
  • linux: http://dl.google.com/android/ndk/android-ndk-r8e-linux-x86_64.tar.bz2
  • osx: http://dl.google.com/android/ndk/android-ndk-r8e-darwin-x86_64.tar.bz2
• Java SE 6
• Ant 1.9
• CMake 2.8.11
• Ruby 1.9
• Visual Studio 2010 (Windows only)
• XCode 4 or 5 (Mac only)
• MinGW64 TCC (Windows only, needed for android luajit support or can build mingw version of moai)
• Emscripten

The following tools are required to build the API documentation.

• Bundler
• Doxygen

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

• patrickmeehan/moai-dev
• moaiforge/moai-sdk

Links

Moai Pages

• Moai Web Site
• Moai FAQ
• Moai SDK Framework Reference
• Moai forums
• Moai Wiki(getmoai)
• Moai Wiki(github)
• Moai API Documentation.
• MoaiFiddle An online Moai editor and player.
• Moai Site Redesign Proposal

Tutorials

• GameFromScratch MOAI Tutorials
• moaisnippets

Libraries

• Rapanui
• Hanappe
• MOAI GUI
• Shilke2D
• Spine MOAI

Tools

• moaicli
• MoaiUtils