Iris - 維度引擎
GITHUB • DOCUMENTATION • DISCORD
Overview - What Iris does
Iris 替代了區塊生成器。地形、生物群系、洞穴、結構、物件、實體和戰利品都來自於一個專案包：一個可編輯、版本控制和分享的可讀 JSON 資料夾。
地形和區域 通過區域定義組合土地、海洋、海岸和洞穴生物群系，每個都有自己的形狀、高度和表面行為。
生物群系設置 調色板、顏色、裝飾物、生成、天氣，以及設置生物群系所佔高度帶的生成器連結。
洞穴雕刻 洞穴形狀、輪廓和維度雕刻，帶有自己的調色板和裝飾物的洞穴生物群系。
物件 放置帶有旋轉、縮放、標記、戰利品和查找替換規則的物件檔案，共有 20 種放置模式。
結構 在遊戲中構建和編輯拼圖結構，或將原版和數據包結構導入到您的包中作為可編輯資源。
噪音和表達式 使用噪音樣式、圖像地圖或算術表達式驅動生成器，並選擇其值的插值方式。
裝飾物和礦藏 表面、天花板、海岸線和流體細節，以及重新映射到其他區塊的礦藏。
程序化物件 從包 JSON 生成的樹木、廢墟、地形、珊瑚、真菌和水晶，每個都是一個種子池的確定性變體。
實體和戰利品 實體生成、裝備、屬性、乘客，以及替換其原版掉落的戰利品表。
預生成 使用磁碟快取生成您的世界，以便稍後恢復並實時更新進度。
安裝
Iris 在第一次啟動時不會安裝任何包 選擇您想要安裝的包。
安裝 將 jar 檔放入 plugins/ 並啟動伺服器。 (不會下載任何東西，也不會為您創建世界)
添加包 執行以下命令之一。
重啟一次。 確保在安裝包後重啟伺服器，以便它可以安裝數據包。
/iris download pack=overworld 安裝內建的 overworld 包
/iris download pack=underworld 安裝內建的 underworld 包
/iris download link=<zip-url> 從直接檔案 URL 安裝提供 pack 或 link。 link 必須直接指向一個檔案 URL。
喜歡離線操作？ 將包直接解壓到 plugins/Iris/packs/<name>/ 手動操作。其餘部分相同。
一旦包安裝並且伺服器已重啟：
/iris create <name> type=<pack> seed=<long> 創建一個來自包的世界
/iris replace <world> type=<pack> 將現有世界設置為 Iris
/iris tp <world> 傳送到它命令和權限
根命令是 /iris。 別名： /ir、 /irs。
世界
/iris create <name> type=<pack> seed=<long> 創建一個來自包的世界
/iris replace <world> type=<pack> 將現有世界設置為 Iris
/iris tp <world> 傳送到一個世界
/iris what region 報告您所站的區域預生成
/iris pregen start <radius> center=<x,z> 開始一個預生成工作
/iris pregen pause 暫停或恢復
/iris pregen stop 停止正在進行的工作
/iris pregen status 進度、速率和剩餘時間工作室
/iris studio create name=<name> template=<pack> 開始一個新包
/iris studio open <dimension> seed=<long> 在工作室世界中打開一個包
/iris studio vscode dimension=<pack> 寫入編輯器工作區
/iris studio close 關閉並丟棄工作室世界包和診斷
/iris download pack=overworld 安裝內建的包
/iris pack validate 驗證已安裝的包
/iris find biome <biome> 定位並前往一個生物群系
/iris dev goldenhash radius=8 檢查生成的確定性權限
iris.all 整個命令樹 default: op
iris.treefeller 可選的樹木砍伐者 default: op可選參數必須是鍵值對 在插件中，任何帶有默認值的參數只能以 key=value 的形式提供；所需參數按顯示的順序填充。
/iris create MyWorld 有效
/iris create MyWorld type=overworld 有效
/iris create MyWorld overworld 失敗
/iris studio open overworld seed=1337 有效
/iris studio open overworld 1337 失敗工作室 - 創建包
工作室是一個功能齊全的開發環境，用於創建世界。拼圖和物件工作室是創建物件和拼圖的簡單方法。
一次性世界 每個工作室世界的名稱為 iris-<uuid> 並在創造模式中打開，天氣和時間凍結。關閉它會刪除世界並自動保存您的工作。
包即時加載 保存包檔案將自動將更改即時加載到您的世界生成中。
拼圖工作室 遊戲中的結構編輯器：工作單元、池、片段和連接器、分頁菜單、粒子輪廓等。
原版數據包 將註冊的原版拼圖結構轉換為您自己的可編輯片段，重建它，然後將結果導出為原版數據包。
註冊感知的架構 打開 VSCode 會為每個 JSON 資源類型寫入 JSON 架構，從實時伺服器註冊表中填充，因此模組區塊和生物群系與原版區塊一起完成。
物件工具鏈 一個在物品本身中攜帶選擇的魔杖，粘貼和撤銷、縮小和合理化，還有一個將每個物件排列在框架網格上的工作室世界。
包資料夾
plugins/Iris/packs/<name>/
dimensions/ regions/ biomes/ generators/
objects/ loot/ entities/ images/包是一個普通的資料夾。複製它、版本控制或分享它。總共有十七種資源類型；上述八種是您將使用的一些。
React 整合 - 監控內容
使用我們的插件 React 與 Iris 一起使用，以便進行更深入的監控，無需額外配置，React 將自動從 Iris 獲取數據。
React 從 Iris 獲取 69 個實時指標的數據
引擎生命週期 引擎活動、關閉、失敗和在工作室中、待註冊、即時加載
生成活動 本次會話和整個生命週期的區塊、每秒區塊數、每秒區塊更新、引擎並行性、活動生成租約
每階段計時 總計、地形、生物群系、洞穴、裝飾、礦藏、後處理、完美、更新、雕刻解析、雕刻應用和上下文預填
Mantle 健康 常駐和排隊的構造板、閒置最小值、平均值和最大值、堆積使用、回收緊迫性
快取 計數、條目、容量和使用情況，分為四個層級：資源、2D 流、3D 流和其他
預生成 活動、暫停、進度、生成、總計、隊列、吞吐量、預計時間、經過時間和失敗，以及許可和自適應等待時間
世界加載 已加載的區塊、已加載的實體和實體飽和度
PlaceholderAPI
Iris 擁有多種佔位符，您可以在 PlaceholderAPI 存在時掛接。
%iris_available% Terrain 服務是否啟用
%iris_world.available% 玩家是否在 Iris 世界中
%iris_world.biome% 表面生物群系顯示名稱
%iris_world.biome-key% 表面生物群系加載鍵
%iris_world.region% 區域顯示名稱
%iris_world.region-key% 區域加載鍵
%iris_world.dimension% 玩家世界的包加載鍵
%iris_pregen.available% 當預生成工作運行時為真
%iris_pregen.world% 正在預生成的世界
%iris_pregen.percent% 預生成工作的百分比
%iris_pregen.eta% 預生成的剩餘時間（秒）
%iris_pregen.eta-text% 同樣的估算為 2m 5s 或 1h 30m
%iris_pregen.chunks% 到目前為止生成的區塊
%iris_pregen.total% 工作中剩餘的區塊
%iris_pregen.chunks-per-second% 每秒生成的區塊數
%iris_pregen.paused% 如果預生成已暫停相容性 - 運行時和 Java
Iris 支援 Paper、Purpur、Leaf、Folia、Canvas 和 Spigot，適用於 Java 25 的 Minecraft 26.x+
PlaceholderAPI 是可選依賴
React 從 Iris 獲取 69 個實時指標的數據：網格對等體、遠端傳送門、最差對等體的往返時間、進出線的位元組、壓縮比、側帶積壓、視圖訂閱、複製的區塊、重新同步和傳輸計數
