邦克API

描述

BonkAPI 是一个面向 MegaBonk 的开源遥测框架。它是一个 BepInEx 插件，能够读取实时游戏状态，并通过本地 WebSocket（端口 5556）以 JSON 格式进行流式传输——因此任何人都可以基于它构建外部工具、覆盖层、追踪器和仪表板。

该插件不改变任何玩法：它仅进行观察。包含两个现成的浏览器客户端：实时HUD和实时地图查看器。

源代码：https://github.com/urukaiko/BonkAPI



安装说明

1. 为MegaBonk安装BepInEx 6.x（IL2CPP）。
2. 从“文件”选项卡下载 `BonkAPI.zip` 并解压到任意位置。
3. 将 `BonkAPI.dll` 复制到 `BepInEx/plugins/`。
4. 将 `BonkAPI-web-hud` 文件夹复制到任意位置（例如 `web/hud`）。
5. 将 `BonkAPI-web-map` 文件夹复制到任意位置（例如 `web/map`）。
6. 在浏览器中打开 `BonkAPI-web-hud/index.html` 或 `BonkAPI-web-map/index.html`。
7. 启动游戏——工具会自动连接到`ws://localhost:5556`。

可选：通过查询字符串覆盖端点，例如 `index.html?ws=ws://localhost:5556`。



主要特色

API / 核心
- 本地WebSocket服务器，JSON协议，无需联网
连接时提供完整状态快照，变更时提供差分事件
- 20个追踪模块：玩家、生命值、等级/经验值、31项属性、武器与被动、物品与稀有度、典籍、击杀（按敌人/类别/来源）、各来源伤害（命中、暴击、处决、格挡）、提供与选择（升级、摩艾像、可疑家伙、神龛、微波炉、宝箱）、禁用、资源、可交互物、局内生命周期、关卡事件、地图数据
- 开源，MIT 许可证

实时HUD（浏览器）
- 运行/阶段计时器，带超时指示
- 生命值 / 护盾 / 过量治疗、金币、击杀数、等级 / 经验值、跳过 / 刷新 / 放逐
- 按来源显示伤害明细及每秒伤害
- 武器、物品、典籍、禁用池、可交互物使用
- 运行历史和可筛选事件日志
- 为升级/摩艾石像/可疑人物/神龛提供覆盖层
- 将当前运行导出为JSON以便回放

实时地图（浏览器）
- 生成关卡的2D俯视图和3D环绕视图
- 按类别划分的敌人、拾取物、能量球、可交互对象、首领标记
- 玩家位置与朝向、过滤器、缩放/平移、悬停信息

公平竞争
- 启用“上传分数至排行榜”时，地图数据将自动禁用；每次跑图开始时可见性即锁定。



需求

- 使用 BepInEx 6.x (IL2CPP) 的 MegaBonk
- 现代浏览器
- 释放本地端口 5556
- 无需其他模组或依赖项



公开致谢

- 我的妹妹，是她让我发布这个模组的，这样我就能结束开发过程中无尽的折磨了。



本项目在AI工具的辅助下开发。