MLS (Minecraft Lua Scripts)
by useresses3
MLS, short for Minecraft Lua Scripts, is a Forge mod that lets a player author and execute Lua code in the game with no mod project or recompiling involved.
What it does
Scripts are placed as .lua files in the luascripts folder and executed in-game, so changing a script never requires recompiling a mod. MLS acts as a Lua adapter over the Forge API, giving scripts a straightforward interface to worlds, entities, players, redstone and commands.
Each script runs in a named thread that can be started and stopped on its own. Its main audience is map and minigame builders, since multi-stage event flows, detection regions, scoreboards and logic spanning several subsystems are impractical to assemble from command blocks by hand. Installation requires only Forge, and the environment is client and server, so servers and players both run it. Files exist for 1.16.5 only, with 0.3-ALPHA as the latest file, released under the MIT License as open source.
Key features
Lua script execution
Lua files dropped into the luascripts folder are run in-game, so edits take effect without rebuilding anything.
Forge API adapter
MLS exposes worlds, entities, players, redstone and commands to scripts through a small, direct API.
Threaded scripts
Each script runs in its own named thread, which can be stopped individually while the others keep running.
Minigame and map logic
Event sequences, player detection zones and score tracking can be coded as scripts for custom maps and minigames.
Gallery
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Minigame development
Map makers can write round logic, scoring and win conditions in Lua instead of chaining command blocks.
Automating tasks
Scripts can automate repeated in-world actions, such as timed events or entity behavior, on a running world.
Who it’s for: Map makers and minigame developers who want scripted logic in Minecraft without writing and compiling a separate Java mod. Server owners who run custom maps can also use it, since the server and its players both need the mod.
How it compares
Advanced Computers is a Forge mod for 1.20.1 under the MIT License, also client and server, and it adds in-game computers rather than a scripting adapter. Displadium covers 1.20.1 – 1.20.6 on Forge, runs on client and server, and is licensed as All rights reserved, so its source is not open. GoonieSandersLocalExpanders targets 1.20.1 – 1.21.1 on Forge and NeoForge, is client-side only, and is open source under the MIT License.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| MLS (Minecraft Lua Scripts) | Forge | 1.16.5 | Client and server | 2026-01-12 |
| Advanced Computers | Forge | 1.20.1 | Client and server | 2026-09-22 |
| Displadium | Forge | 1.20.1 – 1.20.6 | Client and server | 2026-03-20 |
| GoonieSandersLocalExpanders | Forge and NeoForge | 1.20.1 – 1.21.1 | Client-side only | 2025-12-18 |
Questions
Which loader does MLS need?
Does the server need MLS?
Where do scripts go?
In the catalog
MLS (Minecraft Lua Scripts) is one of 8,499 Technology mods on ModsFinder, and one of 4,122 Technology mods for Forge. 5,992 mods support Minecraft 1.16.5.
Similar mods
What the author says
Minecraft Lua Scripts (MLS) is a Forge mod that lets you write and run Lua scripts in Minecraft without creating a mod. MLS is essentially a Lua adapter for the Forge API. Instead of setting up a mod project and recompiling on every change, you write.lua files, put them in the /luascripts/ folder, and execute them…
Official listing
- Modrinth page
- modrinth.com/mod/minecraft-lua-scripts
- Owner
- useresses3
- Published
- 2026-01-12
- Updated on Modrinth
- 2026-01-12
- Facts verified
- 2026-10-15