LegacyScriptEngine API:網絡與系統
LSE 插件中有沒有辦法獲取玩家是通過哪個 IP 進入服務器的?
可以,通過玩家的設備信息對象獲取:player.getDevice().ip(Device 對象的 ip 屬性)。
注意:若服務器經過 frp 等內網穿透 / 代理,拿到的會是穿透客戶端的地址(如 127.0.0.1),而不是玩家真實 IP。
適用版本:LSE 當前所有版本(含 v0.23.1)
LSE 插件如何實現自動更新自身?
可以定時檢查更新(如用 network.httpGet 請求版本信息),發現新版本後先下載到本地並覆寫插件自身文件,再通過 mc.runcmdEx 執行 LeviLamina 的重載命令(如 ll reload <插件名>)重載自己。不建議每次加載時從網絡拉取代碼再 eval 執行。
適用版本:LeviLamina + LSE 當前版本
LSE 有獲取服務器公網 IP 的接口嗎?
沒有專門的接口(LSE 只有玩家 / 設備的 ip 屬性,如 pl.getDevice().ip)。可以用 LSE 的網絡接口 network.httpGet(url, callback) 請求外部 IP 查詢服務(如 https://ip.sb、https://4.ipw.cn)獲取公網 IP;Node.js 插件也可以用 Node 的網絡庫實現。
適用版本:LSE 當前所有版本
LSE 的 BinaryStream 中 writeVec3 應該傳什麼參數?和連續調用三次 writeFloat 有區別嗎?
writeVec3 需要傳一個 FloatPos,實現上就是依次 writeFloat 寫入 x、y、z,與連續調用三次 writeFloat 等價。
LSE 的 Node.js 插件之間能共享內存嗎?Node 插件想在服務器啟動完成後通知外部前端程序,有什麼辦法?
不能直接共享內存,LSE 為每個 Node.js 插件做了執行環境隔離。插件之間需要互相調用時可用 ll.exports / ll.imports(遠程函數調用)。與外部程序通信建議走網絡:在 onServerStarted 事件裡通過 HTTP 請求(network.httpGet / httpPost 或 Node 自帶 http 模塊)或 WebSocket(LSE 的 WSClient,或 npm 的 ws 包)通知外部程序;需要監測服務器存活時可以用 WebSocket 定時心跳,超時即判定服務器掛掉。用文件交互不如網絡方式可靠。有用戶反饋 process.send 不可用。
適用版本:當前版本(Node.js 引擎)
在 LSE 的 JS 腳本插件裡,能否讓玩家進服時一直停留在“正在加載資源”階段、幾乎不下發數據包,等某個 Promise 返回後再決定是否放行進服?
腳本插件做不到在登錄/加載資源階段掛起玩家連接、阻止下發數據包的控制(onPreJoin 等事件回調是同步的,只能當場決定是否攔截,不能等待 Promise)。需要用 C++ mod 自行 hook 網絡/登錄流程實現。
在 LSE 中用 BinaryStream 構建 AddActor 數據包再 createPacket 發送失敗/報參數錯誤,為什麼?用 sendNetworkPacket 符號能解決嗎?
bs.createPacket(pktid) 默認會先創建對應類型的包對象,再從 BinaryStream 中 read 解析校驗,部分包(如 AddActor)用自行拼接的數據解析會失敗。LSE 0.19.1 起可用 bs.createPacket(pktid, true) 創建原始網絡數據包,直接把當前流中的字節作為包體發送,不再經過解析,然後用 pkt.sendTo(player) 或 player.sendPacket(pkt) 發送。?sendNetworkPacket@Player@@UEBAXAEAVPacket@@@Z 與 player.sendPacket 本質相同,換用它不能解決問題。另外在 JS 字符串中寫符號時反斜槓需要轉義,或使用 String.raw。
適用版本:LegacyScriptEngine 0.19.1 及以上(raw 參數);更早版本無法用 createPacket 發送 AddActor
在服務端修改了地圖畫(物品展示框裡地圖)的 NBT 或 mapid 對應的像素數據後,客戶端畫面不刷新,如何讓客戶端看到更新?
服務端數據其實已經改了,只是沒有給客戶端發更新包。地圖數據由客戶端發送 MapInfoRequestPacket(mMapId、mClientPixels)請求,服務端以 ClientboundMapItemDataPacket 回傳;UpdateBlockActorPacket 只告訴客戶端展示框裡的地圖 id。地圖 id 不變、只改數據時,可發一個 UpdateBlockPacket 觸發方塊更新,讓客戶端重新請求地圖數據(用命令方塊 clone、structure 重新加載或 pl.refreshChunks() 也能強制刷新,但會有閃爍)。LSE 可以用 pl.sendPacket 直接發包,不過需要手寫 BinaryStream,協議可參考 https://mojang.github.io/bedrock-protocol-docs/html/packets.html。注意每次更新都會發給所有玩家,會佔用帶寬。
適用版本:LSE / LeviLamina 當前版本(發包細節依賴 BDS 協議)。未能從源碼或文檔中直接證實,僅供參考。
基岩版兩個服務器之間如何實現跨服傳送(傳服)?數據能互通嗎?
傳服本身很簡單:LSE 提供 pl.transServer(ip, port);C++ mod 可構造 <mc/network/packet/TransferPacket.h> 中的 TransferPacket(傳入目標 IP 和端口)並通過 player.sendNetworkPacket 發送。但各服數據(包括各插件數據)不會自動互通,需要自行用 MySQL 等共享存儲或文件/WebSocket 中轉來同步。
適用版本:LSE / LeviLamina 當前版本
想寫一個 /ping 命令顯示玩家到服務器的延遲,LSE 或 LeviLamina 有沒有直接獲取玩家延遲的接口?
不用自己在服務端 ping 玩家 IP(拿到的 IP 往往是運營商出口,而且通常禁 ping)。LSE 中直接用 pl.getDevice() 返回的設備信息對象:dv.lastPing(當前延遲 ms)、dv.avgPing(平均延遲 ms),另有 lastPacketLoss/avgPacketLoss 丟包率。C++ mod 開發者可參考 LSE 開源代碼 DeviceAPI.cpp 中這些屬性的實現。
適用版本:LegacyScriptEngine 當前版本
服務器已有自定義進出服提示,如何關閉原版的黃字“xxx 加入/離開了遊戲”提示?LSE 中 mc.listen('onJoin'/'onLeft') 回調 return false 能攔截嗎?
不能用這種方式關掉提示:onLeft 不可攔截;onJoin 雖然 return false 可以攔截,但攔的是玩家進入事件本身而不是那條消息。
可行方法:
- 資源包修改語言文件中的
multiplayer.player.joined/multiplayer.player.left。 - 攔截髮送給客戶端的
TextPacket數據包。LSE 中可藉助第三方 ila-lseexport(導出 iListenAttentively 事件)監聽數據包發送事件並攔截。C++ mod 中可依賴 iListenAttentively 的SendPacketBeforeEvent:if (event.packet().getId() == MinecraftPacketIds::Text) event.cancel();(再按文本內容過濾)。
適用版本:LegacyScriptEngine / iListenAttentively 當前版本
用 LSE 發包做假箱子(fake chest)查包界面時,打開大箱子(雙箱)會瞬間關閉,怎麼解決?
客戶端打開容器界面時要求對應座標處存在箱子方塊,否則界面會立刻關閉。需要先向該玩家發送假的箱子方塊(大箱子需要兩個相鄰且已配對的箱子),通常生成在玩家頭頂附近,再發送 ContainerOpenPacket 打開界面。LSE 可用 BinaryStream 構造數據包並通過 pl.sendPacket(packet) 發送。可參考社區示例:https://github.com/Cdm2883/code-snippets/blob/vscode/LLSE/FakeChestLLSE/fake-chest.llse.js
適用版本:當前版本(依賴客戶端行為與具體協議版本)。未能從源碼或文檔中直接證實,僅供參考。
能否讓某個玩家頭頂的文字(名稱標籤/懸浮字)只對特定玩家單方面可見?
可以。原理是隻給目標玩家發送修改實體名稱/元數據的數據包(如 SetActorDataPacket),其他玩家收不到該包就看不到。在 LSE 中可用 Packet API 構造數據包(new BinaryStream() 寫入數據後 bs.createPacket(pktid)),再用 pl.sendPacket(packet) 只發給指定玩家;也可以藉助其他提供發包/懸浮字接口的前置插件實現。注意 Packet API 需當前版本可用,且數據包結構隨 BDS 協議版本變化,需按當前協議構造。
適用版本:LegacyScriptEngine 當前版本
LSE 中 network.httpGet() 的返回狀態碼一直是 -1,但同一 URL 在瀏覽器能正常訪問,是什麼原因?
狀態碼 -1 表示請求本身失敗(沒有拿到任何響應)。先打印拼出來的 URL 確認是否正確,並檢查請求參數和服務端;有用戶遇到是域名解析失敗導致的,改用 IP 訪問即可。也可以用 curl 測試,或在 Node.js 插件裡改用其他 HTTP 庫發請求。