Lua Runtime

Lua Runtime

A mod that adds Lua scripting to Minecraft.

by
1.5K Downloads
fabricutility
Rent Server with this Mod

Screenshots

Lua Screen Demo

About this Mod

Add Lua scripting to Minecraft!
Still in development.

Some notes to start with

  • Don't forget to check the source code of scripts as it could be malicious. We're not responsible for any bans or damages caused by scripts.
  • If the game crashes due to this mod, then its probably not caused by this mod, rather caused by scripts.
  • If the game crashes after updating the mod, then try deleting the config at [Minecraft folder]/config/lua_runtime_config.json

Benefits of using the mod

  • Backwards compatibility: All scripts made for older versions of Minecraft will work on newer versions of Minecraft. (breaking changes are in alpha versions)

Using the mod

Adding mods

Drag and drop Lua scripts into the lua folder in your Minecraft instance folder.

Example script

print("Hello World!")
Minecraft.AddClientLoadedListener(function()
  local gui = Minecraft.CreateNewGUI("Lua Screen")
  gui.Display()
end)

Available Versions

Lua Runtime 0.13alpha
MC 1.21.6, 1.21.7, 1.21.8fabric
July 23, 2025
Lua Runtime 0.12alpha
MC 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4fabric
December 21, 2024
Lua Runtime 0.11.1alpha
MC 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4fabric
December 11, 2024
Lua Runtime 0.11alpha
MC 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4fabric
December 5, 2024
Lua Runtime 0.10alpha
MC 1.21.1, 1.21.2, 1.21.3fabric
November 11, 2024

How to Install Lua Runtime on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.8).

3

Install Mod

Open the mod browser in the dashboard and search for "Lua Runtime". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabric

Minecraft Versions

1.21.8, 1.21.7, 1.21.6 (+5 more)

Server-side

~ Optional

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

Lua Runtime server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.8). You can switch loaders with one click in the panel.

Is Lua Runtime compatible with fabric?

Lua Runtime officially supports fabric for Minecraft 1.21.8, 1.21.7, 1.21.6. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with Lua Runtime – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Lua Runtime consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install Lua Runtime with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
GNU Lesser General Public License v3.0 or later
Server-side
Optional

Supported Versions

1.21.81.21.71.21.61.21.41.21.31.21.21.21.11.21