troytt
ff1f8e4cbe
- Verify 1.13c Bnclient.dll (0x6ff2ed41: cmp ecx, 0x2bf20) sends 4-byte SID_NULL (FF 00 04 00) every 180,000 ms (3 minutes) once the BNCS handshake starts until the BNCS socket closes, and confirm D2MCPClient.dll has no client-side MCP keepalive packet. - Start a 180,000 ms (BNCS_KEEPALIVE_INTERVAL_MS) periodic SID_NULL timer in BncsSession.handshake() and cancel it on close() or stream disconnect. - Echo SID_NULL in FakeRealm wireBncs (matching PvPGN bnetd _client_pingreq) and add FakeClock unit tests for 180s SID_NULL keepalive and >6m idle persistence on character select and lobby screens. - Add lobby-idle subcommand to tools/d2-bot.ts for live WSS idle verification. Fixes #541 |
||
|---|---|---|
| .. | ||
| browser | ||
| d2moo-oracle | ||
| go-oracle | ||
| lib | ||
| refactor | ||
| README.md | ||
| audit-levels-browser.ts | ||
| audit-parity.ts | ||
| audit-skills-d2moo.ts | ||
| benchmark-act-concurrency.ts | ||
| benchmark-entity-concurrency.ts | ||
| create-gitea-skills-milestone.ts | ||
| create-gitea-vendor-milestone.ts | ||
| d2-bot.ts | ||
| d2s-unlock.ts | ||
| drlg-diff.ts | ||
| drlg-fixtures.ts | ||
| dump-format.ts | ||
| gitea-skill-workflow.ts | ||
| inspect-mpq.ts | ||
| make-fixtures.ts | ||
| make-map-fixtures.ts | ||
| make-mpq-fixture.ts | ||
| make-pl2-fixture.ts | ||
| netproto-replay.ts | ||
| pack-all.ts | ||
| render-drlg-compare.ts | ||
| scratch-audit-dt1-inventory.ts | ||
| spike-chrome-net.mjs | ||
| verify-acts.ts | ||
| verify-archive.ts | ||
| verify-audio.ts | ||
| verify-automap.ts | ||
| verify-bundle-no-mpq.ts | ||
| verify-challenger-elite-stats.ts | ||
| verify-challenger-m1-stress.ts | ||
| verify-challenger-m1-tooltip.ts | ||
| verify-challenger-m1-transparency.ts | ||
| verify-challenger-m3-stress.ts | ||
| verify-collision-orientation.ts | ||
| verify-combat.ts | ||
| verify-d2-data.ts | ||
| verify-dc6.ts | ||
| verify-dcc.ts | ||
| verify-deploy.ts | ||
| verify-depth-order.ts | ||
| verify-dt1-pixels.ts | ||
| verify-exp-bar-m1.ts | ||
| verify-format-parity.sh | ||
| verify-formats.ts | ||
| verify-implode.ts | ||
| verify-items.ts | ||
| verify-listfile.ts | ||
| verify-m4.ts | ||
| verify-m5.ts | ||
| verify-monster-dispatch.ts | ||
| verify-monsters.ts | ||
| verify-mpq-roundtrip.ts | ||
| verify-object-lookup.ts | ||
| verify-objects.ts | ||
| verify-play.ts | ||
| verify-png-stress.ts | ||
| verify-renderer-lifecycle.ts | ||
| verify-sprites.ts | ||
| verify-tbl.ts | ||
| verify-widths.ts | ||
| verify-world-graph.ts | ||
| verify-world-walk.ts | ||
| worktree.sh | ||
README.md
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