HOOZiDocs
Skip to content

AI Assistant Pack

The entire API knowledge bundled as a downloadable pack. Install once; your AI assistant picks up the reference, conventions, and examples when you touch HApex3.0 Lua scripts.

~40 KB · Single pack supports Claude Code / Codex CLI / opencode / Aider


Supported AI tools

ToolEntry fileInstall path
Claude CodeSKILL.md (with dispatch frontmatter)~/.claude/skills/hapex3-lua/
OpenAI Codex CLIAGENTS.md~/.codex/hapex3-lua/ + reference appended to ~/.codex/AGENTS.md
opencode TUIAGENTS.md~/.config/opencode/hapex3-lua/ + reference appended to ~/.config/opencode/AGENTS.md
Aider / other AGENTS.md toolsAGENTS.mdManual placement

The pack ships both SKILL.md (Claude Code dispatch entry) and AGENTS.md (universal multi-tool entry). The two are content-equivalent; the references/ directory is shared.

Pack structure

hapex3-lua-skill.zip
├── hapex3-lua/
│   ├── SKILL.md                     # Claude Code entry (with frontmatter)
│   ├── AGENTS.md                    # Codex / opencode / universal entry
│   └── references/                  # Lazy-loaded details
│       ├── api-reference.md         # 15 modules, full API (~1400 lines)
│       ├── guide.md                 # Project layout / IPC / timing / pitfalls
│       └── examples.md              # 8 complete example scripts
├── README.md                        # User-facing install notes
├── install.ps1                      # Windows one-click installer
└── install.sh                       # macOS / Linux one-click installer

Install

One-click script

PlatformInstall to all toolsInstall to one
Windows.\install.ps1.\install.ps1 -Target claude
macOS / Linux./install.sh./install.sh --target=claude

-Target / --target= accepts claude / codex / opencode / all (default).

The installer detects and overwrites any prior version. For Codex / opencode it also appends one reference line to the corresponding AGENTS.md (with marker # === hapex3-lua pack (auto-managed) === so reinstalling never duplicates).

Manual install

Copy the hapex3-lua/ directory to the target tool's location:

ToolTarget directory
Claude Code~/.claude/skills/hapex3-lua/ (Windows: %USERPROFILE%\.claude\skills\hapex3-lua\)
Codex CLI~/.codex/hapex3-lua/ (Windows: %USERPROFILE%\.codex\hapex3-lua\)
opencode~/.config/opencode/hapex3-lua/

For Codex / opencode, also append one line to the tool's AGENTS.md:

See `<install-path>/hapex3-lua/AGENTS.md` for HApex3.0 Lua scripting context.

What's in the pack

  • Full API reference for all 15 Lua modules (signatures / parameters / returns / behavior)
  • Conventions & common pitfalls: colon vs dot, 1-based Combobox, draw.* must be called every frame, no input.is_down(vk) on dual-machine setups, resource auto-cleanup boundaries, gui.set is same-frame visible
  • 8 complete example scripts: keybind hints · ESP text · color themes · perf HUD · config presets · loot inspector · WebSocket push · damage logger
  • Project structure, load order, cross-script communication, frame_update cadence

Verify the install

After starting the tool, try:

I want to write a HApex3.0 Lua script that draws a red crosshair in the screen center

Expected output should:

  • Wrap the drawing in event.on("frame_update", function(e) ... end) (not at script top level)
  • Use draw.line with draw.rgba(1, 0, 0, 1)
  • Get screen center from draw.screen()

If the output matches that style, the pack is working.

Trigger scenarios

The pack applies when the user mentions:

  • Writing / editing / debugging a .lua script (HApex3.0 / HOOZi)
  • A specific API: gui.find / esp.add / net.http / draw.text / game.localplayer / event.on, etc.
  • "How do I make an ESP / watermark / notification / hotkey hint" type questions
  • Porting old scripts to the current API

General HApex3.0 / HOOZi usage questions unrelated to scripting do not trigger this pack.

Upgrades

When a new version is released, re-download the zip and run the installer. The old directory is replaced; the AGENTS.md reference line is never duplicated.

Feedback

Pack content stays in sync with the wiki's English locale. If an API description doesn't match runtime behavior, please report it; the fix lands in the next release.