FloatPilot 使用說明

FloatPilot 遠端操控使用手冊

給第一次使用遠端操控的人：你不需要懂程式設計，只要把這份文件當成「可以在遊戲聊天欄輸入的遙控指令說明書」即可。

先看結論

目前 FloatPilot 內建 8 個 /fp 遠端指令：

指令 用途 需要參數
/fp getplayerid 回傳主控角色與被控角色的 PlayerId 不需要
/fp status 要求目前角色做一次狀態查詢 不需要
/fp map <地圖ID> 導航到指定地圖 需要 1 個數字地圖 ID
/fp record0 傳送到重生點 不需要
/fp carine 傳送到遊樂場（Carine） 不需要
/fp beach 傳送到新手海灘 不需要
/fp reconnect <等待時間> 立即離線，等候指定時間後持續嘗試重連 需要 1 個帶 s、m 或 h 的時間
/fp exit 讓被控端執行正常退出流程 不需要

最常用的範例是：

/fp status
/fp record0
/fp carine
/fp beach
/fp map 12345
/fp reconnect 10m

重要觀念：誰控制誰？

遠端操控會有兩個角色：

  1. 被控角色：正在 FloatPilot App 中登入、準備被操作的角色。
  2. 主控角色：在遊戲內發送 /fp ... 聊天指令的角色。

主控角色的 PlayerId 必須先加入被控角色的「遠端控制 PlayerId 白名單」。沒有加入白名單時，指令不會執行。

所有程式已支援的聊天頻道都可以傳送遠端指令，不限密語。PlayerId 白名單是唯一的遠端操控授權條件；不在白名單內的角色，即使輸入正確指令也不會執行。公共頻道比較容易讓其他人看到指令內容，因此日常操作仍可優先使用密語／私聊。

第一次設定：讓某個角色可以控制另一個角色

以下假設「主控角色」要控制「被控角色」。

1. 先準備主控角色的 PlayerId

PlayerId 是遊戲用來辨識角色的數字，不是角色名稱，也不是帳號名稱。

請先從遊戲或 FloatPilot 已有的角色／玩家資訊中找到主控角色的 PlayerId。只要輸入正整數即可，例如：

123456

2. 在被控角色開啟遠端控制設定

在 FloatPilot App 中：

  1. 開啟被控角色的設定視窗。
  2. 找到「遠程控制／遠端指令控制 PlayerId 白名單」區塊。
  3. 在輸入框貼上主控角色的 PlayerId。
  4. 按「加入白名單」。
  5. 按「套用並儲存」。

加入後，白名單列表中應該會看到該 PlayerId。若要取消授權，點選列表中該 PlayerId 的刪除按鈕，再儲存設定。

3. 用安全指令測試

請先讓主控角色對被控角色發送：

/fp status

被控角色本機的系統訊息應該會顯示狀態查詢已完成，或顯示角色尚未初始化。測試成功後，再使用傳送或導航指令。

指令詳細說明

/fp getplayerid

用途： 查詢「這次發送指令的主控角色」的 PlayerId。

輸入：

/fp getplayerid

目前實際行為： 被控角色會在聊天 TAB 的 SYS 訊息顯示自己的角色名稱與 PlayerId，並透過密語回覆主控角色的角色名稱與 PlayerId。例如：

  • 被控端 SYS：被控角色 playerId是 67890
  • 主控端密語：主控角色 playerId是 123456

適合場景： 初次設定遠端控制白名單時，一次取得主控角色與被控角色的 PlayerId。

/fp status

用途： 要求被控角色執行一次狀態查詢。

輸入：

/fp status

目前實際行為：

  • 角色已初始化：被控角色本機顯示「狀態查詢已完成」。
  • 角色尚未初始化：被控角色本機顯示「角色尚未初始化，無法取得狀態」。

目前 FloatPilot 雖然會建立角色狀態摘要，但遠端回覆使用的是簡短的完成訊息，不會把完整的等級、地圖、座標、HP、SP、戰鬥統計等數值直接傳給主控角色。

/fp map <地圖ID>

用途： 讓被控角色從目前位置開始自動尋路，前往指定地圖。

輸入格式：

/fp map 12345

把 12345 換成真正的數字地圖 ID。地圖 ID 必須是 1 到 65535 之間的正整數；不能輸入地圖名稱。

什麼叫做成功？

看到「遠端指令已接受」只代表導航流程已成功啟動，不代表角色已經抵達目的地。請等角色抵達後，再發送下一個移動指令。

可能無法執行的原因：

  • 目前角色不存在或尚未完成登入。
  • 角色正忙碌、正在戰鬥、傳送或執行其他不能中斷的動作。
  • 找不到目前地圖到目標地圖的路線。
  • 途中需要水上／空中交通工具，但交通工具準備失敗。
  • 角色目前騎乘交通工具，某些傳送行為會被阻擋。

/fp record0

用途： 傳送到角色的重生點。

輸入：

/fp record0

這是「紀錄點」類型的傳送，不是一般長途尋路。角色若正在騎乘交通工具、忙碌中，或目前規則禁止回重生點，指令可能不會執行。

/fp carine

用途： 傳送到遊樂場。

輸入：

/fp carine

這是固定的紀錄點傳送，不需要輸入地圖 ID。若角色正在執行不可中斷的動作，可能會收到「目前無法執行」的系統訊息。

/fp beach

用途： 傳送到新手海灘。

輸入：

/fp beach

這是固定的紀錄點傳送，不需要輸入地圖 ID。若角色正在騎乘交通工具或忙碌中，可能會被拒絕。

/fp reconnect <等待時間>

用途： 立即讓被控角色離線，等待指定時間後開始自動重連。

輸入範例：

/fp reconnect 30s
/fp reconnect 10m
/fp reconnect 2h

等待時間必須是「一個整數＋一個單位」，單位不分大小寫：

  • s 代表秒，例如 30s。
  • m 代表分鐘，例如 10m。
  • h 代表小時，例如 2h。
  • 最短 5s，最長 24h，兩個邊界都可以使用。

不能只寫 /fp reconnect 10，也不能使用 1.5m、負數、零或額外參數。

執行後會發生什麼事？

看到「遠端重連排程已建立」時，代表排程建立成功，而且角色已完成立即離線；這不是「已經重新連線成功」的通知。被控端本機通常會先顯示已排入重連，再顯示排程建立完成。

  1. 指令通過白名單與格式檢查後，被控角色立即離線。
  2. 第一次重連會精確等待你指定的時間，不額外加入隨機延遲。
  3. 若第一次連線失敗，FloatPilot 會繼續重試；後續重試使用系統既有的漸進等待與少量隨機延遲，避免一直快速撞伺服器。
  4. 即使設定中的「自動重連」已關閉，這個明確下達的遠端重連指令仍會執行。

再次送出新的 /fp reconnect ... 會取代舊排程。使用者在被控端手動斷線或關閉 App 時，排程會取消。角色離線期間收不到新的聊天指令，因此沒有提供遠端 /fp reconnect cancel。

/fp exit

用途： 讓被控端執行正常退出流程。

/fp exit

這個指令沒有參數，而且會結束被控端目前流程。請只在確定不需要繼續操作時使用；它和 /fp reconnect ... 不同，不會安排稍後自動重連。

指令輸入規則

大小寫不分

指令名稱不分大小寫，以下都會被當成同一個指令：

/fp status
/FP STATUS
/Fp Status

不過為了好讀和避免遊戲聊天系統額外處理，建議固定使用小寫。

/fp 後面要有空格

正確：

/fp status

不正確：

/fpstatus

map 與 reconnect 各需要一個參數

正確：

/fp beach
/fp map 12345
/fp reconnect 10m

錯誤：

/fp beach now
/fp status please
/fp map
/fp map abc
/fp map 0
/fp reconnect
/fp reconnect 10
/fp reconnect 1.5m
/fp reconnect 10m extra

/fp map 必須剛好接一個有效地圖 ID；/fp reconnect 必須剛好接一個 5s 到 24h 的等待時間。其他指令都不接受額外參數。

白名單比指令內容更早檢查

主控角色不在白名單時，即使指令拼字正確也不會執行。對一般錯誤指令，程式也不會特別回覆未授權訊息，避免把授權狀態暴露給其他玩家。

常用場景

場景一：主控角色叫醒一個正在待機的角色

  1. 確認主控 PlayerId 已在被控角色白名單中。

  2. 發送：

    /fp status

  3. 確認被控角色的 App 有收到系統訊息。

  4. 再發送真正要做的動作，例如：

    /fp record0

場景二：把角色送回重生點

/fp record0

這適合角色需要離開目前練功地點、回到重生點重新整理的情況。收到「已接受」後請等待傳送完成，不要立刻連續發送另一個傳送指令。

場景三：切換到固定地點

遊樂場：

/fp carine

新手海灘：

/fp beach

這兩個指令不需要知道地圖 ID，適合日常往返固定地點。

場景四：前往指定地圖

/fp map 12345

適合你已經知道目的地地圖 ID，並且程式希望自動規劃路線的情況。這是「開始導航」，不是瞬間完成傳送；跨多張地圖時需要等待每一步完成。

場景五：讓無人值守的角色稍後重新連線

/fp reconnect 10m

被控角色會立即離線，10 分鐘後開始重連。若伺服器仍不可用，程式會持續重試，不需要再遠端補送指令。請注意：送出後角色已離線，無法再從遊戲聊天取消；若要取消，必須在被控端手動斷線或關閉 App。

場景六：撤銷某位主控者的權限

  1. 在被控角色的遠端控制白名單中找到該 PlayerId。
  2. 點擊刪除。
  3. 按「套用並儲存」。
  4. 該角色之後再發送 /fp ... 就不會再被執行。

場景七：想一次連續移動多個地點

不建議把多個傳送指令快速連發，例如：

/fp record0
/fp carine
/fp map 12345

正確做法是每次只發一個指令，確認前一個動作已完成、角色已恢復可行動，再發送下一個指令。FloatPilot 的「已接受」只代表動作啟動，並不是抵達通知。

收到錯誤時怎麼辦？

完全沒有反應

依序檢查：

  1. 指令是否以 /fp 開頭，且 /fp 後面有空格。
  2. 主控角色的 PlayerId 是否已加入被控角色白名單。
  3. 白名單變更後是否按了「套用並儲存」。
  4. 是否真的由白名單內的那個角色發送。
  5. 被控角色是否仍保持登入和連線。
  6. 優先改用密語／私聊發送，避免公共頻道混入其他文字。

顯示指令或參數格式錯誤

程式會依問題顯示「遠端指令缺少指令名稱」、「未知的遠端指令」、「參數數量錯誤」、「地圖 ID 必須是 1 到 65535 的整數」或「重連等待時間格式錯誤」等訊息。先對照本手冊的指令表，尤其檢查：

  • /fp map 後面是否有地圖 ID。
  • 地圖 ID 是否為 1 到 65535 的正整數。
  • /fp reconnect 是否只有一個整數時間，並帶有 s、m 或 h 單位。
  • 重連時間是否在 5s 到 24h 之間。
  • status、beach、carine、record0 後面是否不小心多打了文字。

顯示「目前無法執行」

代表指令格式大致正確，但程式當下沒有成功啟動世界動作。請先讓角色停止戰鬥、傳送、商店／NPC 對話或其他忙碌流程，等幾秒後再試。若是 /fp map <地圖ID>，也要確認目前地圖確實有可用路線。

主控者看不到回覆

/fp getplayerid 會透過密語回覆主控角色；其他遠端指令的處理結果主要寫入被控角色本機的系統聊天／訊息區。如果主控者沒有收到 getplayerid 回覆，請確認被控角色仍在線、主控 PlayerId 已加入白名單，且主控角色名稱仍可在被控端的線上玩家列表中辨識。

目前沒有提供的遠端指令

目前 FloatPilot 的 /fp 指令清單只有本手冊列出的 8 個項目。以下類型目前不是已註冊的 /fp 指令：

/fp help
/fp start
/fp stop
/fp walk
/fp battle
/fp item
/fp npc

這些文字不代表未來不能增加，而是目前直接輸入時不會被現有 FloatPilot 遠端指令表接受。

一頁速查表

# 回傳主控者與被控者雙方 PlayerId
/fp getplayerid

# 查詢角色狀態（目前只回報查詢完成，不傳完整統計）
/fp status

# 自動尋路到指定地圖 ID
/fp map 12345

# 固定地點傳送
/fp record0
/fp carine
/fp beach

# 立即離線，10 分鐘後開始持續重連
/fp reconnect 10m

# 正常退出（不會自動重連）
/fp exit