Skip to main content
LuAria logo

LuAria

LuAria is a Terraria mobile mod loader and modding platform with a unique approach to mod development. Unlike other loaders, LuAria lets you build and test your mods directly at runtime—avoiding redundant recompilation and re-packaging. It re‑invents how Terraria mods are realized by using interpreted scripting languages such as Lua.

info

These docs are intended for mod developers. If you’re here just to use mods and not develop them, please visit our homepage.

Why LuAria?​

Modding on mobile—especially iOS—has been locked down by strict sandboxing and security rules placed by Apple. LuAria works entirely within the platform’s constraints, giving you a powerful and safe way to mod your gameplay without resorting to hacks.

  • Self-sustainable modding
    Build, test and share your mods at runtime-no external tools needed.
  • No jailbreak or root
    Works on stock iOS & Android devices.

LuAria does all the heavy work—so you can spend your time building mods, not fighting stupid platform limits & restrictions.

Somthing missing?​

If you are looking for help or want to pitch in on this project, you are welcomed to join our Discord Server

Otherwise you can open up a pull request or an issue on anyone of our Github repos.

What's next?​

Check out Getting Started for a set of tutorials to get you on the road with LuAria's ModBuilder.

Credits​

Contributors​

Acknowledge Sources:​

  • lua.org - For providing the Lua scripting language, a crucial part of this loader's functionality.
  • ZipArchive - Used for handling zip files & archives within the mod loader.
  • ImGUI - Used by mods for making custom GUI.
  • @NekoYuzu - For providing libil2cpp decompiled source code.
  • @sneakyevil - For Il2CPP_RESOLVER
  • fishhook
  • @Casssoft - for imgui_lua_bindings (ref)