MonetLoaderOSS
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.
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
- Run PC-style GTA San Andreas Lua mods on Android using the MoonLoader-compatible scripting environment.
- Create custom game modifications for the Android version of SAMP with ImGui-based overlay menus written in Lua.
- Build and deploy the loader to your Android device using the NDK toolchain, then load custom Lua scripts from external storage.
- Use the bundled example scripts as a reference starting point for writing your own GTA SA Android mods.