LegacyScriptEngine API:數據與文件
LSE 中修改方塊/方塊實體 NBT 後調用 setNbt 沒有效果(如箱子內容、展示框裡地圖的 map_uuid、講臺的 powered_bit),怎麼正確修改?
-
箱子、物品展示框等容器/方塊實體的數據存放在方塊實體(BlockEntity)中,與方塊自身 NBT 分開:應通過
bl.getBlockEntity()拿到方塊實體,用be.getNbt()修改後在方塊實體上調用be.setNbt(nbt),而不是block.setNbt。示例:jslet bl = mc.getBlock(x, y, z, 0); let be = bl.getBlockEntity(); let a = be.getNbt(); let b = a.getTag("Item"); let c = b.getTag("tag"); c.setLong("map_uuid", -14246406442712); b.setTag("tag", c); a.setTag("Item", b); be.setNbt(a); -
修改方塊狀態時注意類型:布爾類狀態(如
powered_bit)在 NBT 中是 Byte(0b/1b),要用setByte('powered_bit', 1)而不是setInt,然後mc.getBlock(pos).setNbt(nbt)。
調試時可用 nbt.toSNBT() 打印查看結構和類型。
適用版本:當前所有 LSE 版本
LSE 中如何創建/處理 ByteArray 類型 NBT(如煙花的 "FireworkFade":[B;...])?new NbtByteArray(Uint8Array.from([15,7,8,...])) 打印出來變成 ASCII 碼([B;49b,53b,44b,...])怎麼辦?
這是 LSE 的實現問題:NbtByteArray 構造函數(以及 set)把傳入的緩衝區按字符串(describeUtf8)逐字符寫入,所以數組 [15,7,8] 被當成文本 "15,7,8" 轉成了 ASCII 碼。可改用 SNBT 在 C++ 層解析:NBT.parseSNBT("{FireworkFade:[B;15b,7b,8b]}") 解析出 compound 後再取出其中的字節數組寫回;當前版本 parseSNBT 基於 CompoundTagVariant::parse,也能直接解析 "[B;15b,7b,8b]" 返回 NbtByteArray(舊版本只支持 compound,需要外面包一層)。處理已有數據時也可以用 toSNBT() 轉為文本修改後再 parseSNBT 寫回。
適用版本:當前 LSE 版本(NbtByteArray 構造問題在 0.23.1 源碼中仍存在)
LSE 中 new JsonConfigFile("/plugins/xxx/config.json") 這種以 / 開頭的路徑為什麼找不到/寫錯位置?
LSE 不會對路徑做特殊處理,原樣交給文件系統。以 / 開頭的是絕對路徑,在 Windows 上等於當前盤符根目錄(如 C:\plugins\...),而不是 BDS 目錄下的 plugins。應使用相對 BDS 根目錄(工作目錄)的路徑,如 new JsonConfigFile("./plugins/xxx/config.json")。
LSE 中如何在玩家名和 UUID 之間互相查詢?
由玩家名查 UUID:data.name2uuid(name)。由 UUID 查玩家名:LSE 沒有 data.uuid2name,可用 data.fromUuid(uuid) 取得玩家信息對象 {xuid, name, uuid},再取其 name(返回 null 表示查詢失敗)。同類還有 data.name2xuid / data.xuid2name / data.xuid2uuid / data.fromName / data.fromXuid / data.getAllPlayerInfo(fromUuid 等為 0.8.13 新增)。
適用版本:LSE 0.8.13 及以上
LSE 中如何構造表示整型數組的 NbtList?
用 NbtInt 元素構造 NbtList,例如 new NbtList([new NbtInt(1), new NbtInt(2)])。數組中的元素需為同一種 NBT 類型對象,不能直接傳 JS 數字。
LSE 中如何統計服務器所有玩家的 UUID 數量?
LSE 自帶 data.getAllPlayerInfo(),返回所有已記錄玩家的 {name, xuid, uuid} 數組,可在控制台執行:jsdebug 進入調試後運行 data.getAllPlayerInfo().length(只包含服務器安裝 LeviLamina 後進入過的玩家)。
若已安裝 GMLib 及 GMLib-LegacyRemoteCallApi,也可用 ll.imports("GMLIB_API", "getAllPlayerUuids")().length(第三方插件接口,需對應第三方插件)。
LSE 中如何讀取箱子等方塊的 NBT(例如是否為大箱子、配對座標)?用方塊 NBT 讀不到相關數據怎麼辦?NBT 能當 JSON 用嗎?
箱子這類數據存在方塊實體(BlockActor)裡,而不是方塊(Block)本身,應讀取方塊實體的 NBT:block.getBlockEntity().getNbt()(先判斷 block.hasBlockEntity())。調試時可用 .toSNBT() 轉成字符串打印。
NBT 不是 JSON,存取時應使用 toSNBT() / NBT.parseSNBT(),不要 toObject() 後再轉 JSON 存儲(會丟失類型信息);只讀不寫時 toObject 比較方便;追求性能可用二進制 NBT 序列化(toBinaryNBT / NBT.parseBinaryNBT),比解析 SNBT 更快。
另:BlockActor 並不繼承 Actor。
適用版本:LSE 當前所有版本
LSE 插件裡把物品 NBT 轉成字符串(SNBT)後用 JSON.parse() 解析報錯,怎麼辦?
SNBT 不等於 JSON,不能用 JSON.parse 解析 nbt.toSNBT() 的結果。應直接使用 LSE 的 NBT 對象 API(如 NbtCompound 的 comp.getTag(key)、comp.getData(key))讀取和修改;如確需普通 JS 對象,可用 comp.toObject()。
適用版本:當前所有 LSE 版本
LSE 文檔裡找不到 File.readFrom 等 API(文件系統頁面鏈接失效),這些 API 還存在嗎?
API 仍然存在,只是文檔站遷移過。文件相關 API 見 https://levimc.org/zh-Hant/LegacyScriptEngine/apis/SystemAPI/File/。File.readFrom(path[,isBinary]) 仍可用(0.19.1 起支持 isBinary 參數)。
發現文檔遺漏可向 LiteLDev/liteldev.github.io 倉庫(docs/LegacyScriptEngine/content)提交 PR。
LSE 有沒有統一的配置文件接口?LeviLamina 提供默認的配置目錄嗎?
LSE 中一般使用 new JsonConfigFile(path[,default]),path 由開發者自己決定,可選的 default 是文件不存在時寫入的默認內容。
C++ 層面 LeviLamina 為 mod 提供默認目錄:config、data、lang(Mod::getConfigDir / getDataDir / getLangDir)。沒有完全由加載器託管的統一配置機制。
LSE/LLSE 的 KVDB(kvdb 數據庫)能否被兩個服務端同時訪問?
不能。LSE 的 KVDatabase 是基於 LevelDB 的本地數據庫,LevelDB 同一時間只允許一個進程打開同一個數據庫目錄,不支持多個服務端同時訪問。需要多服共享數據時,請使用 MySQL 等網絡數據庫(LSE 的 DBSession 支持 MySQL)。
在 LSE 腳本插件裡,怎樣根據 UUID / XUID 獲取離線玩家的信息(名字、UUID 等)?離線玩家的 NBT 又該怎麼讀?
用 data 模塊的離線玩家查詢接口:data.fromUuid("<uuid>") / data.fromXuid("<xuid>") 返回 {xuid, name, uuid} 對象(找不到時返回空),例如 data.fromUuid(uuid).name、data.fromXuid(xuid).uuid。LSE 自帶 API 不方便讀寫離線玩家 NBT,可考慮社區插件 LRCA(通過 LegacyRemoteCall 導出擴展 API)提供的離線 NBT 接口。
適用版本:當前版本(LRCA 為第三方插件)
用 LSE 插件實現“命令木牌/命令方塊點擊執行命令”時,把命令寫進方塊實體 NBT 裡會被清掉,應該怎麼存儲?
BDS 會清除方塊實體/物品上它不認識的自定義 NBT,寫進方塊實體 NBT 存不住。推薦做法:監聽 onUseItemOn(或 onBlockInteracted)事件,把“座標+維度+方塊類型 -> 命令”存到配置文件或數據庫(啟動時讀入 map,定時/變更時保存);點擊時按座標查找命令並執行,若該位置方塊類型已變化說明原方塊被破壞,就刪除該記錄。現成的 LSE 插件可參考 cmdanyblock:https://www.minebbs.com/resources/cmdanyblock.3755/
適用版本:LSE 當前版本。未能從源碼或文檔中直接證實,僅供參考。
LSE 中通過 let b = a.getTag("xxx") 取得子 NBT,然後在 setTimeout 等延遲迴調裡使用 b 時數據已被銷燬/崩潰,是什麼原因?
這是 LSE NBT 綁定的生命週期問題:getTag 返回的子 NBT 對象只持有指向父 NBT 內部數據的裸指針,並不持有父(根)NBT 的引用,父對象 a 被回收後,子對象 b 指向的數據也隨之銷燬。規避方法:在腳本中持久持有根 NBT 對象(例如存到全局變量),或先轉換成其他形式(如 toSNBT()/toObject())保存,用時再用 NBT.parseSNBT 等轉回。
適用版本:當前所有版本(截至 LSE 0.23.1)