遊戲版本指南

「遊戲版本」是協助 FloatPilot 讀懂你目前遊戲版本的小工具。實際執行的檔案名稱是 FloatPilot.VersionExtractor.exe，它會從遊戲資料夾讀取 aLogin.exe 與 data\Item.Dat，自動分析登入版本與資料檔大小，產生 version.ini。

重要：請先以「系統管理員身分執行」開啟 FloatPilot.VersionExtractor.exe。若沒有系統管理員權限，Windows 權限控管或安全性工具可能會阻擋程式讀取遊戲檔案。App 登入時也需要正確的遊戲版本資訊；若 version.ini 不存在、放錯位置或內容與遊戲不符，可能會出現版本不符、資料檔版本不符，或無法順利登入遊戲。

為什麼 App 登入需要它

FloatPilot.App 登入遊戲時，不只需要遊戲帳號、密碼與伺服器，還需要知道遊戲客戶端使用哪一組登入版本資料。這些資訊由 version.ini 提供。

你不需要自己猜 Header、Version 或 ItemDatSize 的數字。VersionExtractor 會直接從你實際使用的遊戲檔案分析，降低手動填錯的機會。

簡單來說，登入流程會是：

VersionExtractor 讀取你的遊戲檔案。
工具產生與該遊戲版本相符的 version.ini。
你把這份檔案放入 FloatPilot.App 的 configs 資料夾。
App 登入時讀取版本資訊，才能使用正確的登入與資料版本。

快速開始

找到遊戲主程式資料夾，也就是同時有 aLogin.exe 與 data\Item.Dat 的資料夾。
將 FloatPilot.VersionExtractor.exe 複製到這個遊戲資料夾。
在遊戲資料夾內對 FloatPilot.VersionExtractor.exe 按右鍵，選擇「以系統管理員身分執行」。
等待畫面顯示版本分析成功。
開啟該遊戲資料夾內的 configs 資料夾，找到 version.ini。
複製 version.ini。
找到 FloatPilot.App 安裝位置，再開啟裡面的 configs 資料夾。
將 version.ini 貼到 FloatPilot.App 的 configs 資料夾；若詢問是否取代，請選擇取代。
如果 FloatPilot.App 已經開啟，請完全關閉後重新啟動。
在遊戲帳號登入畫面重新整理版本群組，選擇正確的版本設定。

工具需要哪些檔案

檔案或資料夾	用途
`FloatPilot.VersionExtractor.exe`	分析遊戲版本並產生 `version.ini`。
`aLogin.exe`	工具從中分析登入用的 Header 與 Version。
`data\Item.Dat`	工具讀取實際檔案大小，寫入 `ItemDatSize`。
遊戲資料夾內的 `configs\version.ini`	VersionExtractor 的分析輸出。
FloatPilot.App 內的 `configs\version.ini`	App 登入時實際讀取的版本設定。

工具必須放在遊戲根目錄執行，不是桌面、下載資料夾，也不是 FloatPilot.App 的安裝資料夾。判斷位置的方式是：該資料夾裡應該看得到 aLogin.exe 與 data\Item.Dat。

產生的版本資訊

VersionExtractor 會依遊戲資料夾名稱建立設定區段，並寫入以下資料：

設定	白話說明
`Header`	遊戲登入封包使用的版本識別。
`Version`	遊戲登入版本號。
`ItemDatSize`	目前 `data\Item.Dat` 的實際大小，協助確認資料檔版本。

複製到 App 後，遊戲帳號登入畫面的「版本群組」會顯示可選設定。顯示名稱會包含設定區段、Header、Version 與 Item 大小，請選擇與目前遊戲檔案相符的項目。

什麼時候需要重新執行

遇到以下情況時，請在更新後的遊戲資料夾重新執行 VersionExtractor，並再次複製新的 version.ini 到 App：

遊戲客戶端更新過。
aLogin.exe 被替換過。
data\Item.Dat 被更新或更換過。
App 顯示版本不符或資料檔版本不符。
版本群組裡沒有對應目前遊戲的設定。

不要沿用舊遊戲目錄產生的檔案；每次應以目前實際登入的遊戲資料夾重新分析。

常見問題與排錯

執行後說找不到必要檔案

請確認工具與 aLogin.exe 放在同一個遊戲根目錄，並確認 data\Item.Dat 存在。若從桌面或下載資料夾直接執行，通常會找不到遊戲檔案。

找不到 `version.ini`

請確認工具畫面最後顯示分析成功。成功後，檔案會位於遊戲資料夾的 configs\version.ini。如果沒有，請重新執行工具並確認遊戲資料夾有寫入權限。

App 還是顯示舊版本

請確認檔案貼到 FloatPilot.App 的 configs\version.ini，不是只留在遊戲資料夾。若 App 正在執行，請完全關閉後重新開啟，再重新整理版本群組。

顯示版本不符或資料檔版本不符

請從目前遊戲資料夾重新執行 VersionExtractor，重新複製輸出的 version.ini。不要自行修改數字，也不要使用其他遊戲版本留下的設定檔。

Windows 顯示「已保護您的電腦」

這可能是 Windows 或防毒軟體對未建立信任的工具提出的警告。請先確認檔案來源可信；若確認無誤，再依 Windows 畫面選擇「更多資訊」與「仍要執行」，或將工具加入防毒軟體允許清單。

工具無法寫入 `version.ini`

可能是遊戲資料夾唯讀、沒有寫入權限、防毒軟體阻擋，或磁碟空間不足。請確認資料夾可寫入，必要時以系統管理員身分執行工具。

顯示不支援的 `aLogin.exe`

這通常代表遊戲版本太舊、太新，或檔案不是目前工具支援的官方版本。請先確認遊戲已更新到受支援版本；若仍無法分析，請保留完整錯誤訊息回報。

最後檢查清單

VersionExtractor 與 aLogin.exe 放在同一個遊戲根目錄。
data\Item.Dat 存在且來自目前要登入的遊戲版本。
工具畫面顯示版本分析成功。
已找到遊戲資料夾內的 configs\version.ini。
已將檔案複製到 FloatPilot.App 的 configs 資料夾。
App 已完全關閉並重新啟動。
遊戲帳號登入畫面已選擇正確的版本群組。