天堂私服 | GM指令分析 (召回玩家)「L1J版」

章節用意

recall的指令，此指令用於將指定玩家或是全部玩家召回GM的位置，常見應用在伺服器維修前將所有玩家召回到主城。

核心版本

L1J-3.80c

前言

在開始分析前，請務必先將以下文章閱讀完畢。

GM指令分析 (移動)
- 了解傳送的行為。

分析

效果：召回玩家。
範例：

1 2	.recall ${角色名稱} .recall all

1.分析資料表：
- 先進入commands表，找到recall的指令。
- class_name是L1Recall。
2.指令的分析：
- 啟動模擬器除錯模式，並啟動天堂遊戲登入兩個帳號。
  1
  2
  線上GM
  路人甲
- 並將兩個人物移動至不一樣的地方。(不同畫面即可)
- 使用召回玩家的GM指令。
  1
  .recall all
3.分析程式碼：
- 透過搜尋L1ToPC開啟程式碼。
  1
  src/l1j/server/server/command/executor/L1ToPC.java
  註：程式碼內的L1Teleport的teleport方法，已於GM指令分析 (移動)分析完畢，此處將不再分析。
- 36~48行，判斷輸入的參數是否為all。
  - 如為all，則使用L1World.getInstance().getAllPlayers()取得所有在線的玩家。
  - 不為，則將輸入的參數L1World.getInstance().getPlayer(arg);帶入找尋取得玩家。
- 50~57行，主要處理召回的處理。
- 主要54是，L1Teleport的teleportToTargetFront方法。
- 輸入的參數為目標玩家、GM、距離。
- Ctrl鍵壓住，再左鍵點擊teleportToTargetFront方法即會開啟跳轉到物件與方法位置。
- 100~104行，根據GM的參數資訊取得，X座標、T`座標、面向。
- 107~147行，根據面向加減距離參數X和Y座標為被召回的位置。
  
  說明：面向 0.左上 1.上 2.右上 3.右 4.右下 5.下 6.左下 7.左
- 149~156行，最後呼叫L1Teleport的teleport方法。
  
  註：程式碼內的L1Teleport的teleport方法，已於GM指令分析 (移動)分析完畢，此處將不再分析。
- 或許有注意到兩段判斷的程式碼
  1
  2
  cha instanceof L1PcInstance
  cha instanceof L1NpcInstance
- 第一個判斷被召回的目標是玩家？
  - 這很明顯就是用在這個指令中使用。
- 第二個判斷為被召回的目標是NPC？
  - 初步分析”可能”是被用在寵物或是召喚的怪物；或是怪物召喚的小怪所使用。