玩家能否離開 - 地圖邊界檢查器

這是一個爲地圖製作者設計的工具，用於檢測玩家是否能夠在地圖中越界。好奇的玩家也歡迎使用。

Can The Player Leave - Out of Bounds Checker

🎯 **專爲地圖製作者打造的邊界檢測工具**

這個模組主要爲地圖製作者設計，無論你是在製作新的溫室、地圖補丁，還是整個擴展包中的全新地圖集合。

---

🎮 功能特色

✨ **SMAPI控制台命令**：添加了"escapemap"命令，無需遊戲內UI即可使用

✨ **多種參數選項**：支持多種參數組合，滿足不同檢測需求

✨ **智能地圖掃描**：自動檢測玩家可通過各種方式到達的地圖位置

---

📝 命令使用指南

**基本命令語法**：

```

escapemap [參數]

```

**可選參數**（可按任意順序組合）：

• `"print"` 或 `"grid"` - 以圖形化網格顯示請求的位置
• `"any"` 或 `"all"` - 包含當前加載的所有地圖（農舍除外）
• `"farmhouse"` - 單獨使用時僅顯示農舍的圖形化網格

**使用示例**：

• `escapemap any grid` - 顯示所有當前加載位置的信息和網格（農舍除外）
• `escapemap farmhouse any grid` - 僅顯示農舍網格
• `escapemap` - 僅顯示當前位置的文本信息（無網格）

---

🔍 工作原理

**簡而言之**：

模組通過掃描玩家在當前存檔中可用的所有旅行方式（包括行走、傳送等），找到玩家可以到達的地圖瓦片，然後基於可步行性執行洪水填充算法來檢測越界點。

**技術細節**：

• 創建有向圖，節點是用於旅行的瓦片（傳送點、礦車等）
• 基於可用旅行方式定義有向邊
• 使用洪水填充算法基於"可步行性"處理地圖中的每個瓦片

---

⚠️ 重要注意事項

🔸 **地圖檢測限制**：模組只會檢測它認爲玩家可以步行或傳送到達的位置。對於全新的自定義地圖，除非設置了傳送點或將玩家傳送過去，否則可能無法檢測。

🔸 **忽略的位置**：自動忽略礦洞、火山地牢等特殊位置，以及不在Game1.locations中的位置。

🔸 **誤報處理**：如果報告了某個瓦片但無法理解如何到達，嘗試使用print參數。如果仍然無法理解，可能是其他加載的地圖有通往該瓦片附近的傳送點。

🔸 **警告信息**：首次使用"escapemap"命令時，其他模組可能會打印警告。這些警告通常只出現一次且無害，可以忽略。

---

🌟 使用建議

如果你是地圖製作者：

• 使用此工具確保你的地圖邊界安全
• 測試所有可能的玩家移動路徑
• 利用網格顯示功能直觀查看問題區域

如果你是普通玩家：

• 發現越界問題時，請耐心友好地向地圖製作者報告
• 可以推薦製作者使用此模組進行自我測試

---

💡 **技術提示**：模組會考慮所有類型的觸摸動作效果，包括地圖外觸摸傳送，這意味着它知道這些傳送也能防止越界。如果你的地圖缺少地圖外觸摸傳送，這個模組會發現它！

---

特別感謝Sunberry Village團隊的星露谷物語模組製作者們在開發過程中提供的鼓勵和見解！