小地圖 & 大地圖移轉

如何將其他客戶端模組包內的小地圖 & 大地圖相關資訊轉移到本模組包

模組包內的大小地圖

本模組包使用的小地圖和大地圖的方案，採用 Xaero 的方案（請參考 Xaero's Minimap 和 Xaero's World Map 的說明），你可能會面臨以下狀況：

之前的客戶端也有安裝 Xaero 方案的大小地圖

之前的客戶端模組包也採用了 Xaero 方案的大小地圖

本模組包舊版（指 2.0.0 以前的版本）的大小地圖要移轉到新版客戶端模組包內

從本模組包 2.0.x 升級到 2.1.0 及以後的版本

本文件就是在講述相關狀況的應對方式。

以下教學會需要訪問 Minecraft 資料夾，不同的啟動器訪問方式都不太一樣，以下舉例：

通用解法：打開 Minecraft 本體，在主畫面依序選擇「選項 -> 資源包... -> 開啟資源包資料夾」，並在該資料夾往上一層，就是 Minecraft 資料夾

MultiMC/Prism Launcher：選擇其中一個實例（不是打開），並點選右側的「資料夾」按鈕，並且進入 .minecraft 資料夾

以下會將此動作代稱為「訪問 Minecraft 資料夾」而不再次說明

狀況一：之前的客戶端有安裝 Xaero 大小地圖

首先訪問 Minecraft 資料夾，接著，你需要複製以下檔案/資料夾：

XaeroWaypoints 資料夾

XaeroWorldMap 資料夾

config 資料夾底下的檔案（沒有的檔案可以忽略不用複製）：
- xaerominimap_entities.json
- xaerominimap-common.txt
- xaerominimap.txt
- xaeropatreon.txt
- xaeroworldmap-common.txt
- xaeroworldmap.txt

將他們複製到本模組包的相對位置，例如 XaeroWaypoints、XaeroWorldMap 兩個資料夾就直接複製到本模組包的 Minecraft 資料夾底下就好，config 相關檔案則是一樣複製到本模組包的 config 資料夾下。

狀況二：從本模組包 2.0.x 升級到 2.1.0 以上

由於模組包 2.0.x 使用 JourneyMap 模組作為大小地圖方案，因此升級到 2.1.0 以後的版本，就需要進行座標以及地圖檔案轉換。

轉換之前，如果有遊玩本伺服器，請確保自己離線之前，是在主要伺服器而非創造伺服器，否則一登入本伺服器，轉換可能會出問題

前置作業：轉換座標

（可選）訪問 Minecraft 資料夾，將 journeymap 資料夾複製一份出來作為備份

進入 journeymap/data/mp ，查看資料夾內的所有資料夾，可能會看到類似 伺服器地址_UUID 格式的名稱

點進去相關資料夾內，底下有 waypoints 資料夾，請確保裡面的座標資料是你要的

記住伺服器地址_UUID 資料夾的名稱

下載 JMWaypointsToXaero 的 jar 檔案，並將它放在妥善的位置

輸入以下指令進行轉換

java -jar JMWaypointsToXaero-1.1.jar "<舊 Minecraft 資料夾的位置>/journeymap/data/mp/<伺服器地址_UUID資料夾>" "<新 Minecraft 資料夾的位置>/XaeroWaypoints/Multiplayer_<伺服器地址>"

舉例來說，我遊玩伺服器的地址為 mc.nesquate.tw， JournayMap 的 伺服器地址_UUID 類似名稱的資料夾為 mc~nesquate~tw_f4f41a7e~6b0e~45ff~b861~28f2ed503cb7，新舊 Minecraft 資料夾的位置我都知道，則完整範例可以長成這樣：

java -jar JMWaypointsToXaero-1.1.jar "/home/nesquate/文件/journey_convert/journeymap/data/mp/mc~nesquate~tw_f4f41a7e~6b0e~45ff~b861~28f2ed503cb7" "/home/nesquate/.local/share/PrismLauncher/instances/Lazy Modpack (main edge)/.minecraft/XaeroWaypoints/Multiplayer_mc.nesquate.tw"

如果還是不清楚，建議尋求協助。

以上這樣就轉換完畢了，但在遊戲內還要再進行設定才可以正常使用。