# LOOM v3old:開場、聖所與法杖連續測試 > 最新:已開放原始資料實際存在的全部 73 個 room,包含龍穴後方 65/30 山洞。先前章節的場景清單保留為階段紀錄,最新範圍與驗證見末節。 目前預設直接執行原始 LFL 的初始化、開場及探索 bytecode。使用者已確認第一版開場正常;已擴充村莊、聖所長老演出、取得法杖與 Hetchel 往事,開場結束後繼續執行 G6/G7/G8 和 G45,不再交回手寫探索原型。 ## 啟動與操作 ```bash npm start # http://127.0.0.1:3137 ``` 已有上一版 VM 伺服器時,只需重新整理頁面;更早的伺服器需重啟以啟用 `/game-data/NN.LFL`。另有本機測試服務 http://127.0.0.1:3138 。 - 保留「原始 LFL · SCUMM v3 VM」,先按「開場驗證:自動輸入」觀看片頭;或按「跳過開場/重新探索」直接開始測試。 - 跳過時仍執行原始初始化,再以原始 override 跳過 G44;沒有直接寫入一套假的開場後狀態。 - 單擊地面行走;單擊物件走近/選取,雙擊有名稱的物件查看。右下角圖示執行原始 G8/0x39,包含染坊等條件式圖示。無名稱的出口走近後依原腳本換場。 - 「目前場景」清單可對原始物件/出口發出測試輸入;出口名稱中的目標 room 來自反組譯的導航提示,執行邏輯仍取自 LFL。此清單可選到鏡頭外的熱區;若看不到角色,可用鏡頭滑桿檢查位置。畫面上的自然操作仍可使用墓園中間通道等原始捲動機制。 - 山崖的換層由原始 G45 重設行走目標,遠距點擊可能在換層後停下,再次點選出口即可繼續。走回山頂時仍會穿過岩石缺口,隨目前 walkbox 遮擋。 - 音訊需點「啟用音樂/音效」;倍率/暫停/重播仍可用。「跳過開場/重新探索」會清除目前進度;Esc 優先跳過有 override 的過場,持杖探索時則取消旋律,其他探索狀態會重新開始。 - 「手動轉譯 · 比對用」保留前一原型的開場與 room 02 互動,用於比較;新增場景請使用 VM 模式。 ## 建議連續路線 | 場景 | 可測內容與相鄰區域 | |---|---| | 02 山崖 | leaf/sky 查看、落葉、縮小換層、岩石遮罩;出口 153 → 03 | | 03 村莊岔路 | 原始環境動畫;返回 02、前往墓園 04 或帳篷區 05 | | 04 墓園 | 原始左右捲動通道、洞穴/貓頭鷹/荊棘/墓碑;返回 03 | | 64 墓碑特寫 | 在 04 先查看荊棘,經過原始動物過場後再查看墓碑;單擊畫面返回 04 | | 05 帳篷區 | 長背景行走、環境動畫;返回 03,進入 06 或 07 | | 06 染坊 | dye pot、wool、book、heap、cloth rack、flask 的原始查看;書本拿取/瓶子狀態會保留;出口返回 05 | | 07 聖所外廊 | 原始角色倒影與行走;返回 05;可進入 08 聖所並觸發長老劇情 | 可沿 `02 → 03 → 04 → 64 → 04 → 03 → 05 → 06 → 05 → 07 → 05 → 03 → 02` 往返。目前也可由 07 → 08 進入聖所,走向內側觸發原始 G46:長老爭執、特寫、變成天鵝並飛離,最後返回 09。點取 distaff 後可演奏;查看 egg 學習旋律並對蛋演奏,會觸發 G47/room 81。由 05 可前往河岸 10。23 等較遠目的地仍保留範圍提示;62/63 已開放,見下方更新。較後段劇情尚未完成;本引擎進度匯出/匯入見下方最新更新。 ## 架構 | 模組 | 工作 | |---|---| | `resources.mjs` | XOR FF、00 索引、交錯的 class LE24+owner/state、room/entry/exit/local/object bytecode、walkboxes 與其後的原始矩陣 | | `vm.mjs` | 16-bit 與 bit/間接變數、opcode、巢狀/並行排程、等待、原始探索輸入、物件距離/行走定位、loadRoomWithEgo、room hooks、可巢狀的 freezeCount 與 cutscene owner、音訊事件 | | `geometry.mjs` | v3 矩陣三位元組區間解碼、polygon 內點、最近點與 box 通道點;不依新 room ID 手寫路徑。仍需與更多原作場景校準 | | `costumes.mjs` | 原 costume commands、保留部分 limb、停止/恢復、非循環/隱藏控制,繪圖以原 cel offset 對應 PNG | | `palette.mjs` | 依原始 RoomColor/actor palette 重映射 EGA 快取,保留 alpha/尺寸 | | `startup-input.mjs` | 可選的初始化滑鼠測試輸入,不修改變數或 bytecode | | `../app.mjs` | Canvas/逐角色 mask、放大 DOM 文字、MP3、原始 VM 狀態與目前場景清單;保留舊原型供比對 | `descumm` 僅供研究與導航提示;runtime 不讀其 `.txt`/合成標頭 `.bin`。美術 PNG/mask、cel metadata 與 MP3 仍為原資源的解碼快取。原字型尚未採用。時間採 60Hz jiffy 與 VAR_TIMER_NEXT,文字閱讀及聲音結束時間仍需與 DOSBox 校準。 共用功能修正包含:getActorX/Y 在本版實際讀取 word(也可讀物件 ID);getDist 先把物件定位投影到行走區;過場保護當前擁有者,避免 G2 freezeScripts 把 G45 自己凍住;panCameraTo 暫停跟隨,避免出口鏡頭永遠到不了目標。 ## 資源與驗證 19 個 room、276 個 object code、62 組 costume/1257 個 cel,共 1683 張 PNG。原 116 個 global 候選不變。room 04 的 167/171 影像指標未能以各自熱區尺寸解碼,沒有替它們造圖;背景、真正疊圖與熱區/腳本仍可使用。 ```bash npm run extract # 重建資源、反組譯、導航提示與離線包 npm run test:vm # 原始開場/網頁接合/離線包,9 項 npm run test:exploration # 原始腳本往返/持續狀態/邊界/缺口/palette,5 項 npm run trace:exploration # analysis/opening/exploration-validation.json npm run test:sanctuary # 完整長老劇情、法杖、對蛋施法、往事、河岸 npm run trace:sanctuary # analysis/opening/sanctuary-validation.json npm test # 舊原型與原始 hash 等回歸,8 項 npm run test:assets # Pillow 像素/mask,5 項 npm run test:audio # 音訊與實際 MP3 解碼,5 項 npm run standalone # 完整離線 HTML,含原始 LFL/1683 PNG/62 MP3 ``` 固定 seed 往返 trace 執行 92 種 opcode byte 變體、1,115 個引擎事件,最後回到 room 02,userput=1、無 fault。這是含初始化 override 的 headless 測試,不是原作時序或瀏覽器逐幀驗收。原始 EXE/LFL hash 保持不變。第一版開場已由使用者實測確認正常;本輪新場景仍待使用者視覺驗收。 未支援指令會停止並報 script/offset/opcode;已知未開放目的 room 則在換場前顯示邊界,維持目前世界。保留 instruction budget 避免無窮迴圈凍結 UI。這是 LOOM v3old 的擴充子集,不代表全遊戲或所有 SCUMM 版本相容。 ## 授權與來源 依 ScummVM 的 opcode、變數、costume 與 boxes 語意改寫的模組採 GPL-3.0-or-later,見 `COPYING`/`COPYRIGHT`。研究來源的本地 SHA256 與可取得的上游 file blob SHA 見 `analysis/reference/SOURCES.json`。遊戲資料為使用者提供的原始檔案。 來源:[ScummVM](https://github.com/scummvm/scummvm)、[script_v3](https://github.com/scummvm/scummvm/blob/master/engines/scumm/script_v3.cpp)、[script_v5](https://github.com/scummvm/scummvm/blob/master/engines/scumm/script_v5.cpp)、[排程與 freeze/cutscene](https://github.com/scummvm/scummvm/blob/master/engines/scumm/script.cpp)、[舊索引](https://github.com/scummvm/scummvm/blob/master/engines/scumm/resource_v3.cpp)、[物件索引](https://github.com/scummvm/scummvm/blob/master/engines/scumm/resource_v4.cpp)、[costume](https://github.com/scummvm/scummvm/blob/master/engines/scumm/costume.cpp)、[尋路矩陣與 gates](https://github.com/scummvm/scummvm/blob/master/engines/scumm/boxes.cpp)。 ## 聖所與法杖操作(本輪更新) 支援 room `[1,2,53,69,3,4,5,6,7,64,8,9,10,11,54,67,81]`。54/67 是長老及 Hetchel 特寫,11 是飛離鏡頭,81 是往事。皆由原始 LFL 排程,不是另寫劇情時間表。G46/G47 的文字、換場、變形、飛離與持杖切換都取自原腳本。 取得法杖後先單擊選物件,再點音階或按 Q W E R T Y U I;音階仍受原始學習進度與腳本限制。雙擊 egg 可聽它的旋律;重奏同一旋律會觸發原生 spell dispatcher。Esc 在可跳過的過場使用原始 override;持杖探索時取消旋律。尚未取得法杖的探索狀態按 Esc 會重新探索。 「hover 顯示方框」預設關閉,可獨立勾選;「全部熱區/行走線」另外控制測試覆蓋層。物件預覽與名稱仍保留。 新增 putActorAtObject、原始 verb 圖來源/繪製順序/點擊及鍵盤派送、說話動畫還原、明確 Pos 的靠左排版與 EGA 字色。99.LFL 字型仍未完整移植;音符控制字暫映射為可放大的 C D E F G A B C′。costume 52 有一個未使用動畫的 cel 36 指標異常,擷取索引記錄 invalidFrames;完整本輪演出未引用它,遇到非法 cel 仍停止報錯,不造圖。 `test:sanctuary` 每 tick 檢查當前角色顯示的 cel 均有可用 PNG,完整執行未跳過的 G46,確認至少三名長老進入變形 costume、持杖姿態與 room 1 音符圖、播放學會的旋律觸發 G47、返回村莊/河岸且持杖狀態保留。測試只發輸入,不改遊戲變數。 ## 帳篷全部開放(最新更新) 帳篷區 05 的染坊入口 199 通往 06;另一帳篷入口 203 依原 vars216 bit11 通往 63(黑暗內部)或 62(紡車房)。兩個版本均已載入;19 room 清單為前述 17 room 加上 62、63。黑暗是原作場景狀態,並非缺少背景;保留原先學習/施法條件,沒有直接打開照明或改寫劇情旗標。 63 出口 820 返回 05,可查看 gold/darkness。向墓園的貓頭鷹學會旋律後,對 darkness 演奏,原 G48 會切到 62;出口 808 返回 05。62 的 wheel、gold/straw 可查看,紡車播放原始四音,之後再進帳篷會保留開啟狀態。 新增原始 `setObjectName`(0x54/0xD4)支援;名稱以 VM instance 的 override Map 保存,文字、預覽、場景清單讀取同一名稱,不改原始 LFL 或共享資源。costume26 新增三個紡車 cel。62 的出口808影像指標不能以自身熱區尺寸解碼,索引保留 decode_failed;出口背景與原始轉場可用,未造替代圖。 `npm run test:tents` 驗證未持杖進出黑暗帳篷、原生貓頭鷹學習與夜視施法、G48 換場、物件名稱、紡車四音、持杖及進出狀態;逐 tick 驗證演出所用 cel。網頁 mock 另檢查帳篷進出與場景名稱。新增內容仍需使用者在瀏覽器確認視覺細節。 ## 匯出/匯入進度與語系(最新更新) 畫面下方新增「匯出進度」「匯入進度」。匯出下載 UTF-8 JSON 文字檔,可跨重新整理保存,再選取檔案匯入;不依賴瀏覽器 localStorage。存檔是本引擎格式,不能作為 DOS/ScummVM 存檔使用。 探索中可匯出,包括一般行走及對話;原始過場、初始化或 VM 故障時停用匯出。儲存變數、物件/名稱/已學旋律、角色位置/路徑/costume limb、活動腳本 PC/locals/等待、時鐘、內建亂數狀態、相機、palette、靜態文字及場景可變幾何。匯入先在新的 VM 驗證,成功才替換目前遊戲;錯誤 JSON、版本或 LFL fingerprint 不符、非法腳本位置會拒絕並保留目前進度。後續引擎格式有變可能需要新的存檔版本。 音訊接續沿用既有 MP3 播放器;不是 DOS 音源狀態的精確還原。音量/啟用狀態沿用目前瀏覽器設定,語系及選取物件隨存檔還原。自訂外部 RNG 的開發用 VM 不提供匯出,網頁預設採可保存的內建 RNG。 「遊戲文字」dropdown 提供 English 與繁體中文前段測試。English 直接使用 LFL 英文;繁體中文依文字來源識別碼顯示,缺譯或佔位符不符時回退英文。切換會更新目前對話、靜態文字、物件名稱/預覽;原 VM 字串、劇情判斷及閱讀時間保留英文。翻譯參照與動態值亦會寫入 JSON,匯入後仍可切換語系。 完整清單及規格見 [analysis/text/README.md](../../analysis/text/README.md),包含 `catalog.json`/`catalog.csv`、`zh-TW.template.json`、可編輯的 `zh-TW.json` 與 `missing-zh-TW.json`。目前是全資源索引與前段翻譯試用,尚非全遊戲中文化;不能解析的資源明列診斷。 ```bash npm run extract:text # 建立 instrumented descumm、全資源清單、初始範例及報告 npm run report:text # 補譯後更新缺漏/格式報告 npm run test:text # 原始執行位置、動態數字/名稱、回退、控制碼與資源路由 npm run test:progress # JSON往返、行走接續、持杖與錯誤存檔 npm run standalone # 補譯或改程式後重建離線HTML ``` 伺服器新增 `/assets/text/` 靜態路由;舊 Node 程序需重啟才能載入。測試服務 3138 已重啟並確認中文翻譯路由 HTTP 200。 ## 音階顯示、天空 Open 與新增 20 場景(2026-11-16 最新) 新開放 `[12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,55,56]`,包含海上航程、水龍捲、登岸、水晶城、玻璃工匠墓園/工坊/聖杯廳、牧羊人邊界/牧場/帳篷、龍穴及相關演出/特寫。加上原19個,現在39個room、471個object code、125組costume/2374個cel,共3090 PNG。 天空 Open 的真正中斷點是 G49 的 RoomOps 5(ShakeOn),不是缺少目的場景。新增5/6震動開關及上方場景區的輕微震動,字幕與樂譜不跟著移動;Room22 的原始 debug(word) 亦已支援。G49 會經海岸/村莊/河岸演出後回山崖。 行走修正:腳本在 ignoreBoxes 狀態定位後再解除,可能保留舊room的walkbox編號。共用 matrixRoute 會檢查角色是否仍在該box,必要時從目前位置重新尋找起點;沒有為海岸/水晶城另寫路線。 法杖區的消失來自換場清除staticText。持杖後換場保留下方144~199文字/繪圖區;初始化畫面仍清除,避免殘字。音階字母移至五線譜上方,原99字型的兩段音符暫以可放大的CSS符頭/符幹表示。這是字形近似,不宣稱已完整移植99.LFL。原始腳本控制字色、可用音階與點擊。 舊JSON存檔若已丟失底部文字,顯示層會依原G18的位置與已學音階補上基準字母/音符;不重啟G18、不改施法輸入。G19關閉法杖時隱藏這些字形。既有存檔格式及LFL fingerprint維持相容。 已完成全部正常解析的1201項文字繁中初譯:缺譯0、佔位符錯誤0;人名、檔名按需保留原文。原始2038個文字位置仍包含空字/控制碼及不完整候選;15項解析/缺檔診斷另列。原文對照字典為 `tools/translations/zh-TW-full.json`,實際翻譯仍編輯 `analysis/text/zh-TW.json`;需按完整遊玩語境繼續校訂。 ```bash npm run test:mainland # 原生解謎出海至水晶城 + 20個入口fixtures npm run trace:mainland # analysis/opening/mainland-validation.json npm run report:text # 1201/1201;missing 0;invalid 0 ``` 連續測試由原始操作學習/施用旋律,取得F音後對天空Open、出海、反奏水龍捲、登岸並進入16/17/22/18,沒有寫入劇情旗標。20個入口另用隔離fixture驗證30秒原始腳本及可見cel,不代表20場景內每個謎題或後續全遊戲都已通關。新演出的畫面與中文語氣仍待使用者實測。 讀檔隱形修正:原生actor動畫依VM時鐘,不能再用新頁面的時間去索引。繪圖改為直接使用VM的當前cel,避免跨頁匯入後負動畫索引造成角色不繪製。既有JSON可直接重匯入,無須修改或重新開始。新增回歸驗證新頁面讀檔後立即及移動時都有主角圖塊的drawImage呼叫。 ## 全資源 opcode 盤點與墓碑對話修正(最新) 玻璃工匠墓園的 G66 呼叫 `walkActorToActor(1,3,32)`,先前0x0D未支援而中斷。現在支援其四種直接/變數參數組合、指定距離及0xFF依角色寬度/比例計算距離;不同room或無效目標不行走。已用原始操作觸發 G66→G68,完整經56特寫並返回17,恢復輸入,沒有跳過對話。 `analysis/opcodes/audit.json` 與同目錄 README/scripts 保存全資源盤點:983份可完整解析的腳本、133個實際opcode byte變體,未支援分派0、已觀察子指令缺口0。排除無效global116候選;缺少原始room檔案仍由文字清單診斷列出。指令邊界由descumm解析,不是把圖像/字串bytes當作opcode掃描。 本輪另補系統操作、可修改字串的load/copy/set/get/allocate、原始99.LFL字寬查詢,並校正v3/v4的0x22/A2(saveLoadGame)與A7(saveLoadVars)覆寫:它們不是v5同編號的actor動畫計數/一般字串指令。新的字串byte緩衝也能隨JSON保存,既有存檔缺此欄位時可延遲重建。 平台差異仍明列:瀏覽器不提供DOS磁片slot檔案,舊存讀指令依原作回傳「無檔/讀寫失敗」代碼,不假裝已存成功;使用下方JSON進度按鈕保存。restart/pause/quit由host接到既有網頁操作。99.LFL本輪只增加精確字寬,不代表完整原字型繪圖已完成。 ```bash npm run audit:opcodes # 重建全部opcode及子指令出現位置/缺口報告 npm run test:opcodes # 墓碑完整對話、參數解碼、字串、字寬、平台回傳 npm run check # 先重建盤點,再跑全部Node測試檔及Pillow像素測試 ``` 盤點與測試要求missing兩張清單都為空,新增未支援的實際指令會使檢查失敗。靜態分派覆蓋不等於每個動態參數、故事分支、尚未擷取的美術資源或全遊戲通關皆已驗證;非法資料仍精確報錯,不能用略過未知opcode掩蓋問題。 ## 全部現有場景開放與龍穴後方修正 原本僅安裝 39 個 room。龍穴燒毀金堆後,出口 465 透過 G72 在 cutscene 中載入 room 65(黑暗山洞);照明後 G78 載入 room 30(山洞迷宮)。兩者原本均不在資產清單,換場被範圍限制擋住,後續原腳本便無法正常完成這段演出。 擷取器現在保留原有開場排序,再自動納入根目錄每個實際存在的 room LFL,不再以手動清單限制後段範圍。00 是索引、99 是字型,均不當作場景。全部 73 個 room 的背景、遮罩、物件與原始腳本,以及相關 costume 都已加入網頁與離線/部署包。 新增 34 個 room:`30–47、49–52、57–61、65–66、68、70、79、86–87`。補齊鐵匠服中景資源後,總量為 833 個 object code、594 張物件圖、667 張遮罩、158 組 costume/3038 個 cel,連同 73 張背景共 4372 張 PNG。圖片尺寸及原始 LFL 不變,原 JSON 進度仍可匯入。 原始檔確實缺少的 room(48、71–78、80、82–85)仍無法載入;不以空場景替代,也不補造 bytecode。所有現有場景已開放不代表全劇情已通關驗收;物件圖像診斷、costume 52 的既有異常 cel、缺檔音源與精確原作時序仍保留各自限制。 驗證分為: - 34 個新增 room 各執行原始 entry 與後續排程 30 秒,逐 tick 驗證顯示角色引用的 cel 都有 PNG,沒有 VM fault。 - 龍穴回歸 fixture 使用原 G25 標記前置法術,再經一般選取與音階輸入,將黃金變稻草、恐嚇龍使其燒毀金堆,走入 65 並照明進入 30;兩段演出皆結束,userput=1、無 cutscene、無 boundary/fault。 - 另使用使用者提供的 room 24 進度,實際重播染色羊群→龍穴→燒毀金堆→65→照明→30,未改寫該存檔的劇情變數或目的 room。 以上為 Node 原始 bytecode 與資產測試,未宣稱真實瀏覽器、DOSBox 逐幀或全遊戲所有分支均已驗收。可用 `node test/all-rooms.test.mjs` 重跑新增場景與龍穴回歸;`npm run check` 包含此測試。 更新雲端時請使用新建的 `dist/loom-server.tar.gz`;更新後重新整理遊戲,再匯入停住前的 JSON 進度。舊版已停在換場中途的頁面不會自動載入新 VM 與資源索引。 ## 山洞窄路每次只走一個像素的修正 room 30 local 200 在 walkbox 29、30、41、42 檢查 `VAR_TALK_ACTOR == 1`,並以原始 `animateCostume(1,255)` 停止正在說話的主角。先前 VM 在對話結束後未將 VAR_TALK_ACTOR(vars25)還原為 255;G16 的空字串 print 也會留下主角 ID,造成即使沒有對話,每次走路都被下一幀原腳本取消。 現在初始化與 endTalk 使用 255 表示沒有說話角色,空字串不留下說話角色。匯入舊存檔時,若沒有 active message,也會清除此殘留旗標;真正未結束的對話仍完整保留。未修改原始 LFL、山洞尋路矩陣、通道或 local 200 的停步條件。 `test/cave-walking.test.mjs` 驗證真正說話時仍停步、對話結束/空 print 後可以一次連續跨越 29→30→32→33→34→35,再由原通道503移往49→38,接著走508到水池31、521回30、504轉接、506到出口33。另驗證舊存檔殘留說話角色的修復、實際對話續播、旋律與位置保留。更新執行包並重新整理後,可以直接匯入目前卡在窄路的進度,不需退回龍穴。 本輪 Browser 技能已能連上 Chrome 並找到遊戲分頁,但 DOM、可見控制項與截圖均回報 timeoutMs 介面錯誤,仍未完成真正瀏覽器操作驗收。上述連續行走與換場為 Node VM 執行原始腳本的結果。 ## 直接點畫布上的音符與 untwist 畫布底部清晰字母/音符原本是不能接收點擊的 DOM 顯示層,滑鼠會落到其下方的原生 bitmap 動詞矩形。現在顯示的字母與音符有各自的點擊事件,直接呼叫對應的原始音階動詞,並停止事件往下冒泡,避免同一次點擊再變成 Canvas 地面輸入。字母可 Tab 聚焦,Enter/Space 演奏;音符圖形與畫布外音階按鈕走同一條輸入流程。 事件檢視提示會顯示實際接受的音符,例如「已輸入 4/4:E D D F」。若原腳本還在完成上一段旋律,會提示等待,不會排入額外音符或改動原作的四音判定。原生 bitmap 的其餘點擊區仍保留。 使用者 room33 進度的扭轉為 F D D E,untwist 為 E D D F,已學會且可用到第六音。該檔最後保留的四音是 D D F D;尚未重現使用者那次滑鼠點擊為何留下這個順序,不能宣稱原腳本不支援 untwist。實際從該檔送入 E D D F,可走 G22→G26[4,1]→物件544/0x42→local200,啟用正常階梯。 網頁接合回歸使用 seed2 原始初始化取得相同旋律,經原 G29 開啟前置音階、G25 標記已學習,再於2/3/5倍逐一點擊顯示的字母和音符,確認 E D D F 各只輸入一次、busy時不變更四音、551~554圖像切換且正常走到room34。這是DOM/Canvas mock與原bytecode測試,仍非真正瀏覽器點擊驗收。 ## 鐵匠區通往 room 37 途中人物消失 換裝腳本 room34 local202 將近景/中景服裝寫入 vars119=103、vars120=104;G17 依距離讀取這些變數。舊擷取器只搜尋明寫在 Costume/Resource.loadCostume 的常數,漏掉只透過變數使用的104。VM原本已能執行104的原始costume動畫,但繪圖快取沒有104,drawActor便無圖可畫;切回近景103時才重新出現。 擷取器現在同時收集G17服裝變數119~121的常數賦值,補齊104的68張原始cel。未移除遮罩、改寫換層、限制costume切換或放大103代替104。此修正也涵蓋之後相同服裝的中景行走,原存檔與fingerprint不變。 新增回歸使用原34 local202完成換裝,再經一般點擊走過36的近/中景換層直到37,逐tick檢查每個顯示圖格都已安裝;網頁接合測試確認104行走時實際呼叫drawImage;Pillow驗證104四方向的全部行走圖格尺寸與非透明像素。來源104圖格亦已目視檢查。這些是Node/DOM mock/像素檢查,尚無真瀏覽器逐幀驗收。 更新部署包後重新整理、匯入目前進度即可,不必重新換裝。離線HTML與部署包都已包含104資源。 ## room 43 鐵籠不能施法、匯出也被鎖住 room41 local204 會先呼叫施法特效 local213。特效的cutscene凍結了呼叫者;舊VM卻在子腳本yield後繼續執行已凍結的呼叫者,讓它過早開始自己的cutscene並進入G90。換場時local213被停止,其未結束的cutscene、userput限制與G6凍結狀態仍留在room43,造成籠子已顯示但音階與匯出不能使用。 VM的run迴圈現在每次執行opcode前都檢查frozen/freezeCount;巢狀子腳本凍結呼叫者後,呼叫者會停在下一個opcode,等特效結束、原G3解除凍結後才續跑。語意依據為本機上游script.cpp的runScriptNested:呼叫者freezeCount非0時不恢復執行。未刪除原cutscene、強制解鎖游標或放寬過場中的存檔限制。 `test/cage.test.mjs` 驗證204停在呼叫213後、213結束才續跑,並以完整對話/原始override兩種流程走到43,確認cutscene空、userput=1、腳本未凍結、音階可用,且匯出/匯入後仍可輸入E C E D開籠。其後G91講述計畫的真正過場仍不能匯出,避免製造不能可靠還原的存檔。 另以使用者原room37存檔,經一般點擊進41、查看conversation633、選取sword634並演奏原反向磨鈍旋律G A A A,完整重播被捕與G90,到43恢復操作。未手寫劇情旗標或跳過bytecode。`tmp/loom-room-43-recovered.json` 是由此產生、已測試匯出/匯入及開籠的替代恢復點;它不是無法匯出的目前瀏覽器分頁快照,不包含原room37存檔之後另做的探索變更。 更新部署包並重新整理後,可匯入被捕前的存檔重走,或使用上述替代恢復點。以上為原bytecode與Node測試,未宣稱真正瀏覽器逐幀驗收。 # 網站按場景載入圖片(2026-11-17) `web/scene-assets.mjs` 以當前room、場內actor costume及跨room HUD動詞圖建立必要圖片集。只在必要圖片齊全時繼續繪圖與VM時間;匯入、換場及換裝均適用。整套當前costume一起準備,避免動畫每換一格就等待。相鄰room依出口及已知開場連線背景預載一層,最多6個並行請求,前景優先、共用請求並保留已解碼圖片。失敗可重試,真正VM過場與匯出規則不變。 `analysis/opening/asset-version.json` 由實際資料內容產生;圖片、音訊、LFL與執行索引以版本query取得長效快取。入口、程式碼與版本索引使用ETag重新驗證,舊/未知版本query不給immutable。版本由prepare:vm、standalone與package:release生成,執行包需完整更新並重啟服務。原始LFL fingerprint與存檔格式不變。網站仍一次載入全部LFL與資源metadata;單檔離線版仍完整內嵌。操作及限制見專案 `doc/scene-loading.zh-TW.md`。