MLua

MLua

Minecraft 的纯 Java Lua 风格脚本库模组。

基础库

MLua

MLua 让你用 Lua 编写 Minecraft 模组脚本。脚本可以通过面向玩家、世界、事件、命令、UI 以及已注册内容的 API 与游戏交互。

脚本

开发期间,将脚本放在:

run/mlua/scripts/

模组可以将脚本打包在其 JAR 中的:

assets/<modid>/mlua/scripts/

它会识别以下脚本类型:

*.mixin.lua      mixin 脚本
*.registry.lua   注册脚本
*.commands.lua   命令脚本
*.server.lua     服务端脚本
*.client.lua     客户端脚本
*.lua            模块脚本

API 参考

MLua 会在 Minecraft 客户端中生成其文档。启动游戏后打开 run/mlua/docs/index.html。它会显示该构建中可用的 API。

示例

local Players = Minecraft:GetService("Players")
local World = Minecraft:GetService("World")

Players.PlayerAdded:Connect(function(player)
    player:SendMessage("Hello from MLua!")
    player:SetGameMode(GameMode.Creative)
end)

World:SetWeather(Weather.Clear)

从其他模组使用 MLua

将 MLua 包含在你的模组中,并将其声明为依赖项。