HApex 3.0 Lua脚本开发文档

用 Lua 扩展菜单 · ESP · 网络 · 事件 · 绘制

菜单与控件

Tab / Window / Groupbox 容器；checkbox · slider · combobox · multi_dropdown · color_edit · input_text · button · keybind_control · live_table · tips

ESP 元素

一行 esp.add 注册自定义文字 / 进度条 / 混合 / 自由绘制；4 种 scenario 独立配色，槽位可视化排版

事件

渲染帧 · 菜单显隐 · 玩家生命周期（倒地/复活/死亡/重生）· 自定义事件；脚本卸载时订阅自动清理

网络

HTTP GET / POST 全异步；WebSocket 4 回调（open · message · error · close）

实时数据

本地玩家 · 敌人 · 物资 · 投掷物 · 瞄准 · 死亡圈 · 地图 —— read-only 快照

绘制

线 · 矩形 · 圆（含顺时针扇形）· 三角 · 四边形 · 多段线 · 文字（带描边）· 图像（含旋转）· 渐变 · 颜色变换（HSV/lerp/mod_a/darken/lighten）· 裁剪栈

数学与动画

Vec2 / Vec3 全运算符 · 投影 · 6 种缓动曲线

文件与资源

沙盒文件读写 · 目录枚举 · PNG / SVG / 程序生成图像

JSON 工具

encode / decode 双向；配合 HTTP / 文件存档

DMA 内存

get_module_base · find_pattern 模式扫描 · 单读 / scatter 批读（u8..u64 / float / vec / bytes / string）；只读不暴露 write

AI 编程助手 Pack

把整套 API 知识打包成 pack，支持 Claude Code / Codex CLI / opencode / Aider 等，一键安装

文档说明

每条 API 对应一个可调用的函数或字段。示例可直接拷贝运行。

模块速览

══ 核心 9 ═══════════════════════════════════════════════════════════════
event   订阅
gui     菜单 + 配置
esp     ESP 元素
net     HTTP / WebSocket
game    实时数据（read-only）
draw    屏幕绘制
math    向量 + 投影 + 动画
file    文件 + 图像
input   按键状态 + 显示

══ 工具 8 ═══════════════════════════════════════════════════════════════
log     诊断日志
notify  用户提示
script  load / unload
time    now · delta · game · frame_count
config  plan 切换
json    encode · decode
utils   base64 编解码
mem     DMA 读 · 模式扫描 · scatter batch

完整字段表按模块拆分在侧栏 API 章节。

示例脚本

下列 8 个脚本随程序安装到 scripts/ 目录，可参考或直接修改。完整源码见入门指南。

脚本	功能
`keybind_hint_pack.lua`	给按键控件挂动态文字与颜色提示
`low_health_alert.lua`	队友倒地 · 自己 / 队友低血时一次性提示
`tactical_theme.lua`	一键切换 ESP 配色主题，4 种 scenario 各自上色
`perf_hud.lua`	浮动窗口显示 FPS · 帧时 · 实体数
`loadout_presets.lua`	多套配置预设一键切换，浮窗显示当前
`loot_inspector.lua`	当前掉落物快照浏览 · 名字 · 距离 · 等级
`remote_config_push.lua`	WebSocket 接收 `path=value` 命令热改菜单
`damage_logger.lua`	伤害日志本地 CSV + HTTP 归档