LegacyScriptEngine API:引擎、模塊與定時器
LSE(LegacyScriptEngine)腳本插件還需要調用 ll.registerPlugin 註冊插件嗎?文檔裡搜不到,插件名稱、版本等信息在哪裡設置?完整 API 定義在哪找?
不需要。LSE 插件的信息(name、version、author、description、entry、type 等)寫在插件目錄的 manifest.json 中,加載時自動註冊。ll.registerPlugin 已棄用並從 LSE 文檔中刪除,僅為兼容舊 LLSE 插件保留:它會對參數做類型檢查,並在傳入版本與 manifest 中不同時把參數寫回插件的 manifest.json,沒有其他作用。參數類型不對時會拋異常,若未捕獲會導致插件後續代碼不執行,而且插件加載階段拋出的異常可能不會在控制台顯示任何報錯(見仍未關閉的 https://github.com/LiteLDev/LegacyScriptEngine/issues/240),因此建議直接刪除該調用。
完整的 API 類型定義(包括 File 等類)可參考 https://github.com/LiteLDev/legacy-script-engine-api。
適用版本:LSE 當前所有版本(LeviLamina 下)
LSE 中如何獲取服務器當前 TPS?用 onTick 計算為什麼會大於 20?
LSE 本身沒有獲取 TPS 的 API,可用 mc.listen("onTick", ...) 自行統計:每次 tick 計數器加一,每秒讀取並清零即為 TPS(正常為 20);或計算執行 20 個 tick 所用時間再做除法。偶爾算出 21 之類大於 20 的值是正常的——BDS 一秒內沒跑完 20 tick 會在下一秒補回來,計時誤差也會造成偏差。可參考 MineBBS 上的 ShowTPS 插件:https://minebbs.com/resources/showtps-tps.8950/。MSPT 為每 tick 耗時,TPS 可由其推算。
另外也可安裝第三方前置 GMLIB 及其 LegacyRemoteCallApi(LRCA),在 JS 中導入後調用 Minecraft.getServerCurrentTps(),不必執行命令再解析輸出。若要在 TPS 過低時清理實體,腳本里遍歷 mc.getAllEntities() 性能一般,直接 mc.runcmd("kill @e[type=!player,...]") 往往更省。
適用版本:LeviLamina 上的 LegacyScriptEngine 當前所有版本;GMLIB/LRCA 方案需安裝對應第三方前置
LSE 的 JS 插件(QuickJS 引擎)裡使用 console.log / console.error 報錯,應該用什麼輸出日誌?
QuickJS 引擎環境裡沒有 console 對象,只有 Node.js 引擎的插件可以用 console.log。QuickJS 插件請使用 LSE 提供的 log() 或 logger API(如 logger.info / logger.warn / logger.error),文檔:https://levimc.org/zh-Hant/LegacyScriptEngine/ 中 ScriptAPI → Logger 頁面。
適用版本:LSE QuickJS 引擎當前所有版本
LSE 的 JS 插件能否把“子插件/擴展”放在自己的子文件夾裡,由主插件去加載?
子文件夾裡的腳本不能作為獨立的 LSE 插件註冊(每個插件需要放在 plugins 下自己的目錄並有自己的 manifest)。如果要實現“插件的插件”,只能在主插件裡自己實現加載器:用 CommonJS(require)或 ES Module 把擴展當模塊引入,模塊內仍可直接使用 LSE 全局 API,擴展通過導出函數/對象共享功能。可參考 UMenu(https://github.com/engsr6982/lse-workspace/tree/main/projects/UMenu)對擴展的加載、卸載、重載實現。
注意避免循環依賴(被加載文件不要反過來 require 主文件),必要時改用 ESM。否則就把各插件分別放到 plugins 目錄下作為獨立插件。
適用版本:LeviLamina + LSE 當前版本
編寫 LSE 的 JS/TS/Node.js 插件時,mc、logger、PermType、ParamType、Player 等需要從什麼模塊 import?類型定義怎麼引入,Player 類能在運行時訪問或繼承嗎?
不需要 import。LSE 把 mc、logger、ll、PermType、ParamType 等 API 作為全局對象注入(Node.js 插件同樣如此),直接使用即可;調用其他插件導出的函數則用 ll.imports(遠程調用)。類型提示也應聲明為全局:官方類型庫為 https://github.com/LiteLDev/legacy-script-engine-api(含 JS/TS 與 Python)。
文檔中的 Player 等類名在運行時並不存在,引擎實際註冊的類名帶 LLSE_ 前綴(如 LLSE_Player),直接訪問 Player 會得到 undefined;這些類也沒有可用的構造函數,無法繼承。API 文檔見 https://levimc.org/zh-Hant/LegacyScriptEngine/apis/。
適用版本:LSE 當前版本
LSE Python/JS 插件裡用 time.sleep 或 while True 死循環做倒計時/循環延遲執行命令,為什麼會卡服?該怎麼寫?
腳本插件在 BDS 主線程中執行,回調裡 time.sleep 或不退出的死循環會阻塞整個服務器。週期性任務應使用 LSE 提供的跨語言定時器 setTimeout / setInterval(Python 中同樣可用),結束時 clearInterval;顯示標題可直接用 pl.setTitle 代替執行 title 命令。JS 示例:
let delay = 5000;
let task = setInterval(() => {
player.setTitle(`${delay / 1000}`, 4, 1, 2, 1);
if (delay <= 0) {
player.setTitle('新年快乐', 4, 0, 1, 0);
clearInterval(task);
}
delay -= 1000;
}, 1000);適用版本:LSE 當前所有版本
LSE 插件裡能用 Script API(addon,@minecraft/server)的 serverApi、world.getDimension()、origin.teleport()、server.on 之類的寫法嗎?
不能。LSE 插件和 Minecraft 官方 Script API(SAPI,@minecraft/server)是兩套完全不同的 API,不能混用,也不要直接照搬 AI 生成的 SAPI 代碼。LSE 中沒有 serverApi / playerApi / worldApi / world.getDimension 這類對象:監聽事件用 mc.listen(事件名, 回调),輸出日誌用 logger.log,傳送玩家用 Player 對象的 pl.teleport(...) 或 mc.runcmd 執行 tp 命令等。請按 LSE 文檔 https://levimc.org/zh-Hant/LegacyScriptEngine/(API 參考)編寫,編輯器類型提示可用 legacy-script-engine-api。
適用版本:當前所有 LSE 版本
LSE 的 Python 插件中給事件回調參數寫類型註解時,用 player: Player 不生效(報未定義),應該怎麼寫?
LSE 向腳本引擎註冊的類名帶 LLSE_ 前綴,Python 環境中玩家類叫 LLSE_Player,並沒有名為 Player 的類,所以類型註解應寫成 player: LLSE_Player(其他類同理,如 LLSE_Item、LLSE_Block 等)。如需在 IDE 中獲得補全,可使用 LiteLDev/legacy-script-engine-api 倉庫中 platforms/python 提供的類型提示。
適用版本:LegacyScriptEngine Python 後端(legacy-script-engine-python)當前版本
LSE 的 TypeScript 類型補全庫裡,LLSE_Player 這類帶前綴的類名和 Player 這類無前綴的類名有什麼區別,該用哪個?
在補全庫中,帶 LLSE_ 前綴的類都繼承自對應的無前綴類(如 declare class LLSE_Player extends Player {}),保留無前綴類名是為了不引入不兼容變更。TypeScript 按結構(形狀)匹配類型,兩者可以互相傳遞,按喜好選用即可。注意這只是類型聲明層面的區別:運行時引擎實際註冊的類名是 LLSE_Player。補全庫現為 LiteLDev/legacy-script-engine-api(platforms/javascript)。
適用版本:legacy-script-engine-api(原 HelperLib)當前版本
LSE(腳本插件)裡的 setTimeout 第二個參數是 tick 還是毫秒?怎麼寫?
第二個參數是毫秒。用法 setTimeout(func, msec),func 可以是匿名函數、箭頭函數或已定義的函數引用,返回任務 ID(可用 clearInterval 取消);也支持 setTimeout(code, msec) 傳入代碼字符串。需要週期執行時用 setInterval(func, msec)。
注意 setTimeout 只是延後執行,回調仍在服務器主線程運行,耗時邏輯並不會因此變成異步。
LSE JS(QuickJS)插件中入口文件 import 子模塊正常,但子模塊再 import 其他文件(嵌套 import)就報錯,路徑該怎麼寫?
LSE 的 QuickJS 模塊加載器在加載 manifest.json 指定的入口模塊時,會把 base path 設為當前工作目錄(即服務器程序所在目錄),而不是腳本所在目錄。所以入口文件裡要寫成 ./plugins/<你的插件>/xxx.js 這種從服務器根目錄起算、帶 .js 後綴的路徑,例如 import { initCommand } from "./plugins/your_plugin/command/command.js"。
這個問題隻影響入口模塊;被入口導入的其他模塊之間的 import 按標準 ES Module 規則解析,即相對於模塊自身所在位置,所以子模塊裡應寫相對於子模塊自身的相對路徑,不要再從 ./plugins 開始寫。
適用版本:LSE QuickJS 引擎 0.23.x
LSE 中 ll.getPluginInfo() 返回 undefined,導致依賴它做安全檢查的舊插件(如 TMEssential)失敗,為什麼?
LSE 中插件信息以插件目錄下的 manifest.json 為準,ll.getPluginInfo(name) 按插件(mod)名稱查找;插件名就是 manifest.json 裡的 name,舊單文件插件遷移後名稱為去掉 .js 後綴的文件名,所以傳入的名字不要帶 .js 後綴。
ll.registerPlugin 僅為兼容舊插件保留,它不再是插件信息的來源,只會在版本號與 manifest 不一致時把描述/版本/附加信息回寫到 manifest.json。舊插件依賴 registerPlugin/getPluginInfo 做安全檢查的,需要按此修改代碼。
LSE 中 setTimeout/setInterval 的參數是毫秒,但底層按遊戲刻調度,會不會有精度問題?為什麼不用系統時間/線程計時?
LSE 的 setTimeout/setInterval 用 LeviLamina 協程(ll::coro)在 ServerThreadExecutor 上調度:傳入的毫秒數會向上取整為遊戲刻(1 tick = 50ms),在服務器每次 Level tick 時執行到期任務。因此實際精度是一個遊戲刻,且服務器卡頓(TPS 下降)時會相應延後,這與 LL2 的行為一致。
之所以不用獨立線程按系統時間計時,是因為 MC 接口只能在遊戲主線程調用,回調必須回到服務器線程執行。
LSE 中用 jsdebug 進入 JS 調試模式後如何退出?以及如何獲取玩家的 IP?
再輸入一次 jsdebug 即可退出調試模式(Lua 為 luadebug,Python 為 pydebug;Node.js 沒有調試模式)。遊戲內能否使用該命令由 LSE 配置文件 config.json 中的 debugCommandLevel 決定,默認為 GameDirectors(OP)。
獲取玩家 IP:pl.getDevice().ip(返回 IP:端口);pl.ip 屬性也存在,返回不帶端口的地址。
LSE 中對 player 對象做解構(const {name, xuid, getExtraData} = player)後調用 getExtraData 報錯 不可以将值转换为对象,為什麼?
LSE 引擎提供的對象,屬性(如 name、xuid)可以解構取值,但方法是綁定在實例上的原生 instanceFunction,解構出來單獨調用時丟失了 this(不再指向 Player 實例),因此報錯。需用 player.getExtraData(...) 的形式調用,或 getExtraData.call(player, ...)。
適用版本:LSE 當前所有版本
LSE 中導入其他插件導出函數應該用 ll.import 還是 ll.imports?文檔寫的是 ll.imports,但調用失敗。
官方 API 是 ll.imports(namespace, name)(返回一個可調用函數),配合 ll.exports 導出使用。LSE 在 JS 和 Lua 的 baselib 中定義了 ll.import = ll.imports 作為兼容別名,兩者完全等價(Python 中 import 是關鍵字,只能用 ll.imports)。
若調用失敗,通常是目標插件尚未加載 / 未導出該函數,或 namespace、name 寫錯,而不是寫法問題;可用 ll.hasExported(namespace, name) 檢查。
適用版本:LSE 當前所有版本
在 LSE 中用 system.cmd 執行外部命令(例如 7z 壓縮)時回調不觸發或拿不到返回值,怎樣判斷是否成功?
system.cmd(cmd, callback[, timeLimit]) 的回調要等 shell 進程結束後才執行;如果命令裡用 start 另起了進程,就無法判斷它何時結束。
可以改用 system.newProcess(process, callback[, timeLimit]) 直接運行外部程序,在回調 function(exitcode, output) 里根據 exitcode 和輸出判斷是否成功。回調必須傳一個函數(例如匿名函數 (exitcode, output) => {...}),不要寫成函數調用。
適用版本:LSE 0.23.x
LSE 插件能否獲取 / 攔截 BDS 控制台輸出的所有信息?
不能。LSE 以前的控制台輸出事件已被移除;system.cmd 只能獲取所執行系統命令的輸出,不能捕獲 BDS 控制台日誌。要捕獲控制台輸出需寫原生(C++)mod 去 hook 輸出函數。
LSE 的 JS 插件裡可以用 require / module.exports 這種 CommonJS 寫法嗎?還是要用 import / export?
取決於引擎:
- Node.js 引擎(
#nodejs變體):默認按 CommonJS 加載,可以用require/module.exports,也可以requirenpm 依賴;在插件的package.json中設置"type": "module"後則按 ES 模塊加載,使用import/export。 - QuickJS 引擎:入口文件以 ES 模塊方式加載(原生支持 ESModule),應使用
import/export;QuickJS 不提供 CommonJS 的require/module.exports,也不支持 npm 包管理。注意 QuickJS 入口模塊中的相對import路徑是以服務器工作目錄(BDS 所在目錄)為基準解析的,例如要寫成import { x } from "./plugins/your_plugin/command/command.js";入口之後其它模塊之間的import行為符合標準。
適用版本:LSE 0.10.6 及以上(Node.js ESM 支持自 0.10.6 起);當前 0.23.x
LSE 的 Lua 插件怎麼輸出日誌?和 JS 一樣嗎?
一樣。LSE 各語言共用同一套 API,Lua 中同樣可以使用全局函數 log(...) / colorLog(...),以及 logger 對象(logger.info / logger.warn / logger.error / logger.debug / logger.log 等),用法與 JS 相同。文檔地址:https://levimc.org/zh-Hant/LegacyScriptEngine/(日誌 API 見其 apis/ScriptAPI/Logger 頁面)。
LSE 腳本插件中 setTimeout 無法給回調傳參,怎麼讓延時執行的函數帶參數?
LSE 提供的 setTimeout(func|code, ms) 只接受回調(函數或代碼字符串)和延時兩個參數,不會把額外參數轉發給回調。可以用閉包包一層:setTimeout(() => fn(arg1, arg2), ms);或寫一個返回無參函數的包裝函數,在裡面調用帶參函數。
適用版本:當前版本(QuickJS 等引擎的 LSE 內置 setTimeout)
LSE(包括 Node.js 引擎)中暴露的類(如表單類)能否被繼承或重載?
不能。表單(LLSE_SimpleForm、LLSE_CustomForm)、玩家、實體、方塊、命令等由 C++ 創建的對象類沒有向腳本暴露構造函數,無法繼承,只能自己寫包裝(wrapper)。只有少數類有構造函數,例如 IntPos、FloatPos、DirectionAngle、各 NBT 類、JsonConfigFile、IniConfigFile、KVDatabase 等。表單方面可參考社區封裝,例如 https://github.com/lgc-LLDev/FormAPIEx。
LegacyScriptEngine 的 Node.js 引擎(legacy-script-engine-nodejs)寫插件時如何添加 npm 第三方依賴?
在插件目錄(mods/<插件名>/,即 LeviLamina 的模組根目錄下)裡用 npm init 生成 package.json,把依賴寫進 dependencies;manifest.json 中把 "type" 設為 "lse-nodejs"。加載插件時,如果 package.json 裡有依賴且插件目錄下還沒有 node_modules,LSE 會自動在插件目錄執行 npm install --omit=dev --no-fund,所以 node_modules 不需要打包分發。舊的做法(把 package.json 和源碼打成 zip 並改後綴為 .llplugin 放進 mods 目錄)仍兼容:引擎會把它解壓到 mods/<插件名>/ 並自動生成 manifest.json。也可使用社區腳手架 https://github.com/leoweyr/legacy-script-engine-scaffold。
適用版本:LSE Node.js 引擎(lip install LegacyScriptEngine#nodejs);當前 0.23.x
依賴 legacy-script-engine-quickjs 的 JS 插件如何調用 ffi-napi 或其他 DLL 庫?
QuickJS 引擎不支持 npm 原生模塊,可改用 Node.js 引擎(legacy-script-engine-nodejs)運行插件,即可使用 ffi-napi 等 Node 原生模塊。基於 QuickJS 的插件理論上可直接移植到 Node.js 引擎(manifest type 改為 lse-nodejs,依賴寫入 package.json)。Node.js 引擎依賴 libnode.dll,現在用 lip install LegacyScriptEngine#nodejs 安裝時會自動下載 LiteLDev/node 的預編譯包,無需再從官方 QQ 群的群文件手動獲取。
適用版本:LSE Node.js 引擎;當前 0.23.x
在 LSE JS 插件中能否用 instanceof 判斷一個參數是否是 IntPos?
可以,obj instanceof IntPos 可用。LSE 文檔中稱為“類”的對象一般都可以這樣判斷,只是實際註冊的類名不一定與文檔裡的名字完全一致。
在 LSE JS 插件裡用 ll.imports("BEPlaceholderAPI", "registerPlayerPlaceholder") 直接把回調函數傳進去註冊 PAPI 變量,結果插件加載失敗/報錯,正確寫法是什麼?
跨插件遠程調用(RemoteCall)不支持傳遞函數類型參數。應先用 ll.exports(別名 ll.export)把回調導出,再把命名空間和導出名傳給 registerPlayerPlaceholder:
const registerPlayerPlaceholderAPI = (papiName, callback, pluginName = "your plugin name") => {
ll.exports(callback, pluginName, `Placeholder_${papiName}`);
ll.imports("BEPlaceholderAPI", "registerPlayerPlaceholder")(pluginName, `Placeholder_${papiName}`, papiName);
};
registerPlayerPlaceholderAPI("player_temp", (pl) => `${getTemp(pl)}°C`);該 PAPI 接口屬於第三方(GMLIB),其作者更推薦使用新版 PAPI 接口,文檔見 https://github.com/GroupMountain/GMLIB-Release/blob/release/PlaceholderDocs.md。
適用版本:LeviLamina;LegacyScriptEngine;LegacyRemoteCall(PAPI 部分取決於第三方 GMLIB 版本)
在 LSE 插件中用 ll.imports 導入其他插件導出的函數時報錯 Fail to import! Function [...] has not been exported!,怎麼解決?
通常是調用時機太早,對方插件還沒執行 ll.exports 導出該接口(或命名空間/函數名寫錯)。應在服務器啟動完成之後(例如 mc.listen("onServerStarted", ...) 回調中)再導入/調用,也可以先用 ll.hasExported(namespace, name) 檢查是否已導出。
在 LSE 的 Python 插件裡用 open('a.txt','a') 寫文件,沒有報錯但在插件目錄找不到生成的文件,文件寫到哪裡了?
LSE 不會把腳本的工作目錄切換到插件目錄,相對路徑是相對於 BDS 根目錄(進程工作目錄)解析的,所以 a.txt 會出現在 BDS 根目錄下。若要寫到插件目錄,需要寫成 plugins/<插件名>/a.txt 這樣的路徑,可藉助 os 模塊(os.path.join、os.makedirs(..., exist_ok=True))拼接路徑並確保目錄存在。另外注意 open() 的模式參數必須是字符串('a' 而不是 a)。
適用版本:LSE Python 後端(legacy-script-engine-python),當前版本
在 LSE 插件裡用 logger 輸出到服務器後臺(控制台)時,怎樣讓文字帶顏色?用 § 顏色代碼在後臺沒有效果。
§ 格式代碼只對遊戲內文本有效,LSE 的 logger 不會把它轉換成控制台顏色,後臺要用 ANSI 轉義序列。把轉義碼拼到輸出字符串裡即可,例如前景色 \x1b[30m ~ \x1b[37m(黑/紅/綠/黃/藍/洋紅/青/白),背景色 \x1b[40m ~ \x1b[47m,\x1b[0m 重置樣式,\x1b[1m 粗體,\x1b[4m 下劃線等。示例:
logger.info("\x1b[33m黄色文字\x1b[0m")JS 嚴格模式下八進制轉義 \033 不可用,建議寫 \x1b 或 \u001b。
在 LSE 的 JS 插件裡用 log 輸出字符畫(ASCII art),由於字符串中的反斜槓 \ 被轉義導致排版錯亂,有什麼辦法避免轉義?
使用 JS 的模板字符串標籤 String.raw,例如:
log(String.raw` /\_/\ ...`)其中的反斜槓不會被轉義(參考 MDN 的 String.raw 文檔)。也可以把所有 \ 替換成 \\(雙反斜槓),但畫字符畫時 String.raw 更方便。
適用版本:LSE JS 後端(QuickJS / Node.js),當前版本
在 LegacyScriptEngine(ScriptX)中,JS 傳入的 undefined 在 C++ 側會變成什麼?如何區分 undefined 和 null?
V8 本身區分 undefined 和 null,但 ScriptX 抽象層把二者統一視為 Null:Local<Value>::isNull() 對 undefined 和 null 都返回 true,C++ 側 Local<Value>() 返回給 JS 是 undefined。若要真正傳 null 需要直接使用 v8::Null(isolate),ScriptX 本身未提供區分。因此 API 實現中對可選參數(如 setTitle 的 fadeInTime/stayTime/fadeOutTime)應先檢查 isNull,避免 JS 傳 undefined 導致錯誤。
適用版本:當前版本(ScriptX V8 後端)
如何在服務器控制台快速打印所有已加載 LSE 插件的名稱和版本(排查環境用)?
在控制台執行(需安裝 QuickJS 引擎 legacy-script-engine-quickjs):
jsdebug ll.getAllPluginInfo().forEach(info => logger.warn(`${info.name}: ${info.versionStr}`))注意 ll.getAllPluginInfo() 返回的是 LeviLamina 已加載的所有 mod(包括原生 C++ mod),每項含 name、versionStr、type 等字段。
適用版本:當前版本(QuickJS 後端提供 jsdebug;Node.js 後端不支持調試命令)
怎樣開始寫 LSE 的 Node.js 插件?和 QuickJS 插件有什麼區別?
Node.js 插件和 QuickJS 插件使用的 LSE API 一樣,區別是可以通過 npm 引入第三方庫(package.json 中設置 "type": "module" 可使用 ES 模塊)。需安裝 LSE 的 nodejs 引擎(lip 變體 LegacyScriptEngine#nodejs)。
開發:安裝 Node.js,新建目錄執行 npm init 生成 package.json 並在入口文件中編寫代碼。
部署:把 package.json 和源碼(不含 node_modules)打包成 zip 並把後綴改為 .llplugin,放進 mods 目錄;開服時 LSE 會自動解壓到 mods/插件名、生成 manifest.json 並執行 npm install 安裝依賴。
類型提示可使用 https://github.com/LiteLDev/legacy-script-engine-api(包含 JS/TS 和 Python 的類型定義)。Node.js 後端沒有 jsdebug 這類控制台調試命令。
適用版本:當前版本(LeviLamina,nodejs 引擎)
用 LegacyScriptEngine 開發 JS 插件時如何做多文件(模塊化)開發?
使用 LSE 的 Node.js 引擎(lip install LegacyScriptEngine#nodejs 安裝的變體),可按 Node.js 方式組織多文件,用 require 引入(CJS),在 package.json 中設置 "type": "module" 即可作為 ES 模塊加載(ESM)。QuickJS 引擎也原生支持 ESModule 多文件,但注意:manifest.json 指定的入口模塊中的相對 import 路徑以服務器工作目錄(BDS 所在目錄)為基準,需寫成 "./plugins/你的插件/xxx.js";入口之外的模塊之間 import 行為符合標準。詳見 LSE 文檔“語言支持”。
適用版本:LSE 當前版本
LSE JS 插件在頂層直接寫 return 想停止執行,編輯器不報錯但加載時報錯 return not in a function,如何提前結束?
LSE 的 QuickJS 引擎加載插件入口文件時,先嚐試以 ES 模塊方式加載(loadFile,JS_EVAL_TYPE_MODULE),失敗再以全局腳本方式 eval;兩種方式的頂層都不是函數體,都不允許 return,因此會報 return not in a function。應把業務代碼封裝到函數(或 IIFE)裡,在函數內 return 提前結束。
適用版本:LSE QuickJS 引擎,當前所有版本
LSE Node.js 插件(如 BetterSidebar)加載失敗,日誌中 mkdir 路徑出現盤符重複(如 E:\...E:\...),或子插件加載路徑變成 xxx/src/plugins,是什麼原因?
插件代碼用了 path.join(process.cwd(), __dirname, 'plugins'),而 __dirname 已是該 JS 文件所在目錄的絕對路徑,再與 cwd(BDS 根目錄)拼接會導致盤符重複;去掉 process.cwd() 又會指向 src/plugins。應按插件實際目錄結構基於 __dirname 正確拼接(例如 path.join(__dirname, '..', 'plugins')),需要修改插件代碼。
若是缺少依賴:LSE 加載 Node.js 插件時,如果 package.json 聲明瞭依賴且插件目錄下沒有 node_modules,會自動在插件目錄執行 npm install --omit=dev;否則可在插件目錄手動執行 npm i 安裝。注意 LSE 控制台的 npm 命令默認工作目錄是引擎目錄,而不是插件目錄。
適用版本:LSE Node.js 引擎,當前所有版本
LSE 插件用 ll.imports 調用 GMLIB 的懸浮字 API 時報錯 Fail to import! Function [GMLIB_API::...FloatingText...] has not been exported!(中文日誌為“導入失敗!函數[...]尚未被導出”),怎麼解決?
原因是調用時導出這些函數的前置(GMLIB 及其 LSE 導出部分 GMLIB_API)還沒有註冊導出:前置沒有加載,或者你的插件在前置加載完成之前就調用了導入的函數。LSE 是在實際調用導入函數時才去查找導出的(MakeRemoteCall -> RemoteCall::importFunc),報錯也出現在調用的時候。
- 查看服務器啟動日誌的 mod 列表,確認 GMLIB 及其 LSE 導出部分已成功加載。
- 在插件的
manifest.json的dependencies中聲明對 GMLIB(及其導出模塊)的依賴,確保你的插件在它之後加載。
裝好前置並補上依賴後,懸浮字 API 就能正常導入。GMLIB 為第三方前置。
適用版本:LeviLamina 當前版本;LSE 當前版本