全地圖 | AllMap

AllMap 模組 - 絲之歌全地圖解鎖

功能介紹

AllMap 模組可以在玩家進入遊戲時自動解鎖全地圖，讓您無需探索即可查看完整的遊戲地圖。

主要功能

• **自動給予羽毛筆** - 確保玩家擁有查看地圖的基本工具
• **開啓全房間顯示** - 設置 `mapAllRooms = true`，顯示所有房間佈局
• **映射當前場景** - 自動將當前場景添加到已訪問和已映射列表
• **智能檢測** - 只在遊戲世界中生效，不影響菜單界面

安裝方法

前置要求

• Hollow Knight: Silksong 遊戲
• BepInEx 5.x 框架

安裝步驟

• **安裝BepInEx**（如果還沒有安裝）
• 下載適用於Unity遊戲的BepInEx 5.x版本
• 解壓到遊戲根目錄
• 運行遊戲一次以生成必要文件

• **安裝AllMap模組**
• 下載 `AllMap.dll` 文件
• 將DLL文件放入 `BepInEx/plugins/` 目錄
• 啓動遊戲即可

配置選項

模組配置文件位置：`BepInEx/config/allmap.cfg`

可用配置項

```ini

[General]

是否啓用全地圖功能

EnableAllMap = true

[Debug]

是否啓用調試日誌（用於故障排除）

EnableDebugLog = false

```

使用說明

基本使用

• **安裝模組後啓動遊戲**
• **進入任何存檔**（新檔或舊檔都可以）
• **等待5-10秒**，模組會自動檢測遊戲狀態
• **打開背包查看地圖**，應該可以看到全地圖已開啓

配置修改

• 遊戲運行一次後，配置文件會自動生成
• 關閉遊戲，編輯 `BepInEx/config/allmap.cfg` 文件
• 修改配置項後重新啓動遊戲生效

功能驗證

• 打開背包中的地圖，應該能看到完整的地圖佈局
• 地圖上會顯示所有房間的形狀和連接
• 當前所在位置會正確標記

技術實現

核心機制

• 使用Unity的Update循環檢測遊戲狀態
• 智能識別遊戲世界場景（排除菜單界面）
• 一次性應用設置，避免重複執行

地圖解鎖原理

• **給予羽毛筆**: `PlayerData.hasQuill = true`
• **設置羽毛筆狀態**: `PlayerData.QuillState = 1`
• **開啓全房間顯示**: `PlayerData.mapAllRooms = true`
• **映射當前場景**: 添加到 `scenesMapped` 和 `scenesVisited` 集合

安全設計

• 只修改必要的地圖相關數據
• 不影響遊戲進度和成就
• 包含異常處理，避免遊戲崩潰

故障排除

常見問題

• **模組沒有生效**

```

解決方案：

• 確認BepInEx正確安裝（遊戲根目錄應有BepInEx文件夾）
• 檢查AllMap.dll是否在 BepInEx/plugins/ 目錄中
• 查看BepInEx控制台或日誌文件是否有錯誤信息

```

• **地圖沒有完全顯示**

```

解決方案：

• 等待更長時間（最多30秒）讓模組檢測遊戲狀態
• 嘗試切換場景或重新進入存檔
• 檢查配置文件中EnableAllMap是否爲true

```

• **遊戲啓動異常**

```

解決方案：

• 臨時移除AllMap.dll，確認是否爲模組問題
• 檢查是否缺少依賴文件（MonoMod.*.dll）
• 查看BepInEx日誌獲取詳細錯誤信息

```

日誌查看

**BepInEx控制台**：遊戲啓動時會顯示黑色控制台窗口，可以看到模組加載信息

**日誌文件位置**：`BepInEx/LogOutput.log`

**模組成功加載的標誌**：

```

[Info: All Map] AllMap模組已加載

[Info: All Map] 檢測到遊戲狀態，應用全地圖

[Info: All Map] 開始應用全地圖功能

[Info: All Map] 設置核心地圖標誌完成

[Info: All Map] 全地圖功能已應用

```

兼容性說明

• ✅ **與其他模組兼容**：設計簡潔，不會與其他模組衝突
• ✅ **存檔安全**：只修改地圖顯示，不影響遊戲進度
• ✅ **可安全卸載**：刪除DLL文件即可完全移除
• ✅ **遊戲版本**：適用於Hollow Knight: Silksong

開發信息

• **開發語言**: C#
• **框架依賴**: BepInEx 5.x
• **遊戲版本**: Hollow Knight: Silksong
• **模組版本**: 1.0.0
• **文件大小**: 7KB

更新日誌

v1.0.0 (當前版本)

• ✨ 實現核心全地圖解鎖功能
• 🎯 簡化代碼結構，提高穩定性
• 🛡️ 添加異常處理，防止遊戲崩潰
• 📝 提供詳細的使用說明和故障排除指南

許可證

本模組僅供學習和個人使用，請勿用於商業用途。

致謝

感謝 Team Cherry 開發的精彩遊戲，以及 BepInEx 框架的開發者們。