Atomicoffe Lua API

Atomicoffe exposes a rich Lua scripting API that lets you modify Minecraft server and client behaviour without writing a Java mod.

Script Phases

Scripts are organised into three phases, each with its own directory inside <gameDir>/atomicoffe/:

Phase	Directory	Runs On	Use For
Startup	`startup_scripts/`	Mod init	Item/block registration, tags, mob effects
Server	`server_scripts/`	Server / integrated server	Recipes, commands, events, scoreboard, loot
Client	`client_scripts/`	Client	HUD, keybinds, client↔server networking

Reloading

Run /atomicoffe reload in-game to re-execute server scripts without restarting. Client scripts reload with F3+T.

Every phase has access to these globals:

Symbol	Description
`onEvent(id, fn)`	Register a Lua callback for a named event
`print(...)`	Log values to the mod logger
`logger`	Structured logger table (`info`, `warn`, `error`)

Tags — Add, replace, or remove data-pack tag entries
MobEffectRegistry — Register custom status effects (via mob_effect.registry event)

server — Broadcast messages, manage players, change difficulty/weather
world — Place/read blocks, spawn entities, particles, explosions
command — Register custom slash commands
schedule — Run Lua functions after N ticks or on a repeating interval
network — Send/receive custom packets between server and clients
scoreboard — Read and write scoreboard objectives
data — Persistent per-player key/value storage
config — Persistent mod configuration (JSON-backed)
loot — Add or remove loot table entries
Recipes — Add/remove crafting, smelting, and stonecutting recipes via the recipes event (see Recipes)