HApex 3.0 Lua · 脚本开发文档
用 Lua 扩展菜单 · ESP · 网络 · 事件 · 绘制。每条 API 对应一个可调用的函数或字段，示例可直接拷贝运行。
先看 入门指南 跑通第一个脚本，再按下表进对应模块；完整字段表按模块拆分在侧栏 API 章节。
模块导航
| 模块 | 能做什么 |
|---|---|
菜单与控件 gui | Tab / Window / Groupbox 容器；checkbox · slider · combobox · multi_dropdown · color_edit · input_text · button · keybind_control · live_table · tips |
ESP 元素 esp | 一行 esp.add 注册自定义文字 / 进度条 / 混合 / 自由绘制；4 种 scenario 独立配色，槽位可视化排版 |
事件 event | 渲染帧 · 菜单显隐 · 玩家生命周期（倒地/复活/死亡/重生）· 自定义事件；脚本卸载时订阅自动清理 |
网络 net | HTTP GET / POST 全异步；WebSocket 4 回调（open · message · error · close） |
实时数据 game | 本地玩家 · 敌人 · 物资 · 投掷物 · 瞄准 · 死亡圈 · 地图 —— read-only 快照 |
绘制 draw | 线 · 矩形 · 圆（含顺时针扇形）· 三角 · 四边形 · 多段线 · 文字（带描边）· 图像（含旋转）· 渐变 · 颜色变换（HSV/lerp/mod_a/darken/lighten）· 裁剪栈 |
数学与动画 math | Vec2 / Vec3 全运算符 · 投影 · 6 种缓动曲线 |
文件与资源 file | 沙盒文件读写 · 目录枚举 · PNG / SVG / 程序生成图像 |
JSON 工具 json | encode / decode 双向；配合 HTTP / 文件存档 |
DMA 内存 mem | get_module_base · find_pattern 模式扫描 · 单读 / scatter 批读（u8..u64 / float / vec / bytes / string）；只读不暴露 write |
模块速览
══ 核心 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示例脚本
下列 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 归档 |