D-20260518-01|武器欄位簡化=main_mesh_node 單一欄+動態磁力¶
背景與驅動力¶
分支樹(D-20260517-01)落地隔日即見欄位冗餘:master/slave 拆欄(slaveMesh/scope)讓單一操作 mesh 也要兩欄宣告;武器磁力掛靜態 magnet_strength_n 與能量系統脫鉤;launch 另需 LaunchPoint empty 與 on_impact 行為欄;場地磁場又有顯式 n_pole_direction。
考慮過的選項¶
(流水帳未記錄替代方案;本決策以簡化 / 收斂形式成立——五個欄位各自併入既有機制。)
決定¶
- 主從合一:
slaveMesh/scope廢除,改main_mesh_node單一欄位。 - 武器磁力強度改動態:
applied_energy × K_MAGNET_FORCE,廢除靜態magnet_strength_n。 - Launch 簡化:廢
LaunchPointempty,子彈 =main_mesh_node子節點 mesh。 on_impact廢除:落地行為由 bullet 材質決定,毋需欄位宣告。n_pole_direction廢除:場地磁場 N 極 =mesh-local +Z 軸自動推導。現況見 建模參數.md。
附帶決策¶
launch 彈藥模型原全 corpus 未定(打完之後?射速?)。2026-06-12 第四輪複審補定案:彈藥有限、Hold 期間每 LAUNCH_FIRE_INTERVAL_MS(250 ms、初估)依子節點順序發 1 顆、打完即空、reset_for_new_match 回滿(已射出的 bullet 清除)。
後果與影響¶
「結構與命名承載語義、行為交給材質與能量系統」自此成為武器欄位的收斂方向;動態磁力也讓武器強度與 applied_energy 預算掛鉤、免平衡兩套數值。同輪釐清的「上傳 → 編輯 → 上鏈 → 組裝」工作流四階段,其後由 D-20260531-01 改為三階段創作流程。