遊戲靜態檔案指南

遊戲靜態檔案是 App 用來顯示與判斷遊戲內容的資料，例如道具、NPC、技能、場景與對話。這些檔案不是登入帳號資料，而是要放在 FloatPilot.App 的 data 資料夾中，讓 App 啟動時載入。

重要：當伺服器新增道具、NPC、技能或其他遊戲內容時，請同步更新 App 的靜態檔案。若沒有更新，App 可能看不到新內容，或出現道具、NPC、技能名稱與資料顯示錯誤。

快速開始

關閉 FloatPilot.App。
找到遊戲客戶端的 data 資料夾。例如：C:\Program Files\980x\WLROnline 內的 data。
依照語系，把檔案放入 FloatPilot.App 的 data\zh-TW、data\en-US 或其他對應語系資料夾。
把共用檔案放入 FloatPilot.App 的 data\common。
確認檔名與副檔名完全正確，不要多包一層資料夾。
重新開啟 FloatPilot.App，完成會員授權後再確認資料是否正常顯示。

檔案應該放在哪裡

語系資料夾

從遊戲客戶端 data 資料夾取得以下檔案，放到 FloatPilot.App 對應的語系資料夾：

檔案	主要用途
`Item.dat`	道具名稱、道具資料與道具相關判斷。
`Npc.dat`	NPC 名稱與 NPC 資料。
`Skill.dat`	技能名稱與技能資料。
`SceneData.dat`	場景與地圖相關資料。
`Talk.dat`	NPC 對話與文字資料。

例如使用繁體中文資料時，檔案應放在：

FloatPilot.App\data\zh-TW\Item.dat
FloatPilot.App\data\zh-TW\Npc.dat
FloatPilot.App\data\zh-TW\Skill.dat
FloatPilot.App\data\zh-TW\SceneData.dat
FloatPilot.App\data\zh-TW\Talk.dat

若使用英文資料，將同一組檔案放入 data\en-US；若使用簡體中文資料，放入 data\zh-CN。App 會依「靜態資料語言」設定選擇資料；若指定語系資料不完整，會嘗試使用完整的 en-US 資料。

共用資料夾

以下檔案不依語系區分，請放入 FloatPilot.App\data\common：

檔案	主要用途
`eve.Emg`	NPC、事件、互動與遊戲流程共用資料。
`Ground.MMG`	地圖與地面相關共用資料。

完整路徑範例：

FloatPilot.App\data\common\eve.Emg
FloatPilot.App\data\common\Ground.MMG

更新伺服器內容後要做什麼

只要伺服器新增或修改下列內容，就應重新準備靜態檔案：

新增道具或修改道具名稱、能力。
新增 NPC 或修改 NPC 資料。
新增技能或修改技能名稱、效果資料。
新增地圖、場景或地面資料。
新增 NPC 對話、任務文字或事件文字。
更新 eve.Emg 內的 NPC、事件與互動資料。

請從目前使用的遊戲客戶端 data 資料夾取得最新檔案，再覆蓋到 App 對應位置。不要只更新其中一個檔案，避免不同檔案來自不同遊戲版本。

複製時的注意事項

檔案要直接放在對應的語系資料夾或 common，不要放成 data\zh-TW\data\zh-TW。
檔名請保留原本大小寫與副檔名，例如 Item.dat，不要改成 Item.dat.dat。
Item.dat、Npc.dat、Skill.dat、SceneData.dat、Talk.dat 必須放在語系資料夾，不要放進 common。
eve.Emg、Ground.MMG 必須放在 common，不要放進語系資料夾。
所有檔案應來自同一份遊戲客戶端版本，避免資料互相不相容。
覆蓋檔案前請先關閉 FloatPilot.App，避免 App 仍持有舊檔案內容。

常見問題與排錯

App 看不到新道具、NPC 或技能

先關閉 App，確認最新檔案已放到正確的語系資料夾，然後重新啟動。若「靜態資料語言」設定不是你更新的語系，App 可能仍讀取另一個資料夾。

畫面顯示未知道具或名稱錯誤

通常是 Item.dat 不完整、版本太舊，或檔案放錯語系資料夾。請使用同一份遊戲客戶端的完整檔案重新覆蓋。

NPC、技能或對話顯示錯誤

請確認 Npc.dat、Skill.dat、Talk.dat 與共用資料 eve.Emg 都已更新，而且來自同一遊戲版本。只更新其中一個檔案可能造成資料對不上。

App 顯示靜態資料不完整

請檢查目前資料語系資料夾是否包含 Item.dat、Npc.dat、Skill.dat、SceneData.dat、Talk.dat，並檢查 data\common 是否包含 eve.Emg、Ground.MMG。

我把檔案放進去了，但 App 還是讀不到

確認檔案位於 FloatPilot.App 實際執行目錄下的 data，不是專案根目錄、遊戲資料夾或另一份舊安裝目錄。Debug 與 Publish 的 App 也可能使用不同的執行目錄，請以目前啟動的 App 所在資料夾為準。

最後檢查清單

FloatPilot.App 已關閉。
語系檔案已放入正確的 data\en-US、data\zh-TW 或 data\zh-CN。
語系資料夾包含 Item.dat、Npc.dat、Skill.dat、SceneData.dat、Talk.dat。
eve.Emg 與 Ground.MMG 已放入 data\common。
檔案沒有多包一層資料夾，也沒有被改名。
所有檔案來自同一份遊戲客戶端版本。
已依目前 App 的「靜態資料語言」選擇正確語系。
App 已重新啟動並確認道具、NPC、技能與文字顯示正常。