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.