
AtomiCoffe
用Lua让你的服务器焕发生机。Atomicoffe是一个Fabric脚本模组,让你可以通过热重载的Lua脚本添加自定义命令、事件、配方、战利品表、HUD等。
Atomicoffe
Atomicoffe 是一个 Fabric 模组,将完整的 LuaJ 脚本引擎嵌入到你的 Minecraft 服务器和客户端中。只需编写一次脚本,即可通过 /atomicoffe reload 实时重载——无需重启、无需重新编译、无需 Java 知识。
你能用它做什么?
- 自定义命令 直接从 Lua 注册 Brigadier 命令
- 事件钩子 响应玩家加入/离开/死亡、方块交互、实体击杀、聊天、tick 等事件
- 配方 在运行时添加或修改有序合成与无序合成配方
- 战利品表 向任意原版战利品表注入掉落物
- 记分板 创建计分项并从脚本读写分数
- 每玩家持久化数据 按玩家 UUID 保存和加载任意键/值数据
- 调度 在 N 个 tick 后或按重复间隔运行回调
- 网络 在服务器脚本与客户端脚本之间发送自定义数据包
- 标签 在启动时将物品/方块加入原版标签(影响配方、机制等)
- 生物效果 从 Lua 施加、移除和查询药水效果
- 客户端 HUD 在玩家屏幕上绘制文本和矩形
- 客户端按键绑定 注册按键绑定,触发 Lua 回调或向服务器发送数据包
脚本阶段
| 文件夹 | 运行时机 |
|---|---|
startup_scripts/ |
服务器启动前,用于标签/注册表更改 |
server_scripts/ |
服务器启动时以及每次 /reload 之后 |
client_scripts/ |
客户端 HUD、按键绑定、客户端侧事件 |
所有脚本位于你的实例的 config/atomicoffe/ 文件夹中,并支持热重载。
快速示例
-- config/atomicoffe/server_scripts/welcome.lua
onEvent("player.join", function(e)
e.player.tell("§aWelcome, §e" .. e.player.name .. "§a!")
e.player.give("minecraft:bread", 8)
end)
command.register("ping", function(ctx)
ctx.reply("Pong! TPS: " .. server.getTps())
end)
schedule.every(6000, function() -- every 5 minutes
server.broadcast("§b[Info] §fNeed help? Check our Discord!")
end)
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。