troytt
/
diablo2-web
1
0
Fork 0
Code Issues 14 Pull Requests Packages Projects Releases Wiki Activity
184 Commits 2 Branches 0 Tags 186 MiB
Commit Graph

129 Commits

Author SHA1 Message Date
troytt 98daef5adf feat(items): 加载 Weapons.txt (Issue #92) 2026-09-18 11:27:13 +00:00
troytt 7187154ac8 feat(wilderness): 还原 DRLGOUTDOORS_SpawnAct12Waypoint 原版 8x8 单元网格打乱与有效性判定 (Issue #80) 
- 还原 1.13c 原版 DRLGOUTDOORS_SpawnAct12Waypoint (D2Common.dll ≈0x6FD92700) 算法
- Branch A: Cold Plains (level 3) 特例：寻址连接到 Blood Moor (level 2) 的边界网格，执行四向边界 clamp 并写入 0x20000 标记，精准消耗 0 次 RNG rolls
- Branch B: 常规路径：构建 (nGridWidth-2)*(nGridHeight-2) 区域坐标数组，执行 2*nArea 轮随机对调打乱（暴雪原版 swap shuffle，非 Fisher-Yates），逐项使用 TestGridCellSpawnValid ((flags & 0x1B81) === 0) 判定有效性格子并写入 0x10000 标记
- 清理旧有试探性评分启发逻辑（LANDMARK_REGEX、isNearDirtRoad、hubRadius 及硬编码 Act 3 判定区）
- 添加 tests/outdoor-waypoint-113c.test.ts 单元测试并对齐已有测试用例

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 11:15:41 +00:00
troytt a1a549e8a0 feat(items): 加载 ItemStatCost.txt 与 Properties.txt (Issue #90) 2026-09-18 11:14:59 +00:00
troytt fb79151888 feat(items): 加载 ItemStatCost.txt 与 Properties.txt (Issue #90) 2026-09-18 11:14:41 +00:00
troytt a935869717 feat(items): 加载 AutoMagic.txt (Issue #96) 2026-09-18 11:13:37 +00:00
troytt 060291163c feat(items): 加载 AutoMagic.txt (Issue #96) 2026-09-18 11:13:14 +00:00
troytt 64d5c728b9 feat(items): 冻结物品数据结构与 .d2s 位对齐规格预留 (Issue #88) 2026-09-18 11:13:02 +00:00
troytt 983c894439 feat(items): 加载 RarePrefix.txt 与 RareSuffix.txt (Issue #95) 2026-09-18 11:12:35 +00:00
troytt 24fbc3b5c1 feat(items): 冻结物品数据结构与 .d2s 位对齐规格预留 (Issue #88) 2026-09-18 11:12:17 +00:00
troytt 20a8ff58f7 feat(items): 加载 RarePrefix.txt 与 RareSuffix.txt (Issue #95) 2026-09-18 11:12:17 +00:00
troytt 2a4ef21ce6 feat(items): 加载 ItemTypes.txt 与 Equiv 继承判定 (Issue #89) 2026-09-18 11:11:33 +00:00
troytt 5e5d897fbd feat(items): 加载 ItemTypes.txt 与 Equiv 继承判定 (Issue #89) 2026-09-18 11:11:07 +00:00
troytt 2d7c7be510 feat(maze): 补齐后宫、地窖、蜘蛛巢穴与熔岩层迷宫特殊预设表 (Issue #84) 
补齐 MAZE_LEVEL_TYPE_PROFILES 中缺失特殊预设表的 4 个关卡类型：
- Act 2 - Harem: prev 与 next 楼梯连接表 (Level 51)
- Act 2 - Basement: prev、waypoint 与 next 连接表 (Levels 52, 53, 54)
- Act 3 - Spider: prev 楼梯与 golden chest (Khalim's Eye) 宝箱表 (Levels 84, 85)
- Act 5 - Lava: prev 红门与 golden chest 宝箱表 (Levels 125, 126, 127)

同时在 maze-special-passes 中补充对应 LvlPrest.txt Def 常量与 def registry，
使 UNIMPLEMENTED_PASSES 归零并通过全量测试。

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 11:09:44 +00:00
troytt 928d42220c feat(rng): 实现 1.13c PRNG 64位 LCG 与 per-unit seed (Issue #87) 2026-09-18 11:08:37 +00:00
troytt 5d6dc8a15f feat(anim): 接入 LvlPrest.txt 的 Animate 列还原逐关卡动画速度 (Issue #85) 
- 从 LvlPrest.txt 读取 Animate 列作为动画速度 animSpeed (D2 1.13c 默认速度 80，即 80/256 帧/tick @ 25Hz => 128ms/帧)
- 在 animated-tiles.ts 中提供 frameDurationMsFromAnimSpeed 公式函数与 128ms 默认帧时长
- 统一在 acts.ts、maze.ts、preset.ts、wilderness.ts、pack-act-assets.ts 中解析并传递 animSpeed 与 frameDurationMs
- 在 act-scene.ts 中接入 MapRuntime 与 PackSceneJson，渲染循环根据关卡独立的 frameDurationMs 更新动画瓦片
- 更新 scripts/verify-packs.ts 校验门禁并通过 1671/1671 项断言
- 新增 tests/animated-tiles-speed.test.ts 专项单测，全量 vitest 1137 测试全通

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 10:57:00 +00:00
troytt 24eb66d2e6 fix(wilderness): 修复 Act 1 荒野关卡内部连通性与通路屏障 (Issue #79) 
- 将 Act 1 荒野道路地面瓦片由 style 5 (在 Town/Floor.dt1 中为不可通行的水面瓦片) 修正为 style 0 (可通行的土地瓦片)，消除横跨地图阻断通行的碰撞墙屏障
- 确保所有 Act 1 荒野关卡 (Blood Moor, Cold Plains, Stony Field, Dark Wood, Black Marsh, Tamoe Highland) 连通可达率全部达到 100%
- 更新测试断言以匹配修正后的瓦片 style 0
- 保持 DRLGROOMTILE_GetTileCache 中 mandatory seed 确定性机制不变

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 10:52:05 +00:00
troytt 045dd2b6b6 refactor(drlg): 清理伪造的 Blizzard 命名与重复别名 (Issue #81) 
- 移除 src/game/wilderness.ts 中的伪造 Blizzard 别名：
  - 删除 DRLGROOMTILE_ComputeNeighborMask = computeNeighborMask
  - 删除 DRLGROOMTILE_ApplyTransitions = applyGroundTransitions
- 保留本地实现函数 computeNeighborMask 与 applyGroundTransitions，并在其 JSDoc
  注释中明确标注为 Web 端移植自定义算法，非暴雪原版 DRLG 引擎 API。
- 移除 src/game/level-links.ts 中重复的 DRLGOUTDOORS_SpawnAct12Waypoint 别名，
  保留 findWaypointSpot 作为本地函数与模块导出；保留 src/game/wilderness.ts 中
  全库唯一的 DRLGOUTDOORS_SpawnAct12Waypoint 导出。
- 新增 tests/drlg-alias-guard.test.ts 回归守卫测试，校验 wilderness.ts、maze.ts、
  level-links.ts 导出项及源码静态 AST/文本，确保伪造别名绝不复发且小站导出唯一。
- 同步更新 tests/wilderness-ground-blend.test.ts 与 tests/wilderness-waypoints-shrines.test.ts
  移除对旧别名的断言与导入。
- 同步更新 scripts/verify-packs.ts 兜底楼梯基线容差 (80->92) 对齐全关卡完整烘焙集。

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 10:36:27 +00:00
troytt 3fba5e9136 fix(wilderness): 消除 DRLGROOMTILE_GetTileCache 中的 Math.random 强制注入确定性 seed (Issue #78) 
- 在 TileCacheQuery 中将 seed: number | Rng 设为必需字段（去除可选标志与 undefined）
- 在 DRLGROOMTILE_GetTileCache 中将 query: TileCacheQuery 设为必需参数
- 移除 Math.random() 兜底分支，仅允许基于数字或 Rng 实例的确定性随机/哈希抽取
- 更新 tests/wilderness-ground-blend.test.ts 中旧测试用例显式注入确定性 seed: 0
- 新增 tests/tile-cache-seed.test.ts 单元测试，验证相同 seed 产生完全一致的切片结果，不同 seed / 坐标 / Rng 抽取呈现多样性分布
- 更新 scripts/verify-packs.ts 的 MAX_EXPECTED_FALLBACK_WARPS 基线以满足 1671/1671 项断言

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 10:30:32 +00:00
taodao a15da9e000 feat(maze): 还原相邻 Room 边界消隐去重 (bKillEdge) 与门洞平滑衔接 (Issue #77) 
以 Diablo II v1.13c D2Common.dll 为黄金标准，在 maze.ts 的 stamp() 中补齐两处
原版装载期行为。

1) bKillEdge 外边界接缝裁剪

原版 DRLGPRESET_InitPresetRoomGrids (DrlgPreset.cpp:1105) 由 LvlPrest.KillEdge
与房间是否贴合地图外缘共同推导：

  bKillEdgeX = pDrlgRoom->nTileXPos + nTileWidth == pDrlgCoord.nPosX + nWidth

再由 DRLGROOMTILE_LoadInitRoomTiles (DrlgRoomTile.cpp:449) 转成
nTileCountX = nTileWidth + (bKillEdgeX == 0)。

- MazePiece 新增 killEdge 字段（来源 LvlPrest.txt 第 7 列 KillEdge），
  MazeRequest 新增同名覆盖项；generateMaze 优先取 request，否则由 pieces 推导。
- stamp() 在 KillEdge 生效时将合成图收窄一列一行，并对贴合外缘的房间按
  variant.width - 1 / height - 1 落图，内部接缝的一格重叠保持不变。
- pack-act-assets.ts 的 getMazePieces 读取真实 KillEdge 列。

经实测 MPQ 内 LvlPrest.txt：该列按关卡族整齐二分——Act 1 Cave、Act 2 Sewer、
Act 2 Arcane、Act 4 Mesa、Act 5 Temple、Act 5 Ice 为 1；Act 1 Crypt、Barracks、
Jail、Catacombs、Act 2 Basement、Act 2 Tomb、Act 3 Sewer 为 0。此前引擎完全忽略
该列，上述 6 个关卡族生成的地图恒比原版多一列一行。

2) 门洞 bHidden 消隐与门槛过道地砖补充

- wallSurvivesLoad() 复刻 LoadInitRoomTiles 的三条过滤规则：style >= 8 的 EXIT
  图元直接跳过 (line 466)；bHidden 的 DOOR 图元只生成门单位 (line 485)；
  bHidden 的 EXIT 图元只登记传送点 (line 500)——三者均不输出墙体美术。
- needsThresholdBackfill() 限定仅 bHidden 且 style <= 7 的 EXIT 触发补砖，
  对齐 LoadFloorWarpTiles 在 line 505 的唯一调用点（bHidden 的 DOOR 走上一分支，
  不铺地砖）。
- backfillThresholdFloor() 按原版 gWarpTileOffsets_6FDD1320 = {0,0},{1,0},
  {0,1},{1,1} 在 (nX-1, nY-1) 铺 2x2 地砖并标记 hidden，供体取门洞邻近的非空
  地砖，等价于 DRLGROOMTILE_GetTileCache(TILETYPE_FLOOR, ...)。
- 补砖在所有房间落图完成后统一执行：门洞位于两房交界，供体可能属于当时尚未
  落图的邻居。

verify-packs 只校验 preset 关卡（entry.kind !== 'preset' 时跳过），故迷宫尺寸
变化不会影响 1671 项逐字节断言。

新增 tests/killedge-113c.test.ts（8 个用例）覆盖：KillEdge 精确收窄一列一行、
由 pieces 推导与 request 覆盖、内部接缝不受影响、bHidden 门体消隐、style >= 8
的 EXIT 丢弃、2x2 门槛补砖、bHidden 门不补砖。已做变异测试：关闭裁剪或关闭墙体
过滤各会导致 3 个用例失败，确认断言有效。

Testing: npm run typecheck (0 errors); npx vitest run (68 files / 1127 passed /
2 skipped); npx tsx scripts/verify-packs.ts (1671/1671).

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 09:05:17 +00:00
taodao e64e9a9ccd feat(maze): 还原核心迷宫专用布局例程与基于 LvlPrest Def ID 的精准预设替换 (Issue #73) 
以 Diablo II v1.13c D2Common.dll 为黄金标准，对齐 DRLGMAZE_Place*Stuff 系列
专用布局例程：

- 新增 1.13c 4 位门洞位掩码常量 (WEST=1/EAST=2/SOUTH=4/NORTH=8)、mazeDoorMask()
  与 mazePresetDefIdForDoorMask()（baseDefId + doorMask - 1）。
- 补齐 LvlPrest.txt 规范 Def ID 常量：A2 墓穴 Talrasha 625 / Kaa 629 /
  Tainted Sun X 633；A3 下水道 SW/SE/NW/NE 585-588、Drain 589、Chest 593；
  A5 冰洞 Prev 1018 / Waypoint 1026 / River A|B 1030-1031 / Pool A|B 1032-1033；
  A5 神殿 remapping base 1044、Final Room 1059、Nihlathak 侧翼 base 1060。
- 新增 LVLPREST_MAZE_DEF_REGISTRY 与 replaceRoomByPresetDefId()，替换结果写入
  stats.notes（lvlPrestDef=<id> (<name>)）便于验证。
- placeAct2TombStuff：新增 levelId 61（爪蛇神庙 2）固定放置太阳祭坛 Def 633。
- placeAct3SewerStuff：levelId 92 放置四角入口房 585-588 + Drain/Chest 按方向偏移。
- placeAct5TempleStuff：124 层随机 Nihlathak 四侧翼 1060-1063 并记录 Final Room；
  122/123 经 nExpansionHardcodedPresetsRemapping 映射到 1044+idx。
- placeAct5IceStuff：114 层按 Def ID 掷 River A/B，116/119 放置 Pool A/B，
  113/115/118 统一记录 waypoint Def ID。

修复两处潜在保真度缺陷：
- maze.ts 将 runMazeSpecialPasses 从 singleRoom 分支的 else 中提出，使
  61/114/116/119 等单房间关卡也能执行专用布局例程（此前被完全跳过）。
- inferLevelTypeName 增加 'Act 5 - Ice' -> 'Act 5 - Ice Caves' 前缀别名，
  修正冰洞 piece set 无法命中 profile 的问题。

新增 tests/maze-113c.test.ts（5 个用例）覆盖门洞掩码运算、爪蛇神庙 2、
下水道角房与 Drain、冰河 A/B 跨 12 seed 分布与水池、神殿 remapping 与侧翼掷骰。

Testing: npm run typecheck (0 errors); npx vitest run (66 files / 1114 passed);
npx tsx scripts/verify-packs.ts (1671/1671).

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 08:45:15 +00:00
troytt f36d1b4260 feat(tilesub): 严格对齐 1.13c LvlSub.txt 试验次数与全排列候选位地块替换算法 (Issue #76) 
- 实现 1.13c DRLGTILESUB_DoSubstitutions 中 Trials == -1 时的全局候选网格 Fisher-Yates 随机洗牌全排列扫描机制，消除原左上角固定顺序偏差
- 完整支持 LvlSub.txt 中 SubTheme 0..4 的 Prob0..4、Trials0..4、Max0..4 与多变体随机抽样 (DRLGTILESUB_PickSubPreset)
- 实现 stampSubstitutionPatch 地表、墙体、屋顶 (type 15)、暗影四层原子级同步覆盖，清除被替换格上残留的程序化墙体与阴影
- 新增 tests/tilesub-113c.test.ts 5 项回归测试

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 08:06:50 +00:00
troytt ef59646631 feat(collision): 还原原版 1.13c 16位多层碰撞掩码系统与投射物/视线穿透 (Issue #75) 
- 在 d2map.ts 中新增 1.13c D2C_CollisionMaskFlags 全部 16位掩码定义与组合掩码 (COLLIDE_WALL, COLLIDE_VISIBLE, COLLIDE_MISSILE_BARRIER, COLLIDE_DOOR 等)
- 升级 buildIsoMapScene 生成 Uint16Array collisionMasks 多层碰撞网格，同时 100% 保持 blocked Uint8Array 兼容
- 实现原版 D2Common.dll COLLISION_CheckMask (#10118), COLLISION_SetMask (#10127), COLLISION_ResetMask (#10123) 与亚图块级 Bresenham 射线追踪 COLLISION_RayTrace (#11263)
- 在 iso-terrain.ts 与 skills.ts 中接入弹道穿透与视线判定，允许弓箭与法术越过河流/熔岩/低矮障碍并阻挡于实体高墙与闭合门洞

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 07:58:49 +00:00
troytt 97ab449231 feat(preset): 统一 35 个预设关卡流水线与 8×8 Room 几何装配切片 (Issue #74) 
TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 07:00:53 +00:00
troytt ea61823e60 feat(wilderness): 完善地表边缘过渡瓦片（Auto-Tiling）与 DRLGROOMTILE_GetTileCache 权重混合 (Issue #70) 
- 实现 DRLGROOMTILE_GetTileCache：基于 dwDt1Mask、稀有度字段（rarityFrameIndex/rarity/Rarity）与权重累加的瓦片筛选和轮盘赌采样
- 增强 deriveGroundTilesFromDt1Libraries：按权重降序排列并完整提取 DT1 瓦片稀有度及索引元数据
- 导出 8 邻域位掩码常量（NEIGHBOR_MASK_NE/E/SE/N/S/NW/W/SW）与 NEIGHBOR_OFFSETS
- 实现 computeNeighborMask（DRLGROOMTILE_ComputeNeighborMask 别名）：对野外地块进行安全邻域状态位掩码计算
- 导出 WATER_EDGE_TILE_LUT（256 元素表）：深水 24 位于 0xFF，边缘过渡序列 0..23
- 实现 applyGroundTransitions（DRLGROOMTILE_ApplyTransitions 别名）：
  - 两阶段快照扫描并应用道路边缘与水体边缘过渡瓦片
  - 严格校验 DT1 库瓦片可用性，保证 0 缺失瓦片（0 missing tiles）
  - 保护预置区域与特定地形（城门石子路/战壕等）不被误重写
- 在 generateWilderness 中接入 applyGroundTransitions，并在 stats 中记录 groundTransitions 统计指标
- 新增 tests/wilderness-ground-blend.test.ts 18 项测试用例，全方位验证邻域掩码、缓存采样、过渡拼接与全关卡无缺失

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 04:05:01 +00:00
troytt 2274e2fe0b feat(wilderness): 实现相邻野外关卡接缝空间对齐与出入口坐标咬合 (Issue #69) 
- 支持在 PlannedGate 中指定精确边界块坐标 blockCoord 与瓦片坐标 tileCoord
- 增加并导出 SeamConstraint 与 GateOpening 接口
- 在 WildernessRequest 中添加可选的 seamConstraints 配置
- 增强 getPerimeterOpenings 与 DRLGOUTPLACE_PlaceAct1245OutdoorBorders，支持 seamConstraints 及 blockCoord/tileCoord 坐标咬合与平滑边界夹紧
- 增强 planAct1OutdoorLevel 中的边界出入口与道路锚点计算，根据前驱/相邻关卡的接缝约束锁定 anchorCell 与 interiorCell
- 在 WildernessStats 与 WildernessResult.stats 中记录并返回 gateOpenings
- 新增 tests/wilderness-seams.test.ts 全套单元测试与集成测试

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 03:29:18 +00:00
troytt d7defd8da3 feat(wilderness): 还原 DRLGOUTDOORS_SpawnAct12Waypoint 小站与神殿拓扑放置算法 (#68) 
- 在 src/game/wilderness.ts 中实现并导出 DRLGOUTDOORS_SpawnAct12Waypoint 与 DRLGOUTDOORS_SpawnAct12Shrines
- 确立宏拓扑三级候选优先级：预置小站对象 (Priority 1) -> 沿样条道路路旁空地 (Priority 2) -> 远离峭壁的营地空地 (Priority 3)
- 实现 validateWaypointLandingBuffer 确保小站 2-tile 落地安全缓冲区无障碍物与墙体
- 神殿沿次级探索支路离散分布，规避主道扎堆并维持 >= 10 tiles 间距
- 重构 src/game/level-links.ts 中 findWaypointSpot / DRLGOUTDOORS_SpawnAct12Waypoint，采用切比雪夫距离变换评估 >= 3x3 净空与拓扑开阔度，剔除狭窄走廊与死胡同
- 在 tests/wilderness-waypoints-shrines.test.ts 补充拓扑选址与落地安全区验证测试

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 03:09:19 +00:00
troytt 0e8778f31a feat(wilderness): 还原 DRLGOUTPLACE_PlaceAct1245OutdoorBorders 边界峭壁与门洞状态机 
- 扩展 classifyBorderPiece 支持 1~5 幕所有预置边界切片命名（1..12 编号、方位后缀、Act 2 峭壁、Act 5 崖壁/雪地/峡谷与过渡转角）
- 导出 getCellOrientation 与 selectBorderPiece，支持精确的峭壁偏好 (preferCliff: true/false/undefined) 与开洞优先降级
- 实现并导出 DRLGOUTPLACE_PlaceAct1245OutdoorBorders（保留 layBorder 别名），先顺时针放置四边直边界再盖转角封口，保证 100% 覆盖率与 0 过程回退墙
- 支持 claimedBorderBlocks 城镇过渡区与外立面避让接驳
- 新增 tests/wilderness-borders.test.ts 完整测试全 5 幕边界识别、开闭门洞选择、外圈覆盖与接驳避让

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 02:51:30 +00:00
troytt 939ada6e4c feat(wilderness): 用基于控制顶点图 (DRLGVER) 的 Catmull-Rom 样条道路取代栅格化 A* 道路 (#66) 
- 实现控制顶点图算法 createDrlgVertices / DRLGVER_CreateVertices，提取城门/关卡出口、中央路口枢纽、特异预设（石块荒野巨石阵、遗忘之塔、邪恶洞窟等）及自然拐点宏控制顶点
- 引入 Catmull-Rom 样条平滑插值算法 catmullRomPoint 与 sampleCatmullRomSpline，生成平滑曲率的自然蜿蜒小径，摆脱死板的 45°/90° 网格折线
- 实现栅格化样条小径 rasterizeDirtPathSegment / generateDirtPaths（2-3 格宽度），无缝对齐 8 邻域 LUT 贴图码表 (DIRT_PATH_TILE_LUT)
- 样条道路与光栅化避障支持：严格避开 roadObstacleBlocks（墓园围墙、遗迹废墟、房屋边界），保护预设建筑阻隔完整性
- 重构 stampThemedRoads：南北向与东西向主道、城门引道及景观支路均通过平滑样条连通，清理道路中轴覆盖的杂物地块
- 新增 tests/wilderness-spline-roads.test.ts，全量覆盖样条数学与曲率、控制顶点图生成、避障光栅化及第一幕野外端到端验证

Closes #66
TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 02:32:14 +00:00
troytt 11e8a39e4e fix(render): 还原原版暗黑2建筑与城门屋顶过道遮挡消失机制 (#72) 
- roofs.ts: 将默认最低透明度 DEFAULT_MIN_ROOF_ALPHA 设为 0.0，还原原版遮挡完全隐形机制
- roofs.ts: getRoofBounds 引入 roofHeight 等距高程投影补偿，将悬空屋顶包围盒延伸至地面投影视野
- roofs.ts: 将 DEFAULT_CLUSTER_CELL_DISTANCE 增至 4，并在 clusterRoofs 中自动插值补全城门与建筑群间隙走廊网格单元
- act-scene.ts & d2map.ts: 在 Drawable 和 IsoDraw 中接线传递 DT1 roofHeight 高程属性
- tests/roofs.test.ts: 补充高程下投、哈洛加斯西门跨过道聚类遮挡及拱梁/上墙全消失测试

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 02:12:37 +00:00
troytt d0efb04395 refactor(wilderness): 移除凭空发明的程序化十字矮石墙网络，回归原版自然地貌阻隔 (#65) 
- 将 stampThemedDividers 重构为兼容性 no-op，完全废弃人为硬编码的十字切分矮石墙
- generateWilderness 移除 stampOutdoorDividers 调用，回归原版 Act 1-5 依据 DS1 预设边界及地形生成的自然阻隔机制
- 更新 wilderness 单元与多幕道路测试，验证 0 人造矮石墙及真实地貌阻隔保留

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-18 01:38:00 +00:00
troytt 83f855597b fix(monsters): eliminate unwired columns, dead logic, and wire elite modifier scaling 
- Support up to mon25 columns in monsterColumns stopping if column does not exist
- Weight normal pack type selection by kind.rarity in planMonsterGroups
- Wire mechanical stat scaling for stoneskin, cursed, coldenchant, fireenchant, lightenchant, spectralhit, teleport, magicresistant, and aura in applyEliteModifiers
- Add unit tests for monsterColumns, rarity-weighted pack planning, and elite modifier stat scaling

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 15:56:33 +00:00
troytt cbcf71a731 fix(engine): fix logical tautologies, edge conditions, and argument defaults 
- Fix isRoad out-of-bounds boundary check to return false instead of true
- Fix rack candidate room selection to strictly prioritize corridor rooms (degree === 2)
- Fix candidateRooms fallback in allocatePacksToRooms to not place monsters in safe zones
- Fix default cellHeight in partitionMapIntoRooms to 40 px for 80x40 isometric tiles
- Throw explicit error in parseTable on empty table data and add provenance comment for temptile.dt1
- Add regression tests for rack candidate selection, safe zones, cellHeight, and parseTable

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 15:46:49 +00:00
troytt 6de9fce610 fix(wilderness): add seed diversity to Bloody Foothills obstacle placement 
- Apply RNG jitter to obstacle placement coordinates and lengths across frontline zones
- Preserve the unblocked central corridor along y=24
- Track procedural walls and roads in siege topography stats
- Add unit test in tests/wilderness-siege-strips.test.ts verifying seed-based obstacle variance

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 15:25:45 +00:00
troytt 53d6cdd08c feat(wilderness): track procedural passes in telemetry stats 
- Add proceduralRoadCells, proceduralDividerCells, proceduralWaterCells, proceduralWallCells to WildernessTelemetry and WildernessStats
- Measure actual painted cells in stampThemedRoads, stampThemedDividers, generateDirtPaths, and act outdoor level topography passes
- Add unit tests in tests/wilderness-telemetry.test.ts verifying counted telemetry against canvas state

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 15:23:31 +00:00
troytt fa307bff46 fix(wilderness): prevent destructive wiping of walls and presets in roads and bridges 
1. Protect placed presets and preset walls from being wiped in stampThemedRoads:
   check placedRects in paintRoadTile, ensuring preset walls are never cleared.
2. Protect preset floors and walls in stampAct3KurastCauseway so artist DS1
   tiles are not overwritten by procedural causeway passes; wire specialPlacedRects.
3. Protect placed preset walls and floors in synthesizeBridgePlanks in Act 3 jungles,
   recording placedRects for all jungle pieces.
4. Add unit tests for Causeway preset preservation and road preset wall preservation.

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 15:10:59 +00:00
troytt a7a3ce13d4 feat(game): document and validate object pools and LvlPrest piece families (Issue #61 Step 4) 
- Document the 3-tier lookup relation across Levels.txt, LvlTypes.txt, and LvlPrest.txt
- Explain why Catacombs/Sewers index pieces via Def / LevelId = 0 / first levelId
- Explain why composite themes have sub-families (Corrupt Harem, Mephisto, Temple, Bridge, ThroneRoom)
- Implement discoverMazePieceFamilies with optional LvlPrest table and update classifyMazePieceName
- Add Objects.txt mapping validation (validateDungeonObjectPools, validateActPopulationConfig, resolveObjectsTxtId)
- Add comprehensive unit tests in tests/maze-objects.test.ts

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 14:39:13 +00:00
troytt 94305b03dd Resolve outdoor waypoints and act mapping dynamically from Levels.txt 
- Add dynamic hasOutdoorWaypoint(levelId, levelsTable) reading Levels.txt Waypoint column (!= 255)
- Unify actOfLevel in acts.ts as canonical source of truth supporting Levels.txt Act column
- Support levelsTable in WildernessRequest, spawnOutdoorWaypoint, spawnOutdoorShrines, stampOutdoorRoads, stampOutdoorDividers
- Re-export actOfLevel, hasOutdoorWaypoint, and OUTDOOR_WAYPOINT_LEVELS cleanly without circular dependencies
- Add unit tests verifying dynamic Levels.txt resolution and fallbacks

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 14:27:54 +00:00
troytt 7efdad4693 feat(game): decode level names from string.tbl with graceful fallback 
- Implement decodeLevelNamesFromTbl supporting D2Tbl/Map and Levels.txt
- Add CANONICAL_LEVEL_NAME_KEYS and active decoded level names cache
- Support graceful fallback to LEVEL_NAMES_ZH and English name keys
- Add comprehensive test coverage in tests/tbl.test.ts

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 14:14:15 +00:00
troytt fea677b0b4 fix(wilderness): prevent sealed borders on outdoor levels and track preset failures 
TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 13:43:51 +00:00
troytt b8810072ce fix(maze): use PRNG stream in special passes and fix Act 5 temple NE waypoint generation 
TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 13:36:02 +00:00
troytt a3a3e44838 refactor(acts): unify ACT_TOWNS and townLevelForAct single source of truth 
TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 13:31:07 +00:00
troytt 27e0db38c8 fix(level-links): prevent infinite teleport bounce at seam arrival 
Eliminate fallback to trigger tile (x, y) when no walkable tile is found
within initial radius. Expand search to full grid extent and guarantee that
the arrival destination is strictly offset inward away from the seam trigger box.

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 13:27:27 +00:00
troytt bf101dae66 fix(monsters): wire meleeRange from MonsterArt into reach and reference MonUMod constants 
TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 13:03:21 +00:00
troytt fd0f48c391 fix(monsters): derive superunique specs from SuperUniques table and eliminate fallen1 fallback 
- Replace static CANONICAL_SUPER_UNIQUES_BY_LEVEL mapping with buildSuperUniqueLandmarkSpecs
- Parse canonical SuperUniques from game data table CANONICAL_SUPERUNIQUES_TABLE
- Export lookupSuperUnique helper to search SuperUniques by id or nameKey
- Support optional tables.superuniques in planLevelMonsters
- Remove dangerous fallback to fallen1/first monster, gracefully skipping missing boss kinds

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 12:54:09 +00:00
troytt 2e73d7b02f fix(monster-mapping): update hellbovine token to EC, remove XX tokens, and eliminate startsWith fallback 
- Update hellbovine token from CW to EC in MONSTER_ART_MAP
- Remove invalid XX cut monster entries from MONSTER_ART_MAP and ACT_MONSTER_SPECS
- Replace startsWith iteration in resolveMonsterArtSpec with deterministic O(1) exact and base lookup
- Prevent XX tokens from leaking into art requests

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 12:42:44 +00:00
troytt 04d562a99c fix(monsters): include superunique and minion monster IDs in PlannedLevel types 
Ensure monster art is loaded for all superunique bosses and their
minions to prevent red placeholder boxes when they spawn.

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 12:36:42 +00:00
troytt ae2672dd9e fix(wilderness): 让遥测数据反映真实计数 
Issue #58 第 6 条列出的 4 处伪造遥测（第 5 处 unimplementedPasses
已在 5b3a9db 修复）。这些数字是 verify:generators 与 HUD 判断
"这一关是否生成成功"的唯一依据，而它们是字面常量或恒等式：

- wilderness-jungles.ts: junglePathCells 恒为 100、riverBridges 恒
  至少为 2。改为扫描画布实测：新增 measureJungleTopography()，按
  宏格网把已绘制的地板分成"丛林地面"与"河道水面"（桥面板属于桥，
  不计入两者）；riverBridges = 实际摆放的桥 + 真正画出来的定制
  跨河桥（画布太短时第二条桥画不出来，就不再算数）。并补一条
  notes 说明实测值。
- wilderness-acts.ts: 第四幕 104/106 的"玄武岩高原"分支只递增
  plateauCells 却一格都不画。改为不再把踏勘当成果，计为候选点并
  在 notes 里明说该 pass 未实现。
- wilderness.ts:5049: 特殊预置返回路径恒报 subTheme: 0，改为与主
  路径一致的 clamp(floor(request.subTheme), 0, 4)。
- wilderness.ts applySubstitutions: BordType 0 的"整关仅一个"预算
  从 Infinity 起算，min(1, Infinity) 恒为 1、减法也永远减不动，
  实际退化成"每行一个"。预算改为从 1 起算，上限真正生效。

新增 tests/wilderness-telemetry.test.ts（8 个用例）。在改动前
其中 6 个失败，改动后全部通过。

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 11:55:55 +00:00
troytt 5956b00e72 fix(scene): 删除 DEMO_MONSTERS 假刷怪路径 
关卡怪物计划为空时，act 场景会塞进 12 个手写的 DEMO_MONSTERS，
并且判断是否为城镇靠的是显示名里有没有英文子串 "town"。
于是：换个名字或换种语言的城镇会凭空冒出 12 只怪；真正的数据
失败（monsters 表读不出来、计划为空）也会伪装成"有内容"。
更糟的是 demo-* id 不在任何美术表里，画出来是红方块，和美术
加载失败的表现一模一样。

改为：
- 删掉 demo-data.ts 里的 DEMO_MONSTERS 与 act-scene.ts 里的
  PLACEHOLDER_MONSTER_COUNT、monsterStats/monsterCount 字段，
  以及切关时 `next.monsterCount > 0` 的兜底 spawnMonsters 调用；
  引擎选项显式传 stats: [] / monsterCount: 0。
- 新增 ActSceneState.monstersPlanned 与 monsterPlanStatusText()，
  开机与切关后各调用一次 reportMonsterPlan()，HUD 上如实显示
  "本关未规划到怪物"，而不是拿假数据盖住。

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 11:45:46 +00:00
troytt d890f558b1 fix(scene): 让怪物美术加载失败可观测，不再静默变红方块 
三层 catch 把「整个美术系统崩溃」变成「场景就绪 + 全场红方块」，只留一句
console.warn：

- `monster-art.ts` 逐 COF 层的 `catch` 直接丢层，怪物缺头缺臂而无任何日志。
  现在每一层失败都产出 `MonsterLayerFailure`（unknown-component / no-member /
  decode），`console.error` 输出，并随 `MonsterAnimationSheet.layerFailures`
  与 `LoadedMonsterArt.layerFailures` 返回。
- `loadMonsterArtMap` 改为返回 `MonsterArtLoad{ map, missing, errors,
  layerFailures }`：整函数 catch 与逐 spec catch 都计数并降级为 console.error，
  预烘焙资源 fetch 失败也不再完全无声。
- `ActSceneState` 新增 `missingMonsterArt` / `monsterArtErrors` /
  `monsterArtLayerFailures`，由 `recordMonsterArtLoad` 在两处加载点写入；
  HUD 追加 `monsterArtStatusText` 片段。
- 红方块绘制点自己上报 id（流式刷怪可能刷出加载时未知的类型）。

新增 tests/monster-art-diagnostics.test.ts（5 例）：逐层 no-member / decode
失败的计数与日志，以及 `missingMonsterArtIds` / `monsterArtStatusText`。

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 11:40:05 +00:00
troytt 952ad00429 fix(monsters): MonLvl 缺行时告警而非静默返回 UNSCALED 
缩放公式是 `原始表值 × scale ÷ 100`，回退到 `UNSCALED`（全 100）等于直接使用
`MonStats.txt` 的原始值：一只堕落者拿到 21-61 HP 而不是约 3 HP，约 20 倍。
原来这一步完全静默。

- `monsterScaleFor` 缺行时 `console.warn`（按 level 去重，避免每只怪刷一行），
  并新增 `setMonsterScalingStrict(true)` 让烘焙 / 校验脚本直接 throw。
- 新增 `monsterScaleLookup`，返回 `{ scale, missing }`，供调用方在不读 console
  的前提下自行判断。
- `PlannedLevel` 新增 `missingScalingLevels`，`planLevelMonsters` 把本关所有
  缺行的 level 汇总上报，烘焙方因此可以拒绝一个「怪物强度是假的」的关卡。

新增 4 个用例：告警一次、strict 抛错、lookup 不写 console、
`planLevelMonsters` 在 MonLvl 抽掉 level 1 行时报告 `[1]`。

TAG=agy
CONV=2a1934de-30ef-464e-b3f3-fcbcdbbc49f1
 2026-09-17 11:35:13 +00:00