Lua的巫师

Wizards of Lua 将 Lua 编程带入 Minecraft，允许服务器管理员直接在游戏内运行 Lua 脚本。这个基于 Fabric 的重写版本源自原本已经过时的 Forge 模组，为模组开发者、服务器管理员和高级用户提供了更强的控制力和灵活性。

应用场景

• 实现自定义命令、规则和行为。
• 在 Minecraft 环境中开发引人入胜的小游戏。
• 自定义游戏机制以满足你的服务器需求。

示例

你可以用自定义 Lua 脚本改造你的 Minecraft 服务器。以下是一些可能的例子：

• 小游戏： 构建诸如山丘之王、夺旗战或 Journey 之类的游戏。
• 领地声明： 实现一个允许玩家圈定特定区域用于个人建造的系统。
• 攻击性蜜蜂： 创造一种新的蜜蜂，见到玩家就会攻击。
• 安全区： 建立禁用玩家对战（PvP）的区域。
• 魔法法杖： 开发一根能召唤闪电攻击敌对生物的法杖。
• 垂直矿车： 设计一种能借助梯子垂直上升和下降的矿车。

主要特性

• 在游戏内运行 Lua 脚本： 使用 /lua 命令后跟你的脚本，即可直接在 Minecraft 中执行 Lua 代码。
• 修改 Minecraft： 使用丰富的 Lua API 放置方块、召唤生物、处理玩家事件并创造新的机制。
• 即刻开始编写脚本： 直接使用 Lua 编写代码。无需了解 Java 或模组开发框架。
• 使用外部脚本文件： 引入存储在 config/wizards-of-lua 文件夹及其子目录中的 Lua 文件。
• 带自动补全的编码： 在 Visual Studio Code 中编辑脚本，享受 IntelliSense 和完整的类型支持。
• 脚本实时更新： 在 Minecraft 运行时修改你的脚本。它们会在被使用时自动重新编译。无需重启服务器。
• 创建即时或持久效果： 编写快速脚本实现即时更改，或开发长时间运行的程序，在数小时或数天内持续影响 Minecraft 世界。
• 定义动态命令： 在运行时创建自定义 Brigadier 命令，调用 Lua 代码并支持自动补全。定义占位符（例如 %i、%player）以将参数传递给 Lua 脚本。
• 在事件上触发脚本： 使用基于事件的脚本自动响应游戏内事件，例如玩家加入、破坏方块或挥动工具。
• 监控和管理脚本： 使用 /wol spell list 查看正在运行的脚本，并在需要时使用 /wol spell break 停止它们。
• 实时轻松调试： 使用 print() 或 log() 将输出直接发送到控制台、聊天栏或日志文件。这让你在游戏时也能轻松调试脚本。
• 访问动态服务器数据（可选）： 在脚本中使用 Placeholder API 的值，以便与其他服务器插件进行高级集成。
• 随处可用： 在单人和多人模式下均可创建并运行脚本。
• 无需客户端模组： 一切都运行在服务器端。玩家无需安装任何内容。

---

命令权限

Wizards of Lua 支持像 LuckPerms 这样的权限插件。 你可以使用已定义的权限节点来授予对特定命令的访问权限。

有关权限节点和所需级别的完整列表，请参阅 Commands 文档。

版本管理

本项目使用 语义化版本。版本号格式如下：

MAJOR.MINOR.PATCH-MCVERSION

例如：

4.0.2-1.21.11

- 之前的部分遵循语义化版本，并决定与你 Lua 脚本的兼容性。- 之后的部分表示该模组所构建的 Minecraft 版本。

• 如果 MINOR 或 PATCH 号增加，你可以安全地更新模组。
• 如果 MAJOR 版本号增加，请查阅更新日志，因为可能引入了破坏性更改，你的 Lua 脚本可能需要手动更新。

文档

有关详细文档和即用示例，请参阅文档页面。

快速入门视频

如需快速上手，请观看 YouTube 上的快速入门指南。