NMS Fake Player

目的

建立「真的 ServerPlayer、但沒有客戶端」的假玩家。傷害、暴擊、擊退、舉盾、走路與跳台階都走原版邏輯，呼叫端只需每 tick 餵輸入與轉頭。

---

平台需求

• Paper 1.21.11 / 26.2（兩版皆經編譯驗證；版本差異以行尾 // @1.21.11: 標註）
• Paperweight userdev
• Java 21（1.21.11）／25（26.2）

---

產生的代碼

FakePlayer.java（只在 nms/ 套件）

FakePlayer bot = FakePlayer.spawn(location, "Steve_Bot", challenger);
bot.clearSpawnInvulnerability();

// 每 tick（主執行緒）
bot.look(yaw, pitch);
bot.input(1f, 0f, false, true);   // 前進 + 疾跑
bot.attack(target);               // 原版近戰
bot.tick();

BotService.java（Bukkit 端）

public Optional<Player> spawn(Location at, String name, Player skinFrom) {
    if (!available) return Optional.empty();
    try {
        FakePlayer bot = FakePlayer.spawn(at, name, skinFrom);
        bots.add(bot);
        return Optional.of(bot.bukkit());
    } catch (LinkageError e) {   // Paper build 改了簽名：只停用 bot
        disable(e);
        return Optional.empty();
    }
}

---

關鍵做法

• EmptyConnection：丟掉送往假玩家的封包，只保留自己的擊退速度，下一 tick 套用
• 不走 PlayerList 登入流程：不觸發 PlayerJoinEvent、不在 tab 與 getOnlinePlayers()
• 生成前對所有人送玩家資訊（listed=false），新上線玩家補送
• 覆寫 isClientAuthoritative() 讓伺服器計算物理
• 建構與移除時拆掉成就監聽，避免記憶體洩漏

---

執行緒安全

• 所有操作只能在主執行緒；tick() 每個伺服器 tick 呼叫一次