Atomicoffe
Atomicoffe is a Fabric mod that embeds a full LuaJ scripting engine into your Minecraft server and client. Write scripts once, reload them live with /atomicoffe reload no restarts, no recompiling, no Java required.
What can you do with it?
- Custom commands register Brigadier commands directly from Lua
- Event hooks react to player join/leave/death, block interactions, entity kills, chat, ticks, and more
- Recipes add or modify shaped and shapeless crafting recipes at runtime
- Loot tables inject drops into any vanilla loot table
- Scoreboard create objectives and read/write scores from scripts
- Per-player persistent data save and load arbitrary key/value data per player UUID
- Scheduling run callbacks after N ticks or on a repeating interval
- Networking send custom packets between server scripts and client scripts
- Tags add items/blocks to vanilla tags at startup (affects recipes, mechanics, etc.)
- Mob effects apply, remove, and query potion effects from Lua
- Client HUD draw text and rectangles on the player's screen
- Client keybinds register keybinds that trigger Lua callbacks or send packets to the server
Script Phases
| Folder | When it runs |
|---|---|
startup_scripts/ |
Before the server starts for tag/registry changes |
server_scripts/ |
When the server starts and after every /reload |
client_scripts/ |
On the client HUD, keybinds, client-side events |
All scripts live in your instance's config/atomicoffe/ folder and are hot-reloadable.
Quick Example
-- 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)
