| name | dragon-wars-cht-remake |
| description | 推進《火龍之戰》(Dragon Wars, 1989)繁中化 + C++20/SDL2 重寫(opendw_remake):用 opendw 反組譯當 oracle 做逐指令差異測試、DATA1/DATA2 資產萃取(5-bit 文字/Huffman/res31/sprite/場景圖去交錯)、Read Paragraph 防拷、CJK 24×24 渲染。觸發:「火龍之戰」「Dragon Wars」「opendw」「opendw_remake」「火龍之戰中文化」,或接續萃取/翻譯/重寫/驗證。 |
火龍之戰 (Dragon Wars) 中文化 + Remake Skill
何時啟用
使用者提到「火龍之戰 / Dragon Wars / opendw / opendw_remake / 火龍之戰中文化」,或要接續該專案的萃取、翻譯、重寫、驗證。
專案座標
- Repo:
github.com/wicanr2/opendw_dragon_wars_cht(本機 ~/tmp/longcat/opendw_dragon_wars_cht/)
- oracle 原始碼:
~/tmp/longcat/opendw/(Devin Smith C 反組譯,唯讀,當對照)
- 原始資料:
Dragon Wars (1990).zip → DOS 軟碟映像 → 取出 DATA1/DATA2/DRAGON.COM
7z e "Dragon Wars (1990).zip" → DISK01.IMA;7z e DISK01.IMA DATA1 DATA2 DRAGON.COM
- 軟體世界攻略:
longcat/softworld/ 第 25/26/27 期 PDF(repo 外)
兩條主線
- 資產 + 中文化資料(
opendw_dragon_wars_cht/docs/ + data/ + CONTEXT.md)= remake 的資產來源 + 翻譯。
- opendw_remake/:C++20 + SDL2 乾淨重寫的 runtime(VM + 渲染 + 資產層),執行原始 bytecode,以 opendw 為正確性 oracle,走向不依賴原始磁碟檔的自包含資產。設計見
opendw_remake/ARCHITECTURE.md。
⚠️ 必懂的技術 lore(踩過的雷)
- 遊戲文字不是靜態表:內嵌在 script bytecode,緊接
op_77/op_78/op_7B 之後、byte 對齊的 5-bit 壓縮串。逐 byte 暴力解全 section = 雜訊(docs/_deprecated/20_ALL_TEXT_FROM_DATA1.txt 的 3926 條就是這樣來的,已作廢)。乾淨文字 = docs/ALL_TEXT_FROM_SCRIPTS.txt(跟 bytecode 解出)。
- section 0x08–0x16 不是文字表(暴力萃取假象)。
- 5-bit 文字編碼:
alphabet[](92 項,compress.c)+ 5-bit 取位(carry=tmp>(tmp<<1))+ 0x1E 大小寫切換 + 0xAF/0xDC escape(變數代入)。extract_string 回傳值 = 下一條起始 offset。已移植 opendw_remake/src/resource/text_codec。
- 資源壓縮:section > 0x17 是 Huffman 樹字典(compress.c build_dictionary+decompress)。開頭 2 bytes LE = 解壓後大小。已移植
resource/decompress,對 res31/res168 byte-for-byte == opendw。
- DATA2 bug:89 個資源只在 DATA2(DATA1 header[N] ≥ 0xFF00)。原 resource.c 寫死只讀 data1 → 讀錯資料(怪物 sprite 半數錯誤)。修正:header≥0xFF00 改從 data2 載入(
tools_build/resource_data2.patch,已內建於 remake archive)。
- 怪物名在 res31(壓縮,2177B);record byte 對齊,name 在 record+0x21(5-bit)。
monsters.txt 的 168/196/200/210/222 是 sprite 圖編號,非名字。見 docs/26_MONSTERS_AND_SPRITES.md。
- 怪物 sprite 渲染:走
show_random_encounter/draw_random_encounter_graphic(160×136 viewport,nibble-per-pixel,DOS 16 色)。tools_build/sprite_dump.cpp。
- 全螢幕場景圖(res 24-29,解壓=32000B=320×200):是垂直 XOR delta 交錯,渲染前必須先做 title_adjust 還原(opendw main.c),否則紅/青條紋亂碼。
tools_build/scene_render.py、中文版 scene_localize.py。
- Read Paragraph 防拷:遊戲只顯示「Read paragraph N」(字串在 section 0x08@0x2d9,op_78 + op_81 數字)。段落文字在印刷手冊。手冊段落號 = 遊戲 N(已驗證:段落 137=Magan/Irkalla=玩家截圖)。段落 DB:
data/paragraphs/(147 段),工具 tools_build/build_paragraphs.py。功能規劃 docs/08_READ_PARAGRAPH_FEATURE.md。
- CJK 渲染:24×24 文泉驛(wqy-zenhei,GPL)點陣,進 320×200 framebuffer,每行約 13 中文字。驗證圖
docs/cjk_demo/,原型 tools_build/cjk_render_proto.py。
- VM quirk:用
word_3AE6 當旗標(bit0 carry/bit6 zero/bit7 sign)、byte_3AE1 模式、word_3AE2/3AE4 主次暫存器,且「ax 高位 vs 模式」決定字/位元組運算。remake VmState 刻意鏡像這些變數以利逐字移植 + 差異測試。
docker 工具鏈(必用 docker,勿污染系統)
- image:
dwtools(ubuntu:22.04 + g++)。
- opendw 原始碼編不過,需 shim(見
tools_build/):補 op_43/4C/4D/55/5B/5F/60/62/63 stub + op_56/59/5C/72 前向宣告 + sub_2AEE() stub;ui.c draw_right_pillar 重複定義改名 + 刪 line49 static 前向宣告。
- remake 工具:
opendw_remake/ cmake -S . -B build(C++20);headers 有 extern "C" → lib .c 用 gcc、tool .cpp 用 g++。
譯名(一律以 CONTEXT.md 為準)
波卡城/罪惡之城(Purgatory)、瑪根地底世界(Magan)、納達(Namtar)、奈羅(Nergal,Irkalla 之夫,≠Namtar)、伊爾卡拉(Irkalla)、胡姆巴巴(Humbaba)、初級/高級/德魯伊/太陽/雜項魔法、生命/法力/暈眩值、力量/敏捷/智力/精神、京雄城/拜占儂/菲巴斯/蘭斯克/塔斯廢墟/黃泥蟾蜍城、靈魂之泉、自由之劍、龍捲風。譯名來源優先序:官方臺灣手冊(珍066)> 約定俗成 > 直譯。
進度(2026-06-10,8 個 PR 已合併)
- R0 資產層:archive + text_codec + decompress(含 DATA2 修正)對拍 opendw byte-for-byte ✅
- R1 batch 1:VM 核心(VmState/dispatch/trace)+ 15/256 純 opcode,自測通過
- 翻譯草表 v0.1(
docs/15_TRANSLATION_DRAFT.md,258 條)、中文場景圖、手冊+段落+三期攻略視覺轉寫、docs 審查整併(錯誤結論作廢、譯名對齊)
下一步(建議順序)
- R1 差異測試 harness(關鍵):在 opendw 加 trace hook 輸出
(pc,op,r2,r4,flags,gamestate diff),remake 跑同 bytecode 逐行 diff。立起來後每加 opcode 自動驗。
- R1 補齊其餘 opcode(對拍)。
- R2 render:framebuffer + SDL2 pixel scaling(640×480)+ 8×8 字 + title 畫面 golden 測試。
- R3:字串輸出 opcode + i18n + CJK + 4 個文字類未實作 opcode(0x79/7E/7F/8F)。
- 法術名對照附表(從
33_MANUAL_TRANSCRIPTION 法術表)。
- R4 viewport/sprite/map;R5 戰鬥/法術/存讀檔;R6 Read Paragraph 內嵌 + 自包含 asset bundle。
工作慣例
- 每個改動開 feature branch → PR → 合併 main(使用者授權公開發佈;repo 為保存/中文化性質)。commit/PR 帶 Co-Authored-By 與 Claude Code 標記。
- 大量平行轉寫/分析用背景 agent(視覺轉寫掃描圖 > tesseract)。
- 不確定譯名/結論 → 列待確認給使用者裁決,不擅改。
關鍵檔案
opendw_remake/ARCHITECTURE.md(重寫設計 + 驗證策略 + 階段表)docs/07_REVISED_PLAN.md(萃取修正計畫)、docs/00_DOC_AUDIT.md(文件審查)docs/OPCODE_REFERENCE.md(中英雙語 256-opcode)、docs/25_OPCODE_INTERPRETATION.mddocs/26_MONSTERS_AND_SPRITES.md、docs/08_READ_PARAGRAPH_FEATURE.mddocs/15_TRANSLATION_DRAFT.md、CONTEXT.mddocs/33/34/35/36/37(手冊/段落/攻略轉寫)tools_build/(docker 工具 + patch + 渲染腳本)、data/paragraphs/
