Scripting

Opus ships an embedded Lua 5.4 engine with a ZeroBot-compatible API so players can load community scripts and write their own automations, HUDs, and event handlers.

Quick start

1. Drop a .lua file next to opusbot.dll
2. Open Opus → Scripts tab → Load
3. Or set lua_scripts=your_file.lua in opusbot_cmd.txt

function onTick()
  print("HP " .. tostring(Player.getHealthPercent()) .. "%")
end

Docs in this section

Page	Contents
Overview	Lifecycle, sandbox, how to load
API reference	Game, Player, Map, Engine, …
Events	Game.registerEvent payloads
HUD	Text, panels, item sprites
HUD Builder	Native overlays, Compact preset, .ophud.json, AI share
Examples	Auto-bless, death hotkey, vitals HUD
Config	lua_scripts, HUD bar keys, IPC

Built for upload to a Docusaurus docs site (MDX-ready Markdown).