MLS (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 <game_dir>/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 API documentation, please refer to the Website.

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.

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