AtomiCoffe

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)