| name | panzer-general-cht |
| description | 接續或擴充 SSI Panzer General / Allied General Win95 系列繁體中文化工作的領域知識。當使用者提到 Panzer General、PG-cht.exe、Allied General、AG.EXE、裝甲元帥、盟軍將軍、PG/AG 中文化、修改 BDB 簡報/PANZEQUP 裝備/MAPNAMES 地形或城市名/TACMAP 標籤/SCENARIO.TDB 戰役樹/.SCN 戰役檔,或要新增/還原/修正任何資產翻譯時觸發。也適用於同類 PE 二進位 hex patching 任務 — 特別是當字串同時作為 UI 顯示與 strcmp lookup key 必須拆分顯示路徑與比對路徑的情況(指標重導向 + .text caller bisection 技術)。 |
Panzer General / Allied General 中文化專案知識
接續 2026 年 5 月完成的 SSI 戰略遊戲系列繁中化工作。先讀完此 SKILL.md 確認專案現況,再決定下一步;細節文件在 references/。
支援的遊戲
| 遊戲 | 目錄 | 主執行檔 |
|---|
| Panzer General Win95 | D:\03_game_tmp\PGWin95_reduced_v1.2\PG_v1.2\ | PG-cht.exe (1,984,512 bytes) |
| Allied General Lite v1.1 | D:\03_game_tmp\AlliedGeneralLite_v1.1\AlliedGeneral_v1.1\ | AG.EXE (2,167,611 bytes) |
兩款遊戲同引擎,DATA 結構大半相同(MAPNAMES.STR、TACMAP.TGF 兩遊戲位元組完全相同 — 可直接共用譯文);PANZEQUP.EQP 內容不同;AG.EXE 沒有 DATA2\BDB*.BRF(AG 無獨立簡報檔,戰役描述存於 EXE 內 0x1BD0E8 起 + 長 briefing 在 .rsrc UTF-16LE)。
AG.EXE 版本指紋(本 skill 所對應的具體 EXE 識別)
本 skill 的所有 hex offsets 都針對下述 EXE。換版本(同 SSI 出 NWC 出其他 v1.0 patch / Lite v1.2 / GOG re-release 等)時要重做 caller bisection。
| 識別欄位 | 值 |
|---|
| 檔案大小 | 2,167,611 bytes |
| MD5 (AG.EXE.bak) | 45C7E04FBDF71113FD8E8B2B746980B9(原 SSI 英文 — 對照基準) |
| PE COFF timestamp | 0x3134E395 = 1996-02-29 07:21:57 UTC |
| Linker version | Microsoft Visual C++ 2.55(VC++ 4.0 SP2 era) |
| VS_VERSION_INFO resource | 無(SSI 沒寫 PE 標準 version 資源,.NET Get-Item .VersionInfo 全空) |
| README.TXT 第一行 | Allied General V1.0 Read Me File 12/3/95 (c) 1995, Strategic Simulations, Inc. A Mindscape Company |
| Lite 重新打包標記 | 目錄名 AlliedGeneralLite_v1.1(community / fan re-pack,EXE 本體與 SSI 原版相同) |
| .text section | file 0x400-0x19C800 (RVA 0x1000) |
| .rdata | file 0x19C800-0x1B9200 |
| .data | file 0x1B9200-0x1D1400 (VA = fo + 0x42EE00) |
| .idata | file 0x1D1400-0x1D2800 |
| .rsrc | file 0x1D2800-0x1F9C00 (160 KB,含 39 段長 briefing UTF-16LE) |
| .reloc | file 0x1F9C00-0x210200 |
驗證對應同 EXE:Get-FileHash -Algorithm MD5 AG.EXE 比對。若 hash 不同但 size 與 PE timestamp 都一致 → 多半就是同版有後續 patch,部分 offset 可能仍對得上;若 size 不同 → 視為不同版本,本 skill offsets 不適用。
專案概況
| 項目 | 路徑 |
|---|
| 遊戲根目錄 | D:\03_game_tmp\PGWin95_reduced_v1.2\PG_v1.2\ |
| 主要可執行檔(中文版) | PG-cht.exe (1,984,512 bytes) |
| 原始英文版 | PG.exe (2,167,298 bytes,大小不同) |
| 原始翻譯者 | Chun-Yu Wang (wicanr2@gmail.com) — 即本 skill 使用者本人 |
重要備份位置(改動前務必確認備份存在):
PG:
PG-cht.exe.bak(根目錄,也在 backup\ 鏡像一份)DATA2\backup_orig\BDB*.BRF(所有 177 個簡報原始檔)DATA\MAPNAMES.STR.bak / TACMAP.TGF.bak / PANZEQUP.EQP.bak
AG (同目錄結構):
AG.EXE.bakDATA\MAPNAMES.STR.bak / TACMAP.TGF.bak / PANZEQUP.EQP.bak / SCENARIO.TDB.bak / MAPCONV.STG.bak / SCENSTAT.BIN.bak
已完成翻譯總覽 — PG
| 資源 | 數量 | 位置/方式 |
|---|
| UI 字串 | 230 條 | PG-cht.exe 內原地翻譯(slot 內) |
| 戰役名稱(顯示) | 38 個 | 指標重導向(見下方技術說明) |
| 地形類型 | 14 條 | MAPNAMES.STR entries 0-13 |
| 城市/地名 | 314 個 | MAPNAMES.STR entries 14+(著名地名) |
| 戰術地圖標籤 | 9 條 | TACMAP.TGF |
| 任務簡報 | 413 段 / 177 檔 | DATA2\BDB*.BRF |
| 裝備名稱 | 163 條 | PANZEQUP.EQP(保留型號代碼如 BF109e/T-34) |
| 戰略地圖提示 | 2 段 | PG-cht.exe 內 |
已完成翻譯總覽 — AG (2026-05-16 完成)
AG Lite v1.1 已含部分中文化(PANZEQUP 95% 中文),本次補完 UI 與資料檔:
| 資源 | 數量 | 位置/方式 |
|---|
| UI 字串 | 499 條 | AG.EXE 內原地翻譯(179 PG 譯文 + 310 AG 專屬 phase 2 + 6 phase 3 + 4 extra) |
| 主選單按鈕 | 6 條 | Open/Scenarios/E-Mail/Start/Campaigns/Scenarios → 開啟/戰術/郵件/開始/戰役列表/戰術列表 |
| 地形類型/城市名 | 14+314 條 | MAPNAMES.STR(直接複製 PG 翻譯版,兩遊戲位元組完全相同) |
| 戰術地圖標籤 | 9 條 | TACMAP.TGF(直接複製 PG 版) |
| 裝備名稱 | 100% | PANZEQUP.EQP(Lite v1.1 原 425 條 + 補 RESERVED/FPO Bren Ca + 11 條 BF109/110/ME/HE/DO 系列) |
| 戰役描述 | 33 段 | AG.EXE 內(0x1BD10C 起,220-byte slots) |
| 字體 | 26 處 Arial→Tahoma | 與 PG 一致(避免 Big5 字體偏小問題) |
| 任務簡報 | N/A | AG 無獨立簡報檔(資料已內嵌於 EXE) |
AG 累計變動:AG.EXE 13,321 bytes、PANZEQUP.EQP 105 bytes、MAPNAMES.STR 2,639 bytes。
AG 戰役選單 39 條地名(2026-05-29 完成):用 PG 式 caller-level 拆分。新 ptr table B' @ 0x1BFE4C、新 Chinese getter @ 0xC5C0 (VA 0x40D1C0),只 3 個 display callers (0x57C39/0x5A27E/0x5A43C) redirect 走 Chinese getter,其餘 7 個 callers 與 Function 2 本身維持英文 — menu 中文 + 全戰役可進入(實測 Germany 通過)。完整 patch 細節與失敗嘗試教訓見 references/ag-scenario-menu.md 章節「2026-05-29 完成記錄」。
PG-cht.exe 本次修正 (2026-05-16)
- 修正原譯者 Chun-Yu Wang 的 Tohama → Tahoma 拼字錯誤(7 處 Arial 改 Tahoma 中,6 處誤拼為 Tohama,1 處正確)— 6 處 typo 已修正
關鍵技術:指標重導向(Pointer Redirection)
問題:某些字串同時用於 UI 顯示 和 .text 程式碼內的 strcmp lookup key。直接翻成 Big5 會讓 strcmp 失敗,導致進入戰役時拋 hException(未知錯誤 exTrue)。
典型受害字串:戰役名稱陣列 0x1BAC48-0x1BAEEC(38 條:1943 East、Berlin (East)、North Africa、Barbarossa、Sealion Plus 等)— 從 .text 有 109 個指標引用。
解法步驟(以戰役名稱為例):
- 保留原英文字串不動於
0x1BAC48-0x1BAEEC(供 .text 內嵌 MOV EAX, offset_string 比對使用)
- 在 .data 安全區寫 Big5 副本 — 已用
0x1C8C69-0x1C8D88(363 bytes 0 靜態引用區)
- 複製英文指標表副本 — 已置於
0x1BA7B8(152 bytes,Table B 38 個 entry 的英文指標複本)
- 修改原指標表 Table B
0x1BAA28 → 指向 Big5 副本
- 在 .text padding 寫新 getter 函式 — 已置於
0x32F4(27 bytes,讀 0x1BA7B8 英文副本)
- bisection 找到「顯示用 caller」(只 1 個)讓它走原 Chinese getter,其他 9 個 lookup callers 改 call 新英文 getter
目前 10 個 caller 的最終配置(見 references/exe-patches.md):
0xF0D27 → 原 Chinese getter(顯示路徑)0x108AC 等 9 個 → 新英文 getter(lookup 路徑)
三個我必須記住的「禁區」
- PG
0x1BAC48-0x1BAEEC、AG SCENARIO.TDB 內的戰役/地點名(Sidi Barrani / El Alamein / Anzio / Berlin 等):絕不原地翻譯。同時用於 strcmp lookup,改動會破壞 .text 引用與 SCN/STM 檔名對應。
- SCENARIO.TDB / ARROW.TDB / FLAG.TDB / PNTINFO.TDB:絕不翻譯。內含戰役名作為 ASCII key,改動會破壞資產 lookup。
- PE .text section
0x400-0x19A1FF:預設不動。只有指標重導向解法中經授權的 operand patch 與 padding 區內的新函式才可改。
- SCN 內
..\dat\*.stm、..\dat\mapconv.stg 等路徑字串:絕不翻譯,是檔案路徑。
- AG.EXE 內
MpEncode.mdt / SmEncode.mdt / Panic.sav / TargCur.cur:檔名,絕不翻譯。
何時讀什麼
| 場景 | 讀這個 |
|---|
| 需要 PE 結構、VA/file offset 轉換、安全 padding 區清單、現有 patches 完整列表 | references/exe-patches.md |
| 修改 BDB/PANZEQUP/MAPNAMES/TACMAP/SCENARIO.TDB 等資料檔 | references/file-formats.md |
| 找符合風格的翻譯詞彙(國名/兵種/動作) | references/translation-conventions.md |
| AG 戰役選單中文化(指標重導向待做) | references/ag-scenario-menu.md |
| AG 回合/簡報畫面字串、任務簡報 RT_STRING 踩雷、PANZEQUP 格式、★戰鬥介面陣營配色 bug★ | references/ag-ui-runtime.md |
| ART.DAT 點陣圖中文化(UI 烤在圖上的英文:NATION/PURCHASE/PREFERENCES…;封存格式+RLE 編解碼+重繪流程) | 獨立 skill art-dat-bitmap-cht(SKILL.md + tools/art-dat/) |
| 套用 patch 的 PowerShell 樣板程式 | scripts/、tools/art-dat/ |
操作流程
新增翻譯前
- 確認改的字串不在禁區清單(見上)
- 用 Grep 搜尋 PG-cht.exe.bak 看該字串在 .text 是否有 hardcoded 引用:
# 搜尋 VA 0x5EXXXX 在 .text 是否被引用
- 若有 .text hardcoded 引用 → 必須用指標重導向手法(見上)
- 若無 → 可原地翻譯(index-based 存取,安全)
套用翻譯後
- 檢查檔案大小與原備份一致
- Big5 解碼讀回確認字串完整
- 請使用者實際進遊戲驗證
還原步驟
# 還原 exe
Copy-Item "D:\03_game_tmp\PGWin95_reduced_v1.2\PG_v1.2\PG-cht.exe.bak" "D:\03_game_tmp\PGWin95_reduced_v1.2\PG_v1.2\PG-cht.exe" -Force
# 還原所有 BDB
Get-ChildItem "D:\03_game_tmp\PGWin95_reduced_v1.2\PG_v1.2\DATA2\backup_orig\BDB*.BRF" | ForEach-Object {
Copy-Item $_.FullName "D:\03_game_tmp\PGWin95_reduced_v1.2\PG_v1.2\DATA2\$($_.Name)" -Force
}
# 還原 MAPNAMES / TACMAP / PANZEQUP
$d = "D:\03_game_tmp\PGWin95_reduced_v1.2\PG_v1.2\DATA"
Copy-Item "$d\MAPNAMES.STR.bak" "$d\MAPNAMES.STR" -Force
Copy-Item "$d\TACMAP.TGF.bak" "$d\TACMAP.TGF" -Force
Copy-Item "$d\PANZEQUP.EQP.bak" "$d\PANZEQUP.EQP" -Force
常見潛在 expansion 方向
- 更多城市翻譯:MAPNAMES.STR 還有 ~1240 個未翻譯地名(冷門小鎮)。entries 14+ 都是 index-based 安全翻譯。
- 戰役起始點翻譯:
0x1C6038 的 5-entry 表(1939/1941 East/West/1943 East/West)用相同指標重導向手法
- 戰術 UI 標籤:檢查 ART.DAT 內可能的字串資源
- 裝備細節:目前保留型號代碼,如需強化,可改翻譯如 "Tiger I" → "虎式 I" 的形式(已有 163 條範本)
編碼注意事項
- 所有中文字串以 Big5 (codepage 950) 編碼,而非 UTF-8。
[System.Text.Encoding]::GetEncoding(950) 是正確的編碼器。
- 翻譯字串的 byte 長度必須 ≤ slot 容量 − 1(留 NUL 終止子)
- 一個 Big5 字 = 2 bytes;ASCII 字 = 1 byte
- Big5 leading byte 範圍 0xA1-0xFE;trailing byte 0x40-0x7E 或 0xA1-0xFE
- 不會碰巧產生
% (0x25) 字元,所以 printf format string 安全
預期觸發場景
當使用者:
- 提到 Panzer General、PG、Allied General、AG、裝甲元帥、盟軍將軍、PG-cht.exe、AG.EXE
- 要修改 BDB 簡報、戰役名、裝備、城市、地形名稱
- 看到遊戲內顯示英文要求中文化
- 進戰役出現
未知錯誤 exTrue 或類似 exception
- 想做類似 PE 二進位 hex patching 而需要拆分「顯示」與「lookup」路徑時(本 skill 的指標重導向手法可廣泛適用)
AG 專案速查 (2026-05-16)
AG.EXE PE 結構(與 PG 相同 ImageBase 0x400000,但 section 位移不同):
.text file 0x400-0x19C800 (RVA 0x1000).rdata file 0x19C800-0x1B9200 (RVA 0x1CB000).data file 0x1B9200-0x1D1400 (RVA 0x1E8000).data VA = file_offset + 0x42EE00
AG 翻譯 workspace 暫存檔(可重用為下次 AG 工作的起點):
workspace_ag_ui_strings.txt — 全部 544 條 AG.EXE UI 字串清單workspace_pg_dict.txt — PG 英文→Big5 字典(206 條)workspace_ag_patches.txt — phase 1 (179 條,從 PG 直接套用)workspace_ag_patches2.txt — phase 2 (454 條 AG 專屬翻譯)workspace_ag_patches3.txt — phase 3 (6 條清理)workspace_ag_extras.txt — 主選單按鈕 + extra UI(10 條)workspace_ag_panzequp_residual.txt — PANZEQUP 13 條補譯workspace_ag_scenarios.txt — 81 條戰役名(目前已 revert,留作下次重做指標重導向時參考)
AG 戰役選單問題(2026-05-16 進行中)
現況:戰役選單顯示英文。直接翻譯會 exception。已驗證 bisection 結果:
| 表 | 位置 | 用途 | .text getter | 索引範圍 |
|---|
| Table A | 0x1C2800-0x1C29E8 (39 entries) | 未用 更正:戰鬥介面陣營配色 classify(見 references/ag-ui-runtime.md §1) | 0x956BB(classify,讀前 8=北非 bucket0,另 14 @0x1c2908=西線 bucket1) | 0-7 / 0-13 |
| Table B | 0x1C2A2C-0x1C2BB4 (39 entries) | menu 顯示 AND lookup 來源 | 0x941E5 ref @ 0x94211 | 0-38(全部) |
| Table C | 0x1C2C54-0x1C2C77 (3 entries) | 戰役起點(N.Africa/W.Europe/E.Front) | unknown ref @ 0x94812 | 0-2 |
Bisection 證據:
- A=cht, B=eng, C=eng, TDB=eng → 顯示英文,無 exception → menu 不讀 A
- A=cht, B=cht → exception,顯示中文 → menu 讀 B
- A=eng, B=cht, TDB=eng → exception
- A=cht, B=cht, TDB=cht(全 Chinese)→ exception(TDB 中文化無法救)
結論:Table B 同時用於 menu 顯示 + 進入戰役時 strcmp lookup。需 PG 式指標重導向手法。
SCENARIO.TDB 格式(141 bytes/record × 39 records,header 18 bytes):
- 0x12:
. separator
- 0x13-0x2B: NAME (25 bytes, ASCII 空格填充)
- 0x2C:
. 0x2D-0x34: SCNFILE (8 bytes, e.g. "anziow ")
- 0x35:
. 0x36-0x4E: DWIN branch (25 bytes)
- 0x4F:
. 0x50-0x68: MWIN branch (25 bytes)
- 0x69:
. 0x6A-0x82: LOSS branch (25 bytes)
- 0x83-0x9C: 5×4-byte numbers (turns/delays)
- 0x9D-0x9E: CRLF
- Sentinel branches:DWIN/MWIN/LOSS/???? 絕不翻譯
下次接續工作:
- 還原狀態:Tables A+B+C、SCENARIO.TDB 已 revert 回英文
- 要 Chinese 顯示,需:
- 找出
0x941E5 getter 透過 thunk(0x964/0x21D0 區域 E9 跳板)的所有 caller
- 每個 caller 是 display 還是 lookup,bisection 個別測試
- 顯示用 caller → 改 call 新 Chinese getter(讀 Table A 或新 Big5 區)
- lookup 用 caller → 維持 call 原 getter(讀 Table B 英文)
- 詳見
references/ag-scenario-menu.md
AG 字體設定發現
- 原 AG.EXE 用
Arial (26 處,slot 8 bytes)
- 原 PG.exe 也用 Arial,Chun-Yu Wang 譯時改為 Tahoma(7 處,其中 6 處誤拼為 Tohama)
- Big5 中文在 Tahoma 顯示為新細明體(系統替代),比直接用 細明體 更大更清楚
- AG 曾跟隨 PG 改法:
Arial → Tahoma 26 處(slot 8 fit:6+NUL=7 bytes ✓)
- (2026-05-30 已還原) 使用者反映 Tahoma 版字形與原始 Lite 觀感不同 → 還原回
Arial(b"Tahoma"→b"Arial\0" 同 6 bytes,26 處,備份 .preArial)。結論:Windows 原生跑時保留原始 Arial 即可(Tahoma 改法是 wine 端為 Big5 fallback 用的,Windows 端非必要)。要切換就改這 26 處 face name。
SCN 檔內 scenario 名
每個 GAME###.SCN 內含小寫 scenario name(例如 'sidi barrani' at 0x1EB,對應 SCENARIO.TDB 的 SCNFILE 短名)。這是 scenario internal key,可能參與 lookup。本次未動。
AG 執行期 UI 補完 (2026-05-30) — 詳見 references/ag-ui-runtime.md
本回合補完「進遊戲才看得到」的幾塊 UI,全部已 commit + 有備份(.preturn/.prebrief/.prebrief2/.preshort/.pretheme):
-
回合/開戰畫面值字串(Big5 原地):天氣 晴朗/陰天/下雨/下雪、地面 乾/泥濘/結冰、陣營 盟軍/軸心(0x1c3a5c-0x1c3aec)、月份一~十二月(0x1c781c stride 0x14)。★踩雷:0x1c3a34-0x1c3ad0 的小寫字串是地形貼圖檔名,絕不翻。
-
任務簡報 RT_STRING(type 6,UTF-16,wLen 前綴,76 bundle):★兩個致命踩雷★ — (A) 用尾端空格補滿 wLen → 自動換行大空洞;(B) 把空行用的 ' ' 剪成空字串(wLen=0)→ 組字器回顯上一句造成重複。正解:尾端空格數對齊英文原版 .bak(句子=0、空行=1)。就地重打包不動 PE 資源目錄(只縮、補零、Size 不變)。孤立 CR 是原版格式不要清。
-
PANZEQUP.EQP 格式 + 裝備名縮短:記錄 50B、名稱欄 20B(含國名前綴)。國名縮 1 字(美國→美…)+ 刪重複英文機名尾碼(P51B Mustg→P51B),保留羅馬數字/型號代碼。
-
兵種類別名:水平轟炸機→戰略轟炸機(0x1c319c,同長)。
-
★陣營主題(theme)bug — 2026-05-31 徹底改寫,前結論全錯,詳見 references/ag-ui-runtime.md §1★:戰鬥介面 + 購買畫面共用 theme 全域 [0x5f1b34]。實機定案 theme0=盟/theme1=德/theme2=俄(前筆記寫 ru/ge/al 反了)。兩個本地化引入的 bug:(a) 更早的「配色 fix」把 switch 0x9599d/0x959ac 對調改反了方向(正解 = 原始值 0x9599d+6=00、0x959ac+6=02);(b) 真根因 = classify 的 strcmp 戰役名表(22 名 @0x5F1600)被翻成中文,但場景 lookup 名仍英文 → 永不命中 → classify 死、全部落 bucket2(這也讓 (a) 的錯誤休眠沒被發現)。正解 = classify 表重指英文副本(顯示表 B' 維持中文)+ switch 改回原始。備份 .preclassify/.pretheme2。教訓:strcmp/lookup 字串表絕不可翻;改 theme 前先確認 classify 真的有在比中。
-
破解者簽名移除(email raywolf@chuvashia.ru reversed+XOR0xFF、kilroy was here. 明文)→ 改中文。詳見 references/ag-ui-runtime.md §6。★★事件:一進戰場閃退★★ — email blob(file 0x3d15f–0x3d17a)尾端 2 byte 與 call 0x43dda3+ret 重疊;我一度整段 28B 覆寫(NEW ff×16…)毀了 call/ret → 選單可開、一進關卡崩潰。正解只改字串 13B、保留 code byte(見 §6)。
-
256 色問題 → 自製 shim.dll(無編譯器,Python 手工組 PE):AG.EXE 同 PG 檢查 GetDeviceCaps(BITSPIXEL)==8,否則跳「需 256 色」對話框。shim 轉發 29 個 GDI32 函式給真 gdi32、只攔 GetDeviceCaps 的 BITSPIXEL→回 8;把 AG.EXE import name GDI32.dll(file 0x1d2402)→shim.dll(備份 .pregdi),shim.dll 放遊戲同目錄。32-bit DLL 無法在 64-bit Python 載入測試(err 193)→ 用 SysWOW64\WindowsPowerShell 32-bit 測。手法等同 pg-cht wine 的 pgs.dll(見 panzer-general-wine),差別:本次目標是 Windows 原生且手工組 PE。
-
★破解者隱藏簽名★:Lite 重打包者把 email raywolf@chuvashia.ru 用 反向+XOR 0xFF 編碼藏起來(故 grep/單向 XOR 全找不到),執行時解到狀態列地名欄顯示。解碼器 @VA 0x43dd7c、blob @file 0x3d15f-0x3d17a、buffer 0x5ebcf4。重編 blob → 顯示「原來是個胖仔」(備份 .premail)。另把明文 kilroy was here.(file 0x1bceac/0x1bcec0)改「盟軍元帥中文版」(備份 .prekilroy)。教訓:cracker 簽名常 reversed/XOR 藏匿,明文找不到要測「反向+XOR」或反組譯顯示處。詳見 references/ag-ui-runtime.md §6。
-
開頭畫面加中文標題:ART\SPLASH.DAT 的 ALLIED GENERAL 標誌下加「盟軍元帥」(鋼鐵漸層 + 描邊,對齊 GENERAL 寬度)。技法見 art-dat-bitmap-cht §12。
小字粗體按鈕(取消/確定 等)的點陣去字技巧 見獨立 skill art-dat-bitmap-cht(密度法保留內框 + 微軟正黑體粗體)。
