MLua
MLua 允许你使用 Lua 编写 Minecraft 模组脚本。脚本可以通过针对玩家、世界、事件、命令、用户界面和注册内容的 API 与游戏进行交互。
脚本
在开发期间,将脚本放置在以下目录:
run/mlua/scripts/
模组可以将脚本打包在其 JAR 文件的以下位置:
assets/<modid>/mlua/scripts/
它将识别以下类型的脚本:
*.mixin.lua 混合器脚本
*.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 并将其声明为依赖项。
MLua
MLua lets you write Minecraft mod scripts in Lua. Scripts can interact with the game through APIs for players, worlds, events, commands, UI, and registered content.
API reference
MLua would generate its documentation in the Minecraft client. Open run/mlua/docs/index.html after launching the game. It shows you the APIs available in that build.
Example
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)
Using MLua from another mod
Include MLua with your mod and declare it as a dependency.
版本游戏版本平台发布时间本站下载
正式版
0.6
MLua 0.6 - Neoforge 1.21.1
1.21.1 NeoForge 56 分钟前 ·
0
1.21.1
NeoForge
56 分钟前
0
下载 MLua
正式版
0.6
MLua 0.6 - Neoforge 26.1.2
26.1.2 NeoForge 56 分钟前 ·
0
26.1.2
NeoForge
56 分钟前
0
下载 MLua
正式版
0.6
MLua 0.6 - Neoforge 26.1
26.1 NeoForge 56 分钟前 ·
0
26.1
NeoForge
56 分钟前
0
下载 MLua
测试版
0.5.0
MLua 0.5.0 - Neoforge 26.1
26.1 NeoForge 3 周前 ·
0
26.1
NeoForge
3 周前
0
下载 MLua
测试版
0.5.0
MLua 0.5.0 - Neoforge 1.21.1
1.21.1 NeoForge 3 周前 ·
0
1.21.1
NeoForge
3 周前
0
下载 MLua
测试版
0.5.0
MLua 0.5.0 - Neoforge 26.1.2
26.1.2 NeoForge 3 周前 ·
0
26.1.2
NeoForge
3 周前
0
下载 MLua
测试版
0.4.0
MLua 0.4.0 - Neoforge 26.1
26.1 NeoForge 2 个月前 ·
0
26.1
NeoForge
2 个月前
0
下载 MLua
测试版
0.4.0
MLua 0.4.0 - Neoforge 26.1.2
26.1.2 NeoForge 2 个月前 ·
0
26.1.2
NeoForge
2 个月前
0
下载 MLua
测试版
0.4.0
MLua 0.4.0 - Neoforge 1.21.1
1.21.1 NeoForge 2 个月前 ·
0
1.21.1
NeoForge
2 个月前
0
下载 MLua
测试版
0.3.2
MLua 0.3.2 - Neoforge 26.1
26.1 NeoForge 2 个月前 ·
0
26.1
NeoForge
2 个月前
0
下载 MLua
0.5.0
测试版
2026-10-26
更新日志
本模组专注于提升运行速度、稳定性以及易用性。大多数改动都在后台进行,因此 Lua API 的使用体验仍应保持熟悉。
运行时与 Lua
- Java 和 Lua 现在能更流畅地协同工作。
- Java 调用效率更高,反射开销更小。
- 脚本、服务和库的管理更加便捷。
- 重新加载时会自动清理残留资源。
- 新增对附加模块、纹理和共享资产的支持。
- 重新加载时会跳过未更改的脚本。
- 重构了脚本加载及生命周期处理逻辑。
- 脚本错误现在不太可能影响其他脚本。
- 客户端和服务端任务现在能更一致地在正确的线程上运行。
- 新增检查机制,防止在多人游戏中回调过早执行。
- 更新了 Java 代理、Luau 库、数学辅助函数和反射的支持。
世界与实体 API
- 重构了世界和实体 API 以保持一致性。
- 向量、位置、射线投射和变换的行为现在更加一致。
- 更新了区块处理和方块实体支持。
- 实体搜索和过滤现在更加可靠。
- 玩家功能现拆分为更简单的 API。
- 实体 API 在不同 Minecraft 版本间的行为现在更加一致。
- 实体数据的保存和清理现在更加可靠。
- 重构了实体生成、导航及附近实体搜索。
脚本化实体
- 重构了脚本化实体的移动、目标锁定和攻击方式。
- 实体的移动和行为现在使用共享系统。
- 实体查询现在生成的临时数据更少。
- 游戏过程中可以更安全地替换实体回调。
- 实体模型和渲染回调现在拥有独立的归属注册表。
物品与背包
- 物品回调在不同支持版本间的工作表现更加一致。
- 重构了物品使用、弓、副手动作和装备的处理逻辑。
- 空背包槽位的行为现在保持一致。
- 修复了涉及空槽位的背包刻问题。
- 装备槽位现在使用一致的索引,并提供了更清晰的文档说明。
- 新增了覆盖常见物品和背包交互的测试。
- 重组了进度、计分板、粒子效果和世界生成的服务。
注册表与生成内容
- 注册表处理现在独立于运行时生命周期。
- 注册物品、方块、实体、模型、声音和其他内容变得更加简单。
- 数据包现在可以在专用服务器启动期间生成。
- 配方在生成前会检查无效数据。
- 配方的成分和编码现在分开处理。
- 当脚本被替换时,注册表的更改现在可以更安全地回滚。
- 注册表查找现在复用缓存值以减少开销。
渲染与动画
- 渲染和动画系统现在具有更清晰的归属权。
- 渲染回调现在在正确的客户端线程上运行,并提供更清晰的错误报告。
- 摄像机移动和视野(FOV)过渡现在更加平滑。
- 第一人称手部动画现在复用缓存数据。
- 模型变换和姿态恢复现在更加一致。
- 重构了动画归属、纹理处理和重新加载清理。
- Blockbench 动画和自定义世界渲染现在使用共享系统。
- HUD 渲染现在会跳过不必要的操作。
- 摄像机、动画模型、动态纹理和渲染回调现在共享更多的渲染状态。
UI 与输入
- 重构了屏幕和 GUI 元素的管理方式。
- 屏幕、小部件和点击处理现在使用更简单的 API。
- 原生小部件方法的解析现在更加安全。
- 键盘输入和键绑定现在在正确的客户端线程上运行。
- 屏幕回调不再在客户端就绪之前执行。
- 关闭原版屏幕现在会清除残留的运行时引用。
- 聊天、菜单、屏幕图层和 GUI 控件现在拆分为更小的 API。
服务与文档
- 重组了世界、实体、玩家、GUI 及其他服务。
- Java 反射和服务集成现在更加一致。
- 附加模块文档现在拥有独立的生命周期。
- 更新了 API 文档、导航、纹理路径和服务引用。
- 新增了更多入门脚本、共享类型、Java 服务和第一人称支持。
- 脚本加载现在支持更新的命名空间和附加模块系统。
- 任务、进度、游戏规则、附魔和事件现在拥有更简单的服务处理。
性能与清理
- 通过复用缓存数据减少了重复工作。
- 创建的临时对象减少,降低了内存开销。
- 旧动画、回调、GUI 元素和运行时资源的清理现在更加可靠。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
Woot Revived
pharuxtan
一个用于收集生物掉落物的多区块模组。
生物科技
349
模组
玉Jade ?
Snownee
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
实用前置
339
模组
Fast Noise
omo50
原版世界生成优化模组
优化世界生成
242
模组
KubeJS
Lat
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
前置实用
239
模组
物品管理器Just Enough Items (JEI)
mezz
查看物品与配方
前置实用
239
模组
Xaero的小地图
thexaero
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
冒险交通
238
评论 0
登录后参与评分
还没有评论,来抢沙发吧