Minecraft Lua Scripts

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 in-game with /script run. Scripts run in named threads, can be stopped individually or all at once, and have access to the game through a straightforward API — worlds, entities, players, redstone, commands, and more.

It's primarily aimed at map and minigame development. Complex event sequences, player detection zones, score tracking, coordinated multi-system logic — things that are painful or outright impossible to build with command blocks alone become quick to write and easy to iterate on.

-- detect players entering an area and trigger a command
local corner1 = {x = 100, y = 64, z = 100}
local corner2 = {x = 120, y = 70, z = 120}

while true do
    local players = world.getPlayersInSquare(corner1, corner2)
    if #players > 0 then
        world.executeCommand("say Welcome to the arena!")
    end
    local t = os.time() + 1
    while os.time() < t do end
end

No build tools. No Java. Just scripts.

For additional information, please refer to the Wiki or the project site.

WARNING

This project is currently in its **ALPHA **stage, meaning it may contain bugs or incomplete features. If you encounter any issues, please report them via the Issues tab on GitHub.

While setters are currently not a priority (since most can be achieved via commands), focus is on expanding getters functionality for now.

Contributions are welcome! Feel free to submit pull requests or suggest improvements.

MLS (Minecraft Lua Scripts)