跳到正文
本頁目錄

MoreDimensions

MoreDimensions 創建的自定義維度能刪除/卸載嗎?想把某個維度當資源世界定期重置該怎麼做?維度什麼時候註冊?

MoreDimensions 沒有提供刪除或卸載維度的接口(維護者明確表示不提供存檔層刪除維度數據的接口,交給存檔編輯工具處理),LSE 腳本更做不到。維度的註冊信息記錄在存檔目錄下的 dimension_config.json,區塊等數據存放在存檔的 LevelDB(db)中;只從代碼裡去掉註冊、或只刪配置,都不會刪除已生成的數據,運行時刪 key 保存後也會被寫回。

維度註冊:CustomDimensionManager::addDimension / addSimpleDimension 要求 Level 已存在(否則拋 std::runtime_error),官方測試代碼是在 ll::event::ServerStartedEvent 裡註冊的,不要放在 mod 的 load 階段。

如果要重置某個維度,只能離線操作:停服並備份存檔,然後用支持 Bedrock LevelDB 的工具刪除該維度的區塊數據。注意 MC 的 LevelDB 是 Mojang 修改版(支持 zlib 壓縮),不能直接用原版 Google leveldb 讀寫,值為 NBT。區塊 key 格式:4 字節 x(int32 LE)+ 4 字節 z +(非主世界時)4 字節維度 id + 1 字節記錄類型 + 可選 1 字節子區塊索引。可以藉助 Amulet(amulet.load_level)等第三方存檔工具,或自己寫 native 插件處理。

另外,多維度的額外開銷主要來自給玩家發送該維度的數據;維度越多服務器越卡。生成器可以是原版的主世界/下界/末地/超平坦/虛空,也可以自己寫 C++ 生成器,但無法直接加載 addon 定義的自定義群系維度。

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

MoreDimensions 有沒有導出接口給 LSE(JS)腳本調用來註冊/創建維度?文檔在哪?

沒有。MoreDimensions 只提供 C++ API(more_dimensions::CustomDimensionManager),沒有 RemoteCall 導出,LSE 也沒有內置註冊維度的接口,所以需要寫 C++ native mod 調用它。文檔見 https://github.com/LiteLDev/MoreDimensions/wiki。即使導出,也只能方便地創建原版生成器類型的維度(虛空、超平坦、主世界、下界、末地)。不會寫 C++ 的話可以用社區基於它做的 JSON 配置型輔助 mod(如 more-dimension-helper-json)。

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

LeviLamina 的多維度(MoreDimensions)怎麼用?裝上後能直接用指令創建新維度嗎?有沒有參考實現/現成的維度 mod?進入新維度和傳送門怎麼做?

MoreDimensions(https://github.com/LiteLDev/MoreDimensions)是一個庫/前置,本身不會添加維度,也沒有創建維度的指令;需要其他 mod 調用它的 API。安裝:lip install github.com/LiteLDev/MoreDimensions(當前版本需要 LeviLamina 26.60.7 及以上、低於 26.61.0,服務端和客戶端均有構建)。

開發者用法:在自己的 native mod 裡依賴 more-dimensions,Level 可用後(例如 ServerStartedEvent)調用:

cpp
more_dimensions::CustomDimensionManager::getInstance()
    .addSimpleDimension("myns:my_flat", 345, GeneratorType::Flat);

維度名必須是 namespace:name 形式且不能用 minecraft 命名空間;原版生成器支持 Overworld/Flat/Nether/TheEnd/Void,自定義生成器需繼承 Dimension 並用 addDimension<D>(name, args...)。文檔見 wiki,示例見倉庫 src/test/TestCustomDimension.cpp;Actions 中以 -tests 結尾的構建會創建 7 個測試維度,僅供測試。社區參考實現:more-dimension-helper及其 JSON 版(MineBBS 上的 more-dimension-helper-json,通過 JSON 配置創建維度,不支持熱創建)。

進入維度:用 LeviLamina 內置的 tpdim 命令,如 tpdim ~ ~ ~ <维度名>。原版那樣的傳送門無法直接實現,可用 addon 註冊傳送門樣式的方塊,玩家觸發後執行傳送命令。

適用版本:MoreDimensions v0.14.0 及以上(addSimpleDimension);當前 v0.16.0 / LeviLamina 26.60.x

LeviLamina 下能否在一個 BDS 裡有多個世界(資源世界+生存世界、大廳+小遊戲等)?有什麼限制?

BDS 本身不支持多世界。LeviLamina 下可以用 MoreDimensions 在同一存檔裡增加自定義維度來近似實現(lip install github.com/LiteLDev/MoreDimensions,它只是 API,需要配合調用它的 mod,如社區的 more-dimension-helper-json),新維度可按主世界/下界/末地/超平坦/虛空生成。限制:

  1. 不能刪除已創建的維度;
  2. 所有維度共用同一個存檔、同一組行為包/資源包,無法給不同維度加載不同材質包;
  3. 所有維度都在同一服務器進程/主線程中運行,維度越多壓力越大。

需要隔離資源包或減輕負載時,更推薦開多個 BDS(端口需不同,包括 IPv6 端口),配合跨服傳送與數據同步插件。

適用版本:MoreDimensions 當前版本(v0.16.0)

進入 MoreDimensions 自定義維度後怎麼傳送回主世界/在維度間傳送?tpdim 還能用嗎?

LeviLamina 內置了 teleportdim 命令(別名 tpdim),可在任意維度(包括自定義維度)間傳送:

text
tpdim <x y z> <维度> [convert]
tpdim <目标选择器> <x y z> <维度> [convert]

第一種形式傳送自己,第二種傳送目標。維度可填 overworld/nether/the_end 或自定義維度名,convert(默認 true)會按下界比例換算座標。該命令可在 LeviLamina 配置 modules.command.tpdimCommand 中開關並設置權限(默認啟用,權限 GameDirectors)。回主世界也可以用原版命令 execute in overworld run tp @s ~ ~ ~。

適用版本:LeviLamina 當前版本(26.60.x)

在事件或數據中序列化維度信息時,應該存維度 id 還是維度名字?要考慮 MoreDimensions 的自定義維度。

應存維度名字。自定義維度的 id 不由開發者指定,而是由 MoreDimensions/遊戲在註冊時分配(當前版本會優先複用存檔中已持久化的名字-id 映射,但並不保證在不同存檔、註冊順序變化或配置變更後保持一致),所以持久化時存名字,需要時再用 VanillaDimensions::fromString(name) 轉成 DimensionType、VanillaDimensions::toString(dimId) 反查名字(MoreDimensions 的 getDimensionIdFromName 已棄用)。原版維度 id 固定:0 主世界、1 下界、2 末地。

適用版本:MoreDimensions 當前版本(v0.16.0)

MoreDimensions 創建新維度時,地形生成器只能用 Mojang 內置的那幾種嗎?有沒有預設模板?

MoreDimensions 只是前置庫,沒有預設的維度模板或玩法。簡單用法 addSimpleDimension 只支持原版生成器類型(Overworld/Flat/Nether/TheEnd/Void)。想要自定義地形就要自己寫 C++ 生成器(繼承 Dimension 並用 addDimension<D>() 註冊),可參考倉庫 src/test/generator 下的示例(flat-gen-village 超平坦生成村莊、generator-terrain 自定義地形 NxnBorderTerrain),或第三方地皮插件 PlotCraft 的 DefaultGenerator。自定義群系、山體等複雜地形需要自行研究噪聲生成。

適用版本:MoreDimensions 當前版本(v0.16.0)

MoreDimensions(多維度)能創建超平坦維度嗎?

可以,超平坦是最容易實現的類型:

cpp
CustomDimensionManager::getInstance().addSimpleDimension("myns:flat", 345, GeneratorType::Flat);

測試構建中的 custom_dim:new_flat_type 就是超平坦維度。注意維度越多服務器負擔越大。

適用版本:MoreDimensions v0.14.0 及以上

用 MoreDimensions 創建的自定義維度能否自定義天空盒、或者讓不同維度有不同的時間?

無法通過服務端實現。客戶端按維度類型渲染天空,服務端不發送天空材質,想改天空只能靠資源包。時間是全局的(time 命令沒有維度選項);理論上可以偽造發給客戶端的時間包,但服務端刷怪等邏輯仍按真實時間,實際不可行。

未能從源碼或文檔中直接證實,僅供參考。

在 MoreDimensions 創建的自定義維度中使用 /locate 會導致服務器假死(卡住),怎麼解決?

自定義維度裡沒有對應結構,BDS 的 locate 實現沒有處理這種情況會陷入死循環。解決方案:禁止在非原版維度使用 /locate(例如攔截命令),或者自行實現結構查找。

適用版本:LeviLamina 1.0.x(BDS 1.21.50 時報告,之後版本未確認)。未能從源碼或文檔中直接證實,僅供參考。

按照 MoreDimensions wiki 的 SimpleExample 教程編寫自定義維度 mod,xmake 構建失敗,怎麼辦?

wiki 的 SimpleExample 示例代碼用到了 EventBus 但沒有包含其頭文件,需要補充 #include "ll/api/event/EventBus.h"。另外從 MoreDimensions 0.14.0 起不再導出 SimpleCustomDimension,wiki 裡的 addDimension<more_dimensions::SimpleCustomDimension>("name", 345, GeneratorType::Flat) 寫法應改為 more_dimensions::CustomDimensionManager::getInstance().addSimpleDimension("name", 345, GeneratorType::Flat);(參考倉庫 src/test/TestCustomDimension.cpp)。文檔見 https://github.com/LiteLDev/MoreDimensions/wiki

適用版本:MoreDimensions 當前版本(0.16.0)及 wiki SimpleExample 現狀

MoreDimensions(更多維度)暫未適配新版本,先停用插件等更新,已建造在額外維度裡的建築會丟失嗎?需要注意什麼?

維度數據保存在存檔裡,停用插件後等更新再裝即可;但務必保留存檔目錄中的 MoreDimensions 維度配置文件 worlds/<存档名>/dimension_config.json(客戶端為對應世界目錄下的 dimension_config.json),它記錄了維度名與 ID 的對應關係,丟失後重新啟用時維度無法對應。

適用版本:當前所有版本(MoreDimensions 0.16.0)