山寨帳房
《塔防山賊模擬器》的繁體中文存檔修改器。用瀏覽器讀取 .dat、修改並匯出副本，存檔全程在本機處理，不會上傳。
開啟修改器 · 操作教學 · 常見問題 · Wiki 首頁
快速開始
- 開啟修改器，選取要修改的遊戲進度檔，例如
ea3save.dat。
- 修改資源、角色或裝備；需要預覽的操作先確認結果，再套用，最後從「檢視變更」核對。
- 下載原檔備份，再匯出修改副本，例如
ea3save.modified.dat。
- 結束遊戲，另行備份原始存檔，將修改副本改回原檔名，放回取出時的相同位置。
- 重新開啟遊戲，載入對應存檔確認。
本機存檔、自動備份與雲存檔快取可能位於不同位置，請確認取出與放回的是同一份進度。Mac 路徑見啟動器說明。
功能
| 類別 | 可以做什麼 |
|---|
| 資源與名稱 | 修改銅錢、共用經驗、魂魄、科技點、操練點、材料數量及山寨／角色名稱 |
| 角色養成 | 增加角色、已習得職業與九項技藝經驗，依遊戲公式聯動結算；調整符合資格的一般隨機角色（含已結丹）基礎資質、技藝上限與天賦等級；丹藥資質累積增量（一位小數、結丹角色、超限模式）；結丹角色的結丹品質與入體內丹等級 |
| 物品與裝備 | 調整既有普通裝備等級（背包與裝備庫可超限到 1000）、品質與詞條係數（已選洗練槽可超限到 1000），精準洗練合法詞條，替神話裝備加第六槽詞條；升降既有套裝的品質與等級、寶物等級、內丹等級；武庫物品比照背包編輯；調整背包與置物台上的靈物五行 |
| 山寨與科技 | 設定職業操練上限與進階科技 31–44（招募技術進階模式最高 599）；解鎖基礎科技、升高建築等級；調整城牆強化等級、城市層數與聲望 |
| 批次操作 | 多角色經驗、單角色全部已習得職業／技藝經驗、同庫普通裝備升滿、進階科技同值；先預覽，全部合格才套用 |
| 圖鑑與查詢 | 查看角色、裝備及欄位資料；職業圖鑑可查 47 個繁中職業與轉職路線，不載入存檔也能使用 |
| 比對與復原 | 比對兩份存檔並匯出 CSV，檢視變更、還原累計修改或復原上一步；支援自訂欄位設定匯入與匯出 |
匯出只替換指定值，保留其他原始 JSON 文字。關聯欄位會整組還原；「復原一步」回到上一筆操作。完整功能限制與各版驗收見各版紀錄。
相容性與修改限制
- v2.34 起知識基準為遊戲 V1.0.14.0。請以編輯器顯示的遊戲版本核對；存檔沒有可靠的完整 build 指紋，能開啟不代表新版已相容。V1.0.13.0 起存檔多一層武庫（23 層），v2.35 起武庫物品比照背包編輯；玩過新版後不要切回舊版遊戲，舊版會把武庫截掉。
- 一般模式遵守原版上限，進階模式只開放已實測範圍。尚未核實或關聯複雜的欄位保持唯讀，自訂座標不能繞過限制。
- 經驗操作會聯動等級與餘額，不扣共用經驗池，也不增加遣散／重生退款基數。職業須已習得，且角色未設定自動轉職。
- 基礎資質、技藝上限及天賦調整限符合資格的一般隨機角色，須通過原版組合與關聯檢查；天賦 ID 不能更換或清空。已結丹角色依原版結丹倍率計算上限，結丹紀錄或入體內丹與原版不一致時保持唯讀。
- 丹藥與背包裝備的超限是原版做不到的狀態：超限丹藥只限無結丹角色，遊戲內不能再服同類丹藥、重生會清零；超限裝備的詞條、品質與批次升滿停用；詞條係數超限後此件的品質升降與精準洗練停用，遊戲內重洗會重抽回原版區間；第六槽在遊戲內不能重洗，有第六槽時此件的品質升降、精準洗練與係數調整停用；招募技術超過 299 後書院不能再研究，598 起主動尋訪受限。基礎科技只能解鎖、建築等級只能升高。
欄位座標、公式及來源證據見存檔知識調查，個別功能規則由維護索引進入。
安裝 App 與離線使用
可選擇兩種方式：
- 安裝 App：首次連線開啟網站，等顯示「可離線使用」，再使用「安裝山寨帳房」或瀏覽器安裝選單。iPhone／iPad Safari 使用「加入主畫面」，支援的 Mac Safari 使用「加入 Dock」。之後可離線選檔、修改、比對與匯出，存檔不會加入網站快取。
- 下載單檔 HTML：從網站下載後，用 Edge 或 Chrome 直接開啟即可離線編輯，不需 Node.js、後端或外部遊戲資料表。
關閉前請先匯出，未匯出的修改不會保留。 App 新版會在背景準備，等所有帳房分頁與視窗關閉後更新，不會在編輯途中強制重新載入。清除快取後需重新連線準備；外部指南、準備工具及下載單檔 HTML 仍需網路。
討論與問題回報
專案進度
要看目前做到哪、下一步做什麼，統一看下一步與目前進度。 該頁列出目前主線、階段與下一步；功能路線圖保留候選排序與研究理由。候選項目不代表已排定版本或正式開放。
山寨帳房 Project 以「待辦」、「進行中」、「已完成」追蹤開發與驗收；目前為私人專案，需具存取權限才能查看。
- v2.35 武庫裝備編輯：武庫物品比照背包，可調整等級（含超限）、品質、詞條係數、精準洗練、第六槽，以及套裝、寶物、內丹等級；批次升滿可選武庫。修改後原生取出／存回與從武庫穿卸已在 Mac 隔離副本核對。見本版說明。
- v2.34 遊戲 V1.0.14.0：知識基準改為新版遊戲，原有功能全部維持開放；寶物與內丹升級魂魄底數改 1.04，修改後的原生升級扣費已在 Mac 隔離副本核對；穆桂英／荊軻天賦調整，舊存檔要先在新版遊戲存一次。見本版說明。
- v2.33 遊戲 V1.0.13.0：知識基準改為新版遊戲，原有功能全部維持開放；武庫層登錄為唯讀，基礎科技可直接解鎖新科技 #29 武庫。代表案例已在 Mac 隔離副本重驗。見本版說明。
- v2.32 UI／UX 優化：手機全部功能選單、角色頁內導覽與收合、精簡匯出底列及清楚空狀態；保留既有寫入規則與離線功能。見本版說明。
- v2.31 第六槽：品質 6（神話）的普通裝備可多一條第六槽詞條（係數 50–120），遊戲照算屬性；品質 7 判定不開放。見本版說明。
- v2.30 詞條係數超限：普通裝備已選洗練槽的係數可設到 1000（背包與裝備庫），遊戲的屬性計算照係數等比放大。見本版說明。
- v2.29 招募科技超限：進階科技 #33 的進階模式放寬到 599（招募間隔最短 1 秒；598 起主動尋訪受限）。見本版說明。
- v2.28 遊戲 V1.0.12.2：知識基準改為新版遊戲。新版沒有改到存檔格式與修改器用到的公式，原有功能全部維持開放；裝備與靈物的代表案例已在新版隔離副本重驗。見本版說明。
- v2.13–v2.27（2026-10-24 起改用輕量開發流程，每項都通過合成測試與一次隔離遊戲冒煙才開放）：
- 丹藥：小數增量（v2.13）、結丹角色（v2.16）、超限模式（v2.27）。
- 結丹角色：基礎資質與天賦（v2.17）、技藝上限（v2.18）、結丹品質（v2.21）、入體內丹等級（v2.23）。
- 物品：背包裝備超限（v2.14）、背包靈物五行（v2.15）、未入體內丹等級（v2.22）、已擺放靈物五行（v2.26）。
- 山寨：城牆強化等級（v2.19）、城市層數與聲望（v2.20）、基礎科技（v2.24）、建築等級（v2.25）。
本機開發
直接開啟 index.html 即可使用編輯器。修改程式與執行測試需 Node.js 22 以上：
npm ci --ignore-scripts
node scripts/build-editor.cjs
node scripts/build-editor.cjs --check
程式來源位於 src/，知識資料位於 knowledge/；建置會同步 HTML 內嵌程式與 sw.js 快取版本。不要直接修改產生的內嵌程式。
依變更選跑測試指引中的相關測試；需要 headless 瀏覽器測試時，再執行 npx playwright install --only-shell chromium。完整驗收入口為 npm run verify:release，按需執行。
PWA 需以 localhost HTTP 或 HTTPS 提供完整目錄；file:// 只使用單檔編輯功能，不註冊 Service Worker。GitHub Pages 由 .github/workflows/pages.yml 發布，提交、部署及驗證流程見發布指引。
開發與研究文件
本 repo 不包含玩家存檔、完整遊戲程式或原始分析資料；測試使用合成資料，真實遊戲與存檔驗證在 repo 外的隔離副本進行。
實驗性 macOS 啟動器
另提供 Mac 原生執行指南與準備工具，用於 macOS ARM64 原生執行研究。歷史測試曾確認啟動、Steam 雲存檔清單與 DLC 辨識，以及隔離副本的本機存讀與重啟；這些結果不代表新版遊戲已完成相同驗證，長時間遊玩、真實雲端上傳與成就仍待驗證。
準備方式與存檔位置見啟動器說明，版本及實測範圍見 Mac 執行研究。
