troytt
/
diablo2-web
1
0
Fork 0
Code Issues 17 Pull Requests Packages Projects Releases Wiki Activity
diablo2-web/tools/README.md

3.7 KiB
Raw Blame History

tools — 开发者调试、协议重放与自动化验证工具集

tools/ 目录收录了围绕 Diablo II Web (v1.13c) 的命令行辅助工具、无头协议测试机器人、封包回放分析器、存档修改器以及全谱系浏览器自动化验证脚本。

1. 核心工具概览

脚本文件 运行命令示例 功能说明
d2-bot.ts npm run bot -- --help 无头 (Headless) 战网/D2GS 协议测试机器人。基于 src/netproto 直接通过原生 TCP 或 WebSocket 桥走完 BNCS 登录 \rightarrow MCP 选人/建房 \rightarrow D2GS 进图移动/施法全流程，无需启动浏览器即可验证服务端连通性。
netproto-replay.ts npx tsx tools/netproto-replay.ts <file.d2cap> .d2cap 网络抓包录制文件离线重放与解析工具。逐帧还原 Huffman 解压后的 S2C/C2S 十六进制流与解码后的 ServerEvent 明细，用于排查协议死锁或未知操作码。
d2s-unlock.ts npx tsx tools/d2s-unlock.ts <char.d2s> 原版 1.13c .d2s 角色存档一键解锁工具。支持修改角色等级、属性点、技能点、金币，一键点亮全部三难度（Normal / Nightmare / Hell）全部 5 幕小站 (Waypoints) 与通关任务状态，并自动重算 .d2s 校验和。
audit-levels-browser.ts npx tsx tools/audit-levels-browser.ts 全谱系 136 关卡无头浏览器审计工具。驱动 Playwright 遍历 Levels.txt 中全部 136 个关卡 ID，校验 DRLG 地图生成、通用 DT1 加载、出生点连通性（非虚空）与 WebGL2 瓦片渲染零报错。
drlg-diff.ts npx tsx tools/drlg-diff.ts DRLG 确定性差分对比工具。给定相同的 mapSeed 与 areaId，对比本仓库 DRLG 输出与 D2Common.dll Ground Truth 房间拓扑、瓦片 Style/Sequence 及碰撞网格的一致性。
render-drlg-compare.ts npx tsx tools/render-drlg-compare.ts 将 DRLG 生成的关卡碰撞网格、房间边界与瓦片图层渲染为可视化对比 PNG 图像，便于直观排查墙壁接缝与门洞连通性。
verify-play.ts npx tsx tools/verify-play.ts 端到端 play.html 冒烟验证脚本：使用 Playwright 启动客户端，验证战网前端 UI 加载、WebGL2 上下文初始化、静态资产零 404 以及 HUD 交互响应。

2. 专项回归验证脚本 (tools/verify-*.ts)

除了上述日常开发工具外，tools/ 下还包含针对关键子系统的专项无头验证脚本：

  • verify-360-comprehensive.ts / verify-all-features.ts：客户端 360° 全功能特性巡检（面板开关、小地图、技能栏、物品提示框、音效与设置面板）。
  • verify-act-transitions.ts / verify-waypoints.ts：跨幕传送与全部 5 幕小站传送门跳转验证。
  • verify-combat-vfx.ts / verify-lighting.ts：投射物、覆盖层特效 (Overlays) 与分幕环境光照着色器渲染验证。
  • verify-monsters.ts / verify-save.ts：怪物/暗金 Boss 纸娃娃图集加载与 .d2s 存档导入导出闭环验证。

3. 典型使用示例

使用 d2-bot.ts 测试远端 D2GS 连通性

# 通过 WebSocket 桥连接远端战网并自动登录角色创建房间
npm run bot -- \
  --bridge wss://www.laiseek.xyz/d2net \
  --user myaccount \
  --pass mypassword \
  --char MySorceress \
  --game test01

使用 netproto-replay.ts 分析客户端录制的 .d2cap

在浏览器顶部工具栏点击 Packet Inspector 导出 .d2cap 文件后，可在终端离线回放：

npx tsx tools/netproto-replay.ts ./captures/session-2026.d2cap