配置 LeviLamina
BDS 26.x 改用 NetherNet 網絡協議後,用 frp(如櫻花 frp)等內網穿透/端口轉發時玩家連不上服務器(只看到 TCP 19132、UDP 端口隨機或只看到 7551),裝了 LeviLamina 的服務端該怎麼配置?
基岩版服務器仍然使用 UDP,只是新版默認傳輸方式變成了 NetherNet(底層類似 WebRTC)。當前版本(BDS 26.60.6 起 / LeviLamina 26.60.x)NetherNet 默認就只用 server.properties 裡 server-udp-ports 指定的單個 UDP 端口,不再需要 LeviLamina 的 singlePort 選項(該選項已刪除)。配置要點:
-
server.properties中server-port(TCP+UDP,默認 19132)與server-udp-ports(UDP,默認 19132)決定要開放的端口;穿透/映射時 TCP 和 UDP 都要轉發,且內外端口保持一致。 -
使用 frp 等內網穿透時,把公網地址直接寫進
server-udp-ports,格式為<公网IP>:<外部端口>:<本机端口>,例如:textserver-port=11451 server-udp-ports=203.0.113.4:11451:11451 -
同時在
mods/LeviLamina/config/Config.json的targeted.netherNetPatch中把"enable"設為false(關閉 LL 的 STUN 補丁);若 STUN 獲取公網 IP 失敗,客戶端會報錯誤代碼Door。 -
7551 是局域網(LAN)發現端口,與外網連接無關。
此外 server.properties 的 transport 項仍可切回 RakNet,此時只用 server-port,但 RakNet 將來可能被 Mojang 移除。官方教程:https://levimc.org/zh-Hant/tutorials/server/let-friends-join/
適用版本:BDS 26.60.6+;LeviLamina 26.60.1 及以上
NetherNet 協議下端口 TCP/UDP 都開放、控制台無報錯,玩家仍進不了服務器,瀏覽器訪問 IP:端口 出現備案攔截頁面;NetherNet 用於信令的 HTTP 服務能否與遊戲 UDP 不在同一臺機器,用海外節點/內網穿透反代來規避未備案攔截?
出現備案攔截頁說明雲服務商對未備案的 HTTP 流量做了攔截。NetherNet 走 server-port 的 TCP 部分(HTTP)只用於廣播 MOTD 及告知客戶端服務器的 IP 與端口,遊戲數據走 UDP,二者可以不在同一臺機器:可以給服務器/域名備案,或用海外服務器、內網穿透的海外 HTTP/HTTPS 隧道(或 easytier 之類組網工具)反向代理 HTTP 部分,遊戲 UDP 流量仍直連國內服務器。注意服務器對外地址需通過 server.properties 的 server-udp-ports=<公网IP>:<外部端口>:<本机端口> 指定(填數字 IP)。該問題與雲服務商策略相關。
適用版本:BDS 26.51 及以上(NetherNet 傳輸)。未能從源碼或文檔中直接證實,僅供參考。
LeviLamina 的 mod/插件加載順序怎麼決定?前置插件總在依賴它的插件之後加載導致加載失敗,怎麼調整?
LeviLamina 沒有手動排序加載順序的選項,加載順序由各 mod 目錄下 manifest.json 中聲明的依賴關係決定(拓撲排序;彼此沒有依賴關係的 mod 之間按名稱排序,但不要依賴這一點)。正確做法是讓插件作者在 manifest 裡寫好依賴;自己處理的話,在後加載的那個 mod 的 manifest.json 裡把前置寫進 dependencies:
"dependencies": [ { "name": "前置mod名" } ]字段名為小寫 dependencies,可選帶 "version": "^1.2.3" 之類的版本要求。
dependencies列表內的順序無所謂;被依賴的 mod 先加載。若依賴缺失、版本不匹配或加載失敗,依賴方會被阻止加載。- 現在的 LeviLamina 也支持
optionalDependencies(可選依賴:存在且版本匹配時先加載它,缺失也不阻止本 mod 加載)和loadBefore(聲明本 mod 要在某 mod 之前加載,但不建立依賴關係)。 - 給其他加載器(如 .NET 加載器、LSE)寫的插件,必須依賴對應加載器,否則先於加載器加載就會失敗/崩潰。
- 加載器類、庫類 mod 一般設置
"passive": true,只在被其他 mod 依賴時才加載。
不要靠每次在後臺手動執行 ll load <mod> 來補救,ll 命令權限也不建議放開(默認需要 Admin 權限)。
適用版本:LeviLamina 0.x 至 26.60.x(optionalDependencies/loadBefore 僅較新版本提供)
GMLIB、LRCA(GMLIB-LegacyRemoteCallApi)、iListenAttentively 等前置庫 mod 裝了卻沒有加載、也沒有日誌,或某個 mod 不會自動加載了,是什麼原因?manifest 裡的 "passive": true 是什麼意思?
manifest.json 中 "passive": true 表示被動加載:沒有其他 mod 在 manifest 中聲明依賴它時就不加載。庫/前置類 mod 通常這樣設置,所以單獨安裝、沒有任何依賴方時不加載屬於正常現象,並非不兼容。
- 安裝一個在 manifest 中聲明依賴它的 mod 後,它會被自動加載。
- 如果實際使用它的插件(例如某些 LSE 腳本插件,或漏寫依賴的庫)沒有在 manifest 中聲明依賴,它就不會被加載,或加載順序碰巧不對導致依賴方失敗(裝了別的聲明依賴的插件後又能用,只是碰巧)。根本解決辦法是由使用方在
manifest.json的dependencies中聲明該前置。 - 臨時辦法:把該前置 mod 的
manifest.json裡passive改為false或刪掉該字段,使其獨立加載。 - 注意
passive與插件本身的加載報錯(如未適配新版 BDS)無關,刪掉passive不能解決那類報錯,需等作者更新。
適用版本:LeviLamina 0.x 至 26.60.x
安裝 LeviLamina 後服務器控制台不顯示玩家聊天和玩家執行的命令,需要裝插件嗎?怎麼開啟?
不需要額外插件。LeviLamina 內置 simpleServerLogger 功能,但默認關閉(原版 BDS 本身不會在控制台記錄玩家聊天)。打開 mods/LeviLamina/config/Config.json(舊版路徑為 plugins/LeviLamina/config/Config.json;首次安裝時該文件不存在,需先啟動一次服務器生成),在 targeted 下找到 simpleServerLogger,把 "enabled" 改為 true,並保持需要的子項為 true:
"playerChat":玩家聊天,輸出形如[PlayerChat] <玩家> 消息"playerCommand":玩家執行的命令,[PlayerCmd]"playerPermission":玩家權限變更
保存後重啟服務器生效。當前 v26.60.8 的配置路徑為 mods/LeviLamina/config/Config.json,鍵位於 targeted.simpleServerLogger。
適用版本:LeviLamina 0.11 及以上
LeviLamina 服務器上玩家被踢出或退出後仍殘留在服務器裡(“幽靈玩家”,別人看到它一動不動、顯示在線,kick 也踢不掉,本人也無法重新進服),怎麼解決?
這是 LeviLamina 漏洞修復功能中“斷開連接時強制關閉連接”這一項(DisconnectClientHook)引起的副作用。可在 LeviLamina 配置文件 Config.json 中關閉這一項:
"targeted": {
"vulnerabilityFixes": {
"enable": true,
"disconnectClient": false
}
}配置文件位於 <服务端模组目录>/LeviLamina/config/Config.json(新版 lip 安裝為 mods/LeviLamina/config/Config.json;若服務端存在 plugins/ 目錄則為 plugins/LeviLamina/config/Config.json)。只關 disconnectClient 即可,不必把整個 vulnerabilityFixes.enable 關掉(那會同時關閉其他漏洞修復)。LeviLamina 1.9.5 及更早沒有單獨的 disconnectClient 開關(該開關在 1.9.6 拆分 vulnerabilityFixes 配置時加入),需要先升級。已經卡住的玩家需要重啟服務器才能清除。
適用版本:LeviLamina 1.9.6 及之後(含 26.60.x)
LeviLamina 下如何讓某個 mod 開服時不加載但不刪除它的文件?(例如某個 mod 與當前版本不匹配導致每次啟動都崩潰)
在該 mod 目錄(mods/<模组名>/)的 manifest.json 中加上 "passive": true,它就不會被主動加載,只在被其他 mod 依賴時才加載。也可以把該 mod 的 manifest.json 或整個 mod 文件夾重命名,LeviLamina 就識別不到它(啟動時可能會有提示)。如果崩潰是某個 mod(如 trace 日誌中出現的某 dll)版本與當前 LeviLamina 不匹配導致的,直接刪除或換成匹配版本即可。
LeviLamina 的 STUN 功能是做什麼的?關閉它或使用 frp 等穿透後插件獲取到的玩家 IP 變成 127.0.0.1 與之有關嗎?
STUN 是 LeviLamina 的 NetherNet 補丁(配置項 targeted.netherNetPatch,含 enable 與 stunServers,默認 ["stun:stun.l.google.com:19302", "stun:stun.miwifi.com:3478"])用來幫助服務端獲取自己的公網地址,有多個公網 IP 時會一起監聽,與獲取玩家 IP 無關。玩家 IP 變成 127.0.0.1 是因為使用了 frp 之類的轉發/穿透工具,服務端只能看到轉發端的地址,無法獲取玩家真實 IP。
適用版本:LeviLamina 26.60.x(帶 netherNetPatch)
同一臺機器上運行兩個 LeviLamina 服務端,開了 A 端後再開 B 端,B 端加載完就閃退,怎麼解決?
這是端口衝突。在兩個服務端的 server.properties 中把 enable-lan-visibility 設為 false(transport=raknet 時它會讓服務器強制綁定默認端口 19132/19133,即使你改了端口),並把各自的端口都改成互不相同的值:server-port、server-portv6,以及 transport=nethernet 時使用的 server-udp-ports。修改前先停止服務器。按此設置後(例如用 lip 部署兩個獨立的服務端文件夾)即可同時運行。
server.properties 已配置 transport=nethernet,但 LeviLamina 服務器啟動仍提示正在使用 raknet,為什麼?
這是 Glacie 插件導致的:當時版本的 Glacie 會強制開啟 raknet。卸載 Glacie 即可使用 NetherNet,或等待/更新到同時支持 raknet 與 nethernet 的 Glacie 版本。
適用版本:BDS 26.51 起;取決於 Glacie 版本。未能從源碼或文檔中直接證實,僅供參考。
LeviLamina 的配置裡沒有 resourcePackEncryptionMap(資源包加密)配置項,怎麼給資源包加密?
LeviLamina 本體沒有資源包加密功能(早期配置裡的 resourcePackEncryptionMap 是從 LL2 拷過來的遺留項,並未實現)。資源包加密由獨立插件 ResourcePackEncryption 提供:https://github.com/ShrBox/ResourcePackEncryption,可用 lip install github.com/ShrBox/ResourcePackEncryption 安裝。資源包可先用 PackCrypt 等工具加密,然後在插件配置的 "ResourcePacks" 中按 "uuid": "contentkey" 填寫密鑰;該插件還支持 "ResourcePacksCDN" 配置 CDN 下載地址。
適用版本:LeviLamina 0.8 至當前版本
LeviLamina 在不支持顏色輸出的控制台環境下會輸出亂碼顏色符號嗎?
不會。LL 的日誌格式化器會根據是否啟用彩色日誌(ColorLog,該開關由 PreLoader 提供)決定輸出方式:關閉彩色日誌後,LL 會自動去除消息和標題中的所有顏色/轉義符號再輸出。
LeviLamina 怎麼切換成中文(安裝中文語言包)?
用 lip 安裝 LeviLamina 時會自動把語言包 levilamina-loc 作為依賴裝到 mods/LeviLamina/lang/(含 zh_CN.json、zh_TW.json 等),無需手動刪除語言目錄。LeviLamina 的 mods/LeviLamina/config/Config.json 中 "language": "system" 表示跟隨系統語言,想強制中文可改為 "zh_CN"。如果語言包缺失,可單獨安裝:
lip install github.com/LiteLDev/levilamina-loc翻譯在 Crowdin(https://crowdin.com/project/levilamina)維護,可參與貢獻。注意部分 mod 自身輸出的文字是 mod 寫死的,語言包管不到。
適用版本:LeviLamina 26.x;levilamina-loc 1.7.x
LeviLamina 服務器(未用內網穿透,直接 IP+端口)客戶端無法正常連接,怎麼處理?
可能是服務器連不上 STUN 服務器導致(新版 BDS 走 NetherNet,LL 的 NetherNetPatch 會用 STUN 服務器讓 NAT 後的服務器告訴客戶端公網地址)。在 plugins/LeviLamina/config/Config.json 中把 targeted.netherNetPatch.stunServers 清空(默認是 "stun:stun.l.google.com:19302" 和 "stun:stun.miwifi.com:3478" 兩個,只支持 stun:/stuns: 開頭的 URI);然後在 server.properties 裡用 server-udp-ports=公网IP:公网端口:本地端口(例如 server-udp-ports=203.0.113.4:19489:19489)手動指定服務器公網地址。
26.51 至 26.60.0 版本中,公網地址用 LL 配置裡的 netherNetPatch.serverIP 設置。
適用版本:LeviLamina 26.60.1 及以上
LeviLamina 的控制台日誌時間戳精確到毫秒,能否通過配置改成只顯示到秒?
沒有現成的配置項。控制台格式在 LeviLamina 中寫死為 "{3:.3%T.} {2} {1} {0}"(帶 3 位毫秒)。只能自己寫 mod 通過日誌 API(Logger/Sink 的 setFormatter,配合 PatternFormatter)替換格式,或修改 LeviLamina 源碼重新編譯。
LeviLamina 的漏洞修復功能誤傷導致玩家被斷開等異常時,如何關閉?
在 plugins/LeviLamina/config/Config.json 中把 targeted.vulnerabilityFixes 下對應的單項設為 false,例如斷開連接相關的 disconnectClient。可單獨關閉的項有 subChunkRequest、itemReadUserData、disconnectClient、limitIPFrequency、simulatedPlayerChunkLoading;也可把 targeted.vulnerabilityFixes.enable 設為 false 整體關閉。改完後重啟服務器生效。更早版本只能整體關閉 vulnerabilityFixes。
適用版本:LeviLamina 2026-02 之後(拆分配置後)至 26.60.x
LeviLamina 配置文件中 commands 下的 crashCommand 選項是做什麼的?
modules.command.crashCommand 開啟(enabled: true)後會註冊一個 crash 命令(客戶端為 clicrash),執行後會讓服務器主動拋異常崩潰,用於測試崩潰處理/CrashLogger,可選參數 exceptionCode 指定異常碼。默認 enabled 為 false,正常服務器不需要開啟;permission 字段控制使用權限(默認 GameDirectors)。
適用版本:LeviLamina 0.11 至 26.60.x
Windows 上運行 LeviLamina/BDS 時控制台中文顯示亂碼,怎麼解決?
設置 → 時間和語言 → 語言 → 管理語言設置 → 更改系統區域設置 → 勾選“Beta 版: 使用 Unicode UTF-8 提供全球語言支持(U)”,然後重啟電腦。
適用版本:當前版本(Windows)。未能從源碼或文檔中直接證實,僅供參考。
ll show 展示的插件信息(作者、版本)在哪裡設置?在 manifest json 裡寫 Author 和 Version 沒生效。
在 mod 的 manifest.json 中設置,鍵名必須是小寫,例如 "author"、"version"(還有 "description" 等),寫成首字母大寫不會被識別。設置後執行 ll show <mod名> 即可看到。
適用版本:LeviLamina 0.9 至 26.60.x
修改 mod/插件的配置文件後不生效怎麼辦?
修改後要保存配置文件(建議用 VS Code 等編輯器而不是記事本,避免編碼/格式問題),然後重啟服務器,或在控制台執行 ll reload <mod名> 重載該 mod 才能生效。部分 mod 重載可能出問題,可改用 ll disable <mod名> 再 ll enable <mod名>,或 ll reactivate <mod名>;仍不行就重啟服務器。
適用版本:LeviLamina 1.x 及以上(當前 26.60.x)
如何讓非 OP 玩家也能使用 tpdim 等 LeviLamina 內置命令?
修改 plugins/LeviLamina/config/Config.json 中 modules.command 下對應命令的 permission,例如把 tpdimCommand 的 "permission": "GameDirectors" 改為 "Any",然後重啟服務器。
適用版本:LeviLamina 1.x 至 26.60.x
裝了 MOTD 修復插件後,在 server.properties 裡改了服務器名稱(MOTD),客戶端卻始終顯示其他內容,怎麼回事?
通常不是 MOTD 修復插件造成的。在控制台執行 ll list 查看已裝的 mod,一般是其他插件帶有動態 MOTD 功能覆蓋了 server.properties 中的 server-name,去該插件配置裡修改或關閉動態 MOTD。
適用版本:LeviLamina 所有版本。未能從源碼或文檔中直接證實,僅供參考。
服務器啟動後再附加調試器(如 Visual Studio / .NET 託管調試)附加不上,怎麼辦?
外置 CrashLogger 以調試器身份附加在 BDS 進程上,一個進程同一時間只能有一個調試器,所以其他調試器會附加失敗。不必刪除 CrashLogger,在 mods/LeviLamina/config/Config.json 中把 modules.crashLogger.enabled 設為 false(或把 builtin 設為 true 改用進程內的內置模式)後重啟服務器,再附加調試器;也可以直接用調試器啟動服務器,此時 CrashLogger 會自動不啟用。該案例中 .NET 託管調試還與編譯路徑有關,程序集需從調試構建輸出目錄加載才能正常附加。
適用版本:LeviLamina 當前版本,使用外置 CrashLogger 時
LeviLamina 服務器崩潰時會把崩潰日誌上傳到 Sentry,如何關閉上傳?
在 LeviLamina 配置文件 mods/LeviLamina/config/Config.json(舊安裝為 plugins/LeviLamina/config/Config.json)中,把 modules.crashLogger.uploadToSentry 設為 false:
"modules": {
"crashLogger": {
"uploadToSentry": false
}
}內置和外置 CrashLogger 都受此項控制(外置時不再傳 --enablesentry)。另外注意:若服務器配置了自動重啟但端口被佔用或重複啟動,會反覆崩潰並不斷上傳日誌,應先修復端口衝突/重複啟動問題。
適用版本:LeviLamina 當前版本
LeviLamina 控制台日誌沒有顏色(全是白色),在 LeviLamina 配置裡找不到 colorLog,怎麼開啟彩色日誌?
彩色日誌開關不在 LeviLamina 自己的配置裡,而在 PreLoader 的配置文件中:打開服務端根目錄的 PreLoaderConfig.json,把 "colorLog" 改為 true,重啟服務器即可恢復彩色輸出。
適用版本:LeviLamina 0.13.4 及以上至當前版本
使用 MCSManager 面板運行 LeviLamina 時,PreLoader 輸出後就看不到 BDS 的正常輸出,面板輸入命令也無效,怎麼辦?
需要虛擬 TTY,在 MCSManager 實例設置裡開啟“仿真終端”選項即可。
適用版本:LeviLamina 1.x 及以上,使用 MCSManager 面板時。未能從源碼或文檔中直接證實,僅供參考。
非 LeviLamina 插件(例如要在 PreLoader 階段加載的 DLL)應該怎麼寫 manifest?可以直接用 LL 插件的 manifest 嗎?
不要使用 LeviLamina 模組的 "type": "native"(那是由 LeviLamina 原生模組管理器加載的普通 C++ 模組)。需要由 PreLoader 在遊戲啟動前加載的 DLL,manifest 中應寫 "type": "preload-native":它會在遊戲啟動前、LeviLamina 的模組之前由 PreLoader 加載(LeviLamina 本身就是這種類型),LeviLamina 的模組註冊表會跳過這類清單,它們不算 LeviLamina 模組。
適用版本:LeviLamina 1.x 及以上(當前 26.60.x)