gitmyhub

MonetLoaderOSS

C ★ 24 updated 25d ago

MonetLoader - a Lua script loader for GTA: San Andreas (and SAMP) on Android

A native Android library that loads Lua scripts into GTA: San Andreas and SAMP on Android, aiming for compatibility with the PC modding tool MoonLoader so mobile scripts feel familiar to existing PC mod authors.

CAndroid NDKLuaImGuisetup: hardcomplexity 4/5

MonetLoader is a tool that lets Android users run Lua scripts inside GTA: San Andreas, including the mobile version of San Andreas Multiplayer (SAMP). Lua is a lightweight scripting language widely used for game mods, and this project acts as the bridge that loads those scripts into the game at runtime on Android devices.

The project aims to keep its Lua script support as compatible as possible with MoonLoader, which is the equivalent tool for the PC version of the game. That goal means mobile scripts can be written in a style similar to PC mods, reducing the need to rewrite them from scratch for the Android platform.

From a technical standpoint, the source code is organized into several areas: the core loader, game-specific hooks for GTA and SAMP, a UI layer based on the ImGui library, the main script runtime engine, and a collection of bundled Lua modules. Packaged Lua libraries are included in the distribution folder, and example scripts are provided for reference.

Building the project requires an Android NDK environment, the standard toolkit for compiling native Android code. You configure the build system with the appropriate toolchain settings, run the build, then deploy the resulting library file to external storage on the device alongside a Lua runtime binary and the bundled script data. The README is brief and covers code layout and build steps, but does not describe the available Lua scripting API or document which specific MoonLoader features are and are not supported on the mobile platform.

Where it fits