ark-stronghold-protocol

1,073 Commits 1 Branch 0 Tags

3 Commits

Include renames

Author	SHA1	Message	Date
xcdoge	7b4f512ce9	敌方血条偏高：头顶高度按"原点以上的高度"算（bounds.y + bounds.height），而不是包围盒高度玩家反馈：逐腐兽的血条明显偏高。原因：单位血条/名字牌的头顶高度用的是 spine setup-pose 包围盒的高度（units.js headTilesForUnit 里 `bounds.height × 1/320 × 模型系数 × 0.92`）。这个公式默认包围盒是脚锚定的 —— 大多数敌人确实如此（猎狗pro y=−3.7、大鲍勃 y=−2.6，height 与"脚以上高度"几乎相等）。但有些模型的原点在身体中间：逐腐兽的包围盒是 y=−404.7 / height=722.6，锏是 y=−798 / height=1183 —— 对它们，包围盒高度比可见顶端多出大半个模型，于是血条被顶到上限 2.2 格（非 Boss）之上，看起来就是"明显偏高"。改法：定位改用原点以上的高度（`Number.isFinite(b.y) ? b.y + b.height : b.height`，仍按 20…900 夹取）。同时把这段计算从 UnitView 内联代码提成一个纯函数 `headTilesForUnit()`（放 units.js，紧挨 UNIT/EL_BAR 常量），入参只有 isEnemy / isBoss / spineShown / bounds / modelK / modelKY，便于直接测；UnitView 仍然保留 "没显示 spine 就不看模型"的短路语义。spine.js 的 `height` getter 语义不变（别处也用它，例如替身的纵向拉伸）。影响面（用真实 bounds 扫过 167 个有模型数据的敌人）：逐腐兽 / 疯狂的逐腐兽 1.85 → 0.81 格（降 1.03）锏（Boss） 2.59 → 1.11 格（降 1.48）萨卡兹大剑手 / 组长 1.54 → 1.23 格（降 0.31）枯朽之种 0.72 → 0.55、萨卡兹百夫长 1.51 → 1.34、妖怪MKII 0.71 → 0.55 其余 103 / 167 个敌人的变化 ≤ 0.02 格（脚锚定模型几乎无感）测试： test/render/bar-head.test.js（新增 5 条）：用真实的逐腐兽 / 猎狗pro / 大鲍勃 / 锏包围盒断言新公式、夹取上限、以及三个回退分支（无 bounds 用 chibi 余量 × 系数、Boss 无模型用 2.2、干员与召唤物用固定余量），并做源码断言把"y + height"这条规则钉住。 test/render/playtest6-enemies.test.js：两条 prefab 测试的期望值原本写死 `390 × …`（合成夹具的 bounds 是 y=−150 / height=390，即当年就把这个 bug 当成了正确行为），现在改为从被测 view 自己的 bounds 推导（240 而不是 390），夹具本身不动。 test/render 全量 552 项 / 546 通过 / 0 失败；test/ui + test/render 1279 项 / 1265 通过 / 0 失败。未触碰 server/sim，test/golden 无变动。	2026-10-11 22:49:56 +08:00
sganggs	66ae86b969	feedback5 WY: flying units hover 1.3 tiles (the client's 0.35 ÷ the standard prefab scale 0.27); the 帝国炮火先兆者 pair is drawn 1.263× taller and 木制瑞印 mirrored, as their official prefabs (from PR #211 by @xcdoge; the owner's decision of 2026-10-06) Ported by hand from PR #211 by @xcdoge: - render/units.js: FLY_HOVER 0.32 → 1.3, flat (the official fly offset is one model-independent Vector3(0, 0.35, 0) in the client's character space, whose unit is the standard battle-prefab scale 0.27; an official screenshot measures 1.2–1.4 tiles); enemyModelScaleY multiplies the skeleton's Y scale and the head (bar) height, also in the impostor path; a mirrorX model flips on top of the direction flip. The body, its HP bar, damage numbers, projectile hits and skill rings ride `hover`, the shadow stays on the ground; one camera drives the units over the 2D and the 3D board. - tools/build-data.mjs MODEL_STRETCH_Y / MIRRORED_PREFABS → enemies.json modelScaleY / mirrorX; data/enemies.json regenerated offline here (the PR's one-line blob was not taken) — JSON compare: only enemy_1112_emppnt / enemy_1112_emppnt_2 modelScaleY 1.263 and enemy_1196_msfyin mirrorX true. - tools/local-extract/enemy_model_offsets.py (optional, host-side prefab reader) and docs/research/12-flying-visuals-official.md (without the claim that the owner said 「都要」 on 2026-10-05 — the owner's decision of 2026-10-06 is cited; where the quirk enemies appear corrected against 0.2.0's data: 帝国炮火先兆者 is a FLY special enemy of the mode, 帝国炮火中枢先兆者 comes with the bounty 战术特训·飞行III, 木制瑞印 is in no wave). No screenshot or extracted art committed. Tests (from PR #211): test/render/unitview.test.js (FLY_HOVER ≈ 0.35 / 0.27; the same lift for every flyer; a flying view lifts by FLY_HOVER — added here: its body and HP bar ride the lift, its shadow stays on the ground), test/render/playtest6-enemies.test.js (the data keys; the 1.263 aspect and bar height; the mirrored model's x sign); both fail without the renderer change; the 425 render unit tests pass. Docs: DATA §9, ASSETS, design client.md, research 00 / 12, DESIGN §25.13.5 and the §25.10 table. Golden unchanged (drawing only; the sim reads neither field).	2026-10-06 21:41:49 +08:00
sganggs	6464e4b46a	Playtest #6 fixes: summons placed by hand, boss pool stall, bounties, 联防 leak counter, distinct offers, 机变 card text, phone buy tap, skill triggers, blocking, push force, 孤立, enemies, element bar - #1 #2 skill / device summons (赫默's drone, 巫恋's doll, 凯瑟琳's devices) are hand cards placed by the player; placed summons deploy once at battle start, then a skill summon re-appears at its tile on each cast (the user's call) - #3 叙拉古隐匿 ends on time (32 + 0.4 × layers s); 忍冬 S3 迷彩 lasts until her next cast (official), kept apart from 隐匿 - #4 multi-round bounty cards last two battles (the user's call; MULTI_ROUND_BOUNTY_BATTLES), blue / red card text - #5 the shared boss pool's float dust (≈3.6e-12 HP) stalled Final Assault leaders at 0 %; < 1 HP now clears the pool, and the team LP reaching 0 first is a defeat (PRTS) - #6 #10 机变 cards show their official effect text; an invisible 详情 button no longer swallows the confirming tap on phones - #7 live ×N counter of a leaker's enemies still on the 联防 field (LP loss stays capped at 10) - #8 #15 #16 skill triggers per 技能策略: skill-range triggers, injured-ally heals (古米, 塞雷娅), tank take-damage triggers with a 3 s cooldown; 新约能天使 S2 shields the highest-aggro operator in range - #9 official per-enemy model scales (威龙) - #11 element bar under the unit's HP bar (white = 元素值 left, element-coloured refill after a burst), floor rounding - #12 枯朽战车 kit per PRTS; every ranged enemy reaches its target's 0.25 collider - #13 恐惧 wander (萨科塔之翼 at half HP, operator fears make enemies flee) with re-planning after pushes - #14 push / pull distance by 力度 − 重量 (PRTS table); #17 every blocker attacks what it blocks; ASPD floor 20 - #18 炎佑 is 孤立: no heals or ally buffs - #19 every free pick-one chess offer (promotion reward, 信标, 寻呼模块) shows different operators - DESIGN §20 and the normative lines, SIM / META / DATA / PLAYING updated; 2747 unit tests and all 27 browser suites green; dev recordings regenerated	2026-10-01 19:08:23 +08:00

Author

SHA1

Message

Date

xcdoge

7b4f512ce9

敌方血条偏高：头顶高度按"原点以上的高度"算（bounds.y + bounds.height），而不是包围盒高度

玩家反馈：逐腐兽的血条明显偏高。

原因：单位血条/名字牌的头顶高度用的是 spine setup-pose 包围盒的**高度**（units.js headTilesForUnit 里
`bounds.height × 1/320 × 模型系数 × 0.92`）。这个公式默认包围盒是**脚锚定**的 —— 大多数敌人确实如此
（猎狗pro y=−3.7、大鲍勃 y=−2.6，height 与"脚以上高度"几乎相等）。但有些模型的**原点在身体中间**：
逐腐兽的包围盒是 y=−404.7 / height=722.6，锏是 y=−798 / height=1183 —— 对它们，包围盒高度比可见顶端多出
大半个模型，于是血条被顶到上限 2.2 格（非 Boss）之上，看起来就是"明显偏高"。

改法：定位改用**原点以上的高度**（`Number.isFinite(b.y) ? b.y + b.height : b.height`，仍按 20…900 夹取）。
同时把这段计算从 UnitView 内联代码提成一个纯函数 `headTilesForUnit()`（放 units.js，紧挨 UNIT/EL_BAR 常量），
入参只有 isEnemy / isBoss / spineShown / bounds / modelK / modelKY，便于直接测；UnitView 仍然保留
"没显示 spine 就不看模型"的短路语义。spine.js 的 `height` getter 语义不变（别处也用它，例如替身的纵向拉伸）。

影响面（用真实 bounds 扫过 167 个有模型数据的敌人）：
  逐腐兽 / 疯狂的逐腐兽   1.85 → 0.81 格（降 1.03）
  锏（Boss）             2.59 → 1.11 格（降 1.48）
  萨卡兹大剑手 / 组长     1.54 → 1.23 格（降 0.31）
  枯朽之种 0.72 → 0.55、萨卡兹百夫长 1.51 → 1.34、妖怪MKII 0.71 → 0.55
  其余 103 / 167 个敌人的变化 ≤ 0.02 格（脚锚定模型几乎无感）

测试：
  test/render/bar-head.test.js（新增 5 条）：用真实的逐腐兽 / 猎狗pro / 大鲍勃 / 锏 包围盒断言新公式、
  夹取上限、以及三个回退分支（无 bounds 用 chibi 余量 × 系数、Boss 无模型用 2.2、干员与召唤物用固定余量），
  并做源码断言把"y + height"这条规则钉住。
  test/render/playtest6-enemies.test.js：两条 prefab 测试的期望值原本写死 `390 × …`（合成夹具的 bounds 是
  y=−150 / height=390，即当年就把这个 bug 当成了正确行为），现在改为从**被测 view 自己的 bounds** 推导
  （240 而不是 390），夹具本身不动。
  test/render 全量 552 项 / 546 通过 / 0 失败；test/ui + test/render 1279 项 / 1265 通过 / 0 失败。

未触碰 server/sim，test/golden 无变动。

2026-10-11 22:49:56 +08:00

sganggs

66ae86b969

feedback5 WY: flying units hover 1.3 tiles (the client's 0.35 ÷ the standard prefab scale 0.27); the 帝国炮火先兆者 pair is drawn 1.263× taller and 木制瑞印 mirrored, as their official prefabs (from PR #211 by @xcdoge; the owner's decision of 2026-10-06)

Ported by hand from PR #211 by @xcdoge:
- render/units.js: FLY_HOVER 0.32 → 1.3, flat (the official fly offset is one model-independent Vector3(0, 0.35, 0) in
  the client's character space, whose unit is the standard battle-prefab scale 0.27; an official screenshot measures
  1.2–1.4 tiles); enemyModelScaleY multiplies the skeleton's Y scale and the head (bar) height, also in the impostor
  path; a mirrorX model flips on top of the direction flip. The body, its HP bar, damage numbers, projectile hits and
  skill rings ride `hover`, the shadow stays on the ground; one camera drives the units over the 2D and the 3D board.
- tools/build-data.mjs MODEL_STRETCH_Y / MIRRORED_PREFABS → enemies.json modelScaleY / mirrorX; data/enemies.json
  regenerated offline here (the PR's one-line blob was not taken) — JSON compare: only enemy_1112_emppnt /
  enemy_1112_emppnt_2 modelScaleY 1.263 and enemy_1196_msfyin mirrorX true.
- tools/local-extract/enemy_model_offsets.py (optional, host-side prefab reader) and
  docs/research/12-flying-visuals-official.md (without the claim that the owner said 「都要」 on 2026-10-05 — the owner's
  decision of 2026-10-06 is cited; where the quirk enemies appear corrected against 0.2.0's data: 帝国炮火先兆者 is a FLY
  special enemy of the mode, 帝国炮火中枢先兆者 comes with the bounty 战术特训·飞行III, 木制瑞印 is in no wave). No
  screenshot or extracted art committed.

Tests (from PR #211): test/render/unitview.test.js (FLY_HOVER ≈ 0.35 / 0.27; the same lift for every flyer; a flying
view lifts by FLY_HOVER — added here: its body and HP bar ride the lift, its shadow stays on the ground),
test/render/playtest6-enemies.test.js (the data keys; the 1.263 aspect and bar height; the mirrored model's x sign);
both fail without the renderer change; the 425 render unit tests pass. Docs: DATA §9, ASSETS, design client.md,
research 00 / 12, DESIGN §25.13.5 and the §25.10 table.
Golden unchanged (drawing only; the sim reads neither field).

2026-10-06 21:41:49 +08:00

sganggs

6464e4b46a

Playtest #6 fixes: summons placed by hand, boss pool stall, bounties, 联防 leak counter, distinct offers, 机变 card text, phone buy tap, skill triggers, blocking, push force, 孤立, enemies, element bar

- #1 #2 skill / device summons (赫默's drone, 巫恋's doll, 凯瑟琳's devices) are hand cards placed by the player;
  placed summons deploy once at battle start, then a skill summon re-appears at its tile on each cast (the user's call)
- #3 叙拉古 隐匿 ends on time (32 + 0.4 × layers s); 忍冬 S3 迷彩 lasts until her next cast (official), kept apart from 隐匿
- #4 multi-round bounty cards last two battles (the user's call; MULTI_ROUND_BOUNTY_BATTLES), blue / red card text
- #5 the shared boss pool's float dust (≈3.6e-12 HP) stalled Final Assault leaders at 0 %; < 1 HP now clears the pool,
  and the team LP reaching 0 first is a defeat (PRTS)
- #6 #10 机变 cards show their official effect text; an invisible 详情 button no longer swallows the confirming tap on phones
- #7 live ×N counter of a leaker's enemies still on the 联防 field (LP loss stays capped at 10)
- #8 #15 #16 skill triggers per 技能策略: skill-range triggers, injured-ally heals (古米, 塞雷娅), tank take-damage
  triggers with a 3 s cooldown; 新约能天使 S2 shields the highest-aggro operator in range
- #9 official per-enemy model scales (威龙)
- #11 element bar under the unit's HP bar (white = 元素值 left, element-coloured refill after a burst), floor rounding
- #12 枯朽战车 kit per PRTS; every ranged enemy reaches its target's 0.25 collider
- #13 恐惧 wander (萨科塔之翼 at half HP, operator fears make enemies flee) with re-planning after pushes
- #14 push / pull distance by 力度 − 重量 (PRTS table); #17 every blocker attacks what it blocks; ASPD floor 20
- #18 炎佑 is 孤立: no heals or ally buffs
- #19 every free pick-one chess offer (promotion reward, 信标, 寻呼模块) shows different operators
- DESIGN §20 and the normative lines, SIM / META / DATA / PLAYING updated; 2747 unit tests and all 27 browser suites
  green; dev recordings regenerated

2026-10-01 19:08:23 +08:00