LuauAPI

LuauAPI

One shared VM for all your Geode mods that uses Luau.

Write full mods, tools, and APIs in Luau without the C++ stuff. (1)

Easy to start, fast to compile, with clear error logging when something breaks.

READ THE PSA AND NOTES AT THE BOTTOM!!!

Learn more

>>> Read the LuauAPI Documentation <<<

Starting a new project? Use the example mod template.

Need help? Join the Discord.

Currently implemented

• Fully cross-platform on Windows, Android, iOS and macOS
• Real mods written fully in Luau using hooks, callbacks, delegates, saved values and settings (2)
• ~99.9% binding coverage of GD and cocos classes generated from Geode's Broma bindings
• Cross-mod APIs published under your mod id, and C++ mods can expose functions and values too
• Rich built-in libraries like task, imgui, websocket client/server, json, fs, HTTP, keybinds and enums
• 3D viewports, glTF meshes and materials through gd3d
• Sprite rigging and animation through lunar
• Sandboxed with deadlines, memory caps and file access. Errors get logged instead of crashing the game
• In-game developer tools including a live script executor
• Luau LSP autocompletion and strict mode type checking for VSCode (3)
• Full JIT support. JIT-less iOS is not supported

Coming next

• Custom UI builder, framework, pre-made assets
• More advanced animation, 3D functionalites and mesh systems
• The remaining 0.1% of bindings and m_Fields
• Built-in Argon bindings
• Built-in Box2D bindings
• Built-in SQLite bindings
• In-game IDE
• Other QoL features

PSA: NORMAL USERS, READ THIS

Making a crash report

Turn on Enable Crash Context File in LuauAPI's mod settings.

Debugging only!!! it can cause lag, so leave it off after you're done.

Then crash the game. In the Geode Crash Handler window click Open crashlog folder.

Send both files to the developers, the luauapi-last-context.txt and the Geode crashlog.

luauapi-last-context.txt gets overwritten on the next launch, so copy it somewhere safe before restarting.

Never run scripts from strangers

If someone asks you to turn on Developer Mode and execute a script, DON'T.

They're trying to trick you. Running untrusted scripts can:

• Delete your save files
• Steal your account password
• Download viruses onto your computer or phone

LuauAPI is not responsible for any damages caused by unverified scripts. Only download mods from the official Geode SDK index or in-game.

Notes

1. A C++ environment/loader is still required to bootstrap and load the Luau scripts.
2. Certain functionality may be sandboxed or restricted for security and stability.
3. Requires the Luau Language Server VSCode extension by JohnnyMorganz with some setups.

When to still use C++

For now, C++ is still the tool for:

• Heavy data processing and databases
• Low-level functionality and optimizations
• Multithreading

Work is ongoing to shrink this list. These will be solved in the future :3

Credits and Special Thanks

• Juniper (Testing, Debugging, Ideas)
• Cosmella (Testing, Debugging, Ideas)
• Erymanthus (Testing, Debugging, Review)
• YellowCat98 (Early Testing)

They might not contribute code directly to the project, but they help along the way and guide the project in a better direction.