跳到正文
本頁目錄

LegacyRemoteCall

C++ mod 用 LegacyRemoteCall(RemoteCall::exportAs)導出函數給 LSE 腳本時,參數/返回值用 std::variant 編譯失敗,報 static_assert "Unsupported Type",怎麼辦?

RemoteCall 的參數/返回值只支持一組固定類型(bool、std::string、nullptr_t、整數/浮點數(NumberType)、Player*/Actor*/BlockActor*/Container*、座標(WorldPosType/BlockPosType)、ItemType、BlockType、NbtType,以及由這些類型組成的 std::vector 和 std::unordered_map<std::string, T>),不支持 std::variant,所以會觸發 static_assert(is_supported_type_v<...>, "Unsupported Type")。

解決辦法:把參數換成受支持的類型,最簡單的是把數據序列化成 JSON 字符串(std::string)傳遞,接收方再解析;也可以自己寫模板為 variant 做類型轉換(理論可行,但較麻煩)。

另外數字傳給 JS 時按 double 轉換(LSE 中 Number::newNumber(v.get<double>())),long long 這類大整數可能丟精度,必要時用字符串傳遞。

適用版本:LegacyRemoteCall 當前所有版本(至 0.23.x)

LeviLamina 下 C++ mod 如何把接口公開給其他插件(尤其是 LSE 的 JS 腳本插件)調用?

使用 LegacyRemoteCall(RemoteCall):在 C++ mod 中用 RemoteCall::exportAs("命名空间", "函数名", 函数) 導出函數,JS 側用 ll.imports("命名空间", "函数名") 導入後調用(JS 自己導出則是 ll.exports(func, "命名空间", "函数名"),注意函數在第一個參數)(可先用 ll.hasExported 判斷是否存在)。導出方式可參考 GMLIB-LegacyRemoteCallApi(LRCA),命名空間/函數名建議用類似 Actor.getName 這樣易辨認的形式。純原生 mod 之間也可以直接用 dllexport 導出函數互相調用。LeviLamina 本體不內置 RemoteCall,它由單獨的 LegacyRemoteCall 模組提供(LSE 依賴它)。此外也可以用網絡通信等方式對接。

適用版本:LeviLamina 當前版本;LegacyRemoteCall 當前版本;LSE 當前版本

LSE 中用 ll.exports 導出的異步函數,別的插件通過 ll.imports 導入後能否 await 拿到異步返回值?

不能。遠程調用(ll.exports/ll.imports)是同步執行的:被調函數的返回值會立即被打包(轉換成 RemoteCall::ValueType)返回給調用方,Promise 不會被跨插件傳遞,調用方無法 await 得到異步結果;被調函數如果阻塞,會連帶阻塞服務器主線程。需要異步結果時要換別的方式,例如由對方完成後再調用你導出的另一個函數、寫入數據庫/文件或通過事件通知。

適用版本:LSE 當前所有版本

LSE 插件中用 ll.imports("命名空间", "函数名") 調用其他插件導出的函數時報錯(如函數未導出),如何先判斷該導出函數是否存在?

使用 ll.hasExported(namespace, name) 先檢查對應函數是否已被導出,再調用 ll.imports 獲取的函數(未導出時調用會報 Fail to import! Function [ns::name] has not been exported)。另外 RemoteCall 的參數必須可轉換,不能把函數(kFunction)或 ByteBuffer 當作參數傳過去,否則會拋 Unsupported Type。排查時可在每一步加 logger 輸出並用 typeof 檢查返回值。

適用版本:LSE 當前所有版本

LeviLamina 下的 RemoteCall(ll.exports/ll.imports 跨插件調用)支持哪些參數類型?能傳 Player、方塊、物品等對象嗎?

可以。當前 LegacyRemoteCall + LSE 支持:null、字符串、數字、布爾、數組、普通對象(按鍵值遞歸轉換),以及 Player、Entity、Item、Block、BlockEntity、Container、FloatPos、IntPos、NbtCompound 等遊戲對象。不支持函數和 ByteBuffer。若對方是不認識這些類型的插件,也可以改傳 uuid/xuid、座標 JSON、SNBT 字符串等。

適用版本:LSE 0.x 正式版及以後

RemoteCall(LegacyRemoteCall)導出/調用的函數參數可以使用 std::pair 類型嗎?

只支持特定的 std::pair:std::pair<Vec3, int>(會轉換為 WorldPosType,對應 JS 的 FloatPos,座標+維度 ID)和 std::pair<BlockPos, int>(轉換為 BlockPosType,對應 IntPos)。GMLIB-LegacyRemoteCallApi 中座標參數就是這樣傳的。任意類型的 std::pair(如 std::pair<std::string, int>)不受支持,會觸發 Unsupported Type 編譯錯誤。

適用版本:LegacyRemoteCall 當前所有版本

LSE 中看到的 LLSEGlobal 是什麼?

使用 ll.exports / ll.imports / ll.hasExported 時如果沒有指定命名空間(只傳函數名),會自動使用默認命名空間 LLSEGlobal。

適用版本:LSE 當前所有版本

LegacyRemoteCall(RemoteCall)是什麼,用來解決什麼問題?新 mod 應該依賴它嗎?

LegacyRemoteCall 用來導出函數供跨插件調用,主要方便 LSE 的 JS/Lua 插件調用 C++ mod 導出的函數(ll.exports/ll.imports 的底層)。它是 LegacyScriptEngine 的配套組件(LSE 依賴它),定位是兼容舊 LLSE 生態。維護者建議新的原生 mod 不要強制依賴 RemoteCall,如需給腳本提供接口,可另寫一個可選的外置模塊來導出。

適用版本:當前版本(LegacyRemoteCall 0.23.x)

舊 LLSE 中跨插件導入導出函數(ll.export/ll.import)在 LeviLamina 裡由哪個模塊實現?插件加載順序/依賴又該如何聲明?

在 LL2 中由 LL 本體和 ScriptEngine 提供;在 LeviLamina 中由 LegacyRemoteCall(https://github.com/LiteLDev/LegacyRemoteCall)和 LSE 共同提供:函數表在 LegacyRemoteCall(保存 std::function<ValueType(std::vector<ValueType>)>),腳本側 ll.exports/ll.imports 定義在 LSE(ll.export/ll.import 為兼容別名)。LeviLamina 採用模塊化設計,插件依賴/加載順序在 manifest.json 中聲明:dependencies(必需依賴),另有 optionalDependencies、loadBefore、conflicts 等字段。

適用版本:LeviLamina 當前版本;LSE 當前版本

裝了 GMLIB-LegacyRemoteCallApi 後依賴 GMLIB 的插件仍報缺少前置,怎麼辦?

GMLIB 與 GMLIB-LegacyRemoteCallApi 不是同一個東西(後者只是給 LSE 腳本插件用的 RemoteCall 接口層),需要另外安裝 GMLIB 本體:https://github.com/GroupMountain/GMLIB-Release,或在服務器根目錄執行 lip install github.com/GroupMountain/GMLIB-Release。

適用版本:使用 GMLIB 的 LeviLamina 服務器

升級後 LSE 的 nodejs 等支持庫裝不上/加載報錯,提示 LegacyRemoteCall 相關問題怎麼辦?

這是 LegacyRemoteCall 與 LegacyScriptEngine / LeviLamina 版本不匹配導致的,需要讓三者配套。當前 LSE 的 lip.toml 已把 LegacyRemoteCall 聲明為依賴(如 LSE 0.23.x 依賴 LegacyRemoteCall 0.23.,LeviLamina 26.60.),用 lip 安裝/更新時會自動拉取匹配版本:用 lip update(或 lip update github.com/LiteLDev/LegacyScriptEngine)更新包;要更換 LeviLamina 本體版本則用 lip setup。手動安裝時請務必一起替換 LegacyRemoteCall。命令以當前 lip 為準。

用 RemoteCall 導出函數/事件給 LSE 調用時,能調用但報錯 bad variant access,是什麼原因?

bad variant access 表示參數/返回值的實際類型與 RemoteCall::exportAs / importAs 聲明的類型不匹配(內部用 std::get 從 std::variant 取值,類型不符時拋出 std::bad_variant_access)。檢查 JS 側傳入的類型與 C++ 導出函數簽名是否一致。基礎數值類型(以及 WorldPosType、BlockPosType 轉換類型)的參數不要聲明為引用(int& 或 const int& 都不行),改為按值傳遞;新版 RemoteCallAPI.h 對從 NumberType 等轉換中提取引用加了 static_assert,這種寫法會直接編譯報錯(0.21.1 起引用參數會在編譯期報錯)。

適用版本:LegacyRemoteCall 當前版本

GMLIB 能正常加載,但 GMLIB-LegacyRemoteCallApi(LRCA)加載失敗,是什麼原因?

通常是版本不配套:GMLIB、GMLIB-LegacyRemoteCallApi、LegacyRemoteCall、iListenAttentively、LegacyScriptEngine 與 LeviLamina 本體版本不匹配。把 LeviLamina 及所有相關依賴一起更新到相互匹配的版本,一個也不能漏。當前 LRCA 的 manifest 聲明依賴 GMLIB、LegacyRemoteCall、iListenAttentively、ModAPI,缺任一或版本不對都會導致加載失敗;另外 LRCA 是 passive 模組,只有當有其他模組/腳本插件聲明依賴它時才會被加載。

加載插件時報錯 [GMLIB-LegacyRemoteCallApi] setUnknownBlockCleaner is not implemented,GMLIB 的清理未知方塊 API 怎麼了?

GMLIB 的 setUnknownBlockCleaner(清理未知/錯誤方塊)功能已被移除,LRCA 中只保留了一個空殼導出,調用時輸出 setUnknownBlockCleaner is not implemented,依賴它的插件該功能無法生效。需要清理未知方塊請改用 GMEssentials(GME):https://github.com/GroupMountain/GMEssentials-Release/

適用版本:GMLIB-LegacyRemoteCallApi 當前版本

LSE 插件調用 GMLIB 等通過 GMLIB-LegacyRemoteCallApi 導出的接口(例如 translateString)失效,明明已經裝了 LegacyRemoteCallApi,為什麼?

GMLIB-LegacyRemoteCallApi 是 passive 模組,只有當有其他模組/插件依賴它時才會被加載。需要在你的插件 manifest.json 的 dependencies 中聲明它,例如:

json
"dependencies": [{ "name": "GMLIB-LegacyRemoteCallApi" }]

依賴項的 version 字段可以省略(省略時匹配任意版本),寫了則是版本範圍約束。