紋理解析器

一個輕量級實用模組，可在您穿越場景時導出大部分遊戲紋理（PNG格式）。專爲絲之歌定製器模組設計的配套工具，讓定位和替換特定紋理變得更加容易，無需猜測文件名。

Texture Parser

🎯 **一款專爲紋理替換模組打造的智能助手工具**

模組簡介

這款模組最初是我個人用來尋找想要編輯和替換的紋理的工具。雖然不是一個完善或功能完整的項目，但如果您計劃使用絲之歌定製器或其他紋理替換模組，它仍然是一個非常方便實用的工具。

---

✨ 核心功能

• **自動解析紋理**：在場景加載時解析並保存大部分紋理（UI元素、物體、角色等）爲PNG文件
• **智能分類管理**：將紋理組織到正確命名的文件夾中，可直接用於紋理替換模組
• **避免重複導出**：通過緩存機制減少加載時間（可在配置文件中或BepInEx配置菜單中啓用強制替換）

🎮 工作原理

• **遊戲啓動** - 正常啓動絲之歌遊戲
• **場景加載** - 當第一個場景（菜單、關卡或區域）加載時，遊戲請求該場景所需的所有紋理
• **紋理捕獲** - 模組在紋理加載到內存時自動攔截它們
• **本地保存** - 每個捕獲的紋理立即保存爲PNG文件到輸出目錄，並按遊戲紋理集合名稱組織到對應文件夾
• **遊戲過程** - 當您在關卡間移動或重新訪問區域時，新場景加載，模組會捕獲尚未保存的任何紋理
• **無重複** - 已導出的紋理會被跳過以節省時間

**效果**：只需正常玩遊戲並穿越不同場景，您就能逐步建立紋理庫 - 準備好用於定製器模組或手動編輯。

---

⚠️ 當前限制

• **背景紋理**：目前無法解析牆壁、地形或大型背景等環境紋理
• **場景選擇**：無法從菜單選擇特定場景 - 需要手動訪問區域來收集其紋理

📥 安裝指南

• 安裝BepInEx(v.5版本)
• 運行遊戲一次以創建'plugins'文件夾
• 將.dll文件解壓到'\Steam\steamapps\common\Hollow Knight Silksong\BepInEx\plugins\'目錄
• **（可選）** 安裝BepInEx配置管理器以便在遊戲中輕鬆訪問配置

📁 輸出文件

所有解析的紋理都保存爲PNG文件，位於：'\Hollow Knight Silksong\Hollow Knight Silksong_Data\Mods\Texture Parser\Output\'

每個集合都有其自己的子文件夾，包含正確命名的紋理。

🔧 故障排除

**模組完全無法加載**

• 確保BepInEx正確安裝並正常工作
• 驗證模組的.dll文件是否放置在'\BepInEx\plugins\'文件夾中
• 檢查BepInEx日誌文件(BepInEx/LogOutput.log)中與此模組相關的錯誤

**輸出目錄中沒有紋理**

• 再次檢查模組.dll文件是否在正確的文件夾中
• 在遊戲中按F1檢查模組是否啓用（僅當安裝了配置管理器時）

**仍有問題？**

• 在模組頁面的帖子/評論部分發布您的問題，包括LogOutput.log文件的副本以幫助診斷問題

💡 使用提示

**性能說明**

• 首次啓動或首次加載大型場景時，處理主要紋理可能需要約20秒。之後，緩存機制使其保持快速流暢
• 與傳送模組配合使用效果良好，可實現更快的場景切換和大規模紋理轉儲

**未來計劃**

• 探索如何轉儲*所有*遊戲紋理，包括背景
• 添加場景選擇系統以避免手動訪問

**如何停止使用**

• 如果您已完成使用該工具，只需從遊戲內配置菜單禁用它或從'\BepInEx\plugins\'文件夾中刪除即可