Описание
# 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 `/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.
```lua
-- 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**](https://tkrartem.github.io/MLS_MinecraftLuaScripts).
#### 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.**