二、安装教程

环境要求

• 服务端类型：Paper（必须，不支持 Spigot）
• Minecraft 版本：1.17 或更高
• Java 版本：JDK 17（构建时需要）
• 硬件：推荐多核 CPU 以发挥并行生成优势

安装步骤

• 下载插件：从 [URL='https://www.spigotmc.org/resources/.84586']SpigotMC[/URL] 获取最新版本
• 放置插件：将 .jar 文件放入服务器的 plugins 文件夹
• 启动服务器：运行服务器一次以生成默认配置文件
• 验证安装：插件将自动创建 plugins/Iris/ 目录及相关配置

目录结构

plugins/Iris/
├── config.yml          # 主配置文件
├── dimensions/         # 维度包存储目录
└── worlds/            # 世界数据目录

三、基础配置

主配置文件 (config.yml)

# 核心设置
parallelGeneration: true      # 启用多核并行生成
maxThreads: 4                 # 最大生成线程数
studioMode: true              # 启用开发模式
autoUpdate: false             # 自动更新维度包

维度包管理

• 内置维度包：插件自带多个预设维度包
• 下载社区包：可从 GitHub 获取玩家分享的维度包
• 安装方法：将下载的维度包文件夹放入 plugins/Iris/dimensions/

四、指令列表（分类整理）

1. 世界管理指令

/iris create <世界名称> <维度包>  - 创建新的 Iris 世界
/iris tp <世界名称>              - 传送到指定世界
/iris worlds                     - 显示所有 Iris 世界列表
/iris delete <世界名称>          - 删除 Iris 世界

2. 生物群系指令

/iris biome goto <生物群系>      - 快速传送到指定生物群系
/iris biome locate <生物群系>    - 定位最近的生物群系
/iris biome list                 - 列出当前维度所有生物群系

3. 世界预生成指令

/iris pregen start <世界名称> -r <半径> -t <线程数>  - 启动预生成
/iris pregen pause                                              - 暂停预生成
/iris pregen resume                                             - 继续预生成
/iris pregen stop                                               - 停止预生成
/iris pregen status                                             - 查看预生成状态

• -r <半径>：预生成半径（区块数）
• -t <线程数>：使用的 CPU 线程数

4. 维度包开发指令（Studio 模式）

/iris studio open <维度包>       - 打开 Studio 模式进行实时编辑
/iris studio close               - 关闭 Studio 模式
/iris studio reload              - 重载 Studio 世界配置
/iris studio save                - 保存当前编辑

5. 物体定位指令

/iris goto <对象>                - 快速定位并传送到对象
/iris locate <结构/物体>         - 定位最近的结构或物体

6. 其他实用指令

/iris list                       - 列出所有可用维度包
/iris reload                     - 重载插件配置
/iris update                     - 检查并更新维度包
/iris version                    - 显示插件版本

五、世界预生成完整教程

为什么要预生成？

• 减少玩家探索时的延迟
• 避免实时生成导致的卡顿
• 提前发现生成问题

预生成命令详解

# 示例：为世界 "newworld" 预生成半径 5000 区块，使用 8 个线程
/iris pregen start newworld -r 5000 -t 8

最佳实践

• 线程数设置：建议设置为 CPU 核心数的 50%-75%
• 半径规划：根据玩家活动范围决定，通常 3000-10000 区块
• 分阶段生成：可多次执行不同半径的预生成
• 监控性能：使用 /iris pregen status 查看进度和 TPS 影响
• 定时任务：建议在低峰期进行预生成

预生成管理

• 暂停/恢复：可随时暂停，不影响服务器运行
• 停止：完全终止预生成任务
• 后台运行：预生成在后台异步执行

六、维度包开发入门

可自定义内容

• 生物群系：地形、植被、气候、颜色
• 地形生成器：山脉、峡谷、平原等
• 结构：建筑、遗迹、自然景观
• 洞穴系统：洞穴网络、熔岩湖
• 战利品表：箱子、怪物的掉落物
• 实体生成规则：生物刷新规则
• 装饰物：树木、岩石、地表细节

Studio 开发模式

• 进入 Studio：
  /iris studio open mypack
• 实时编辑：直接修改维度包文件
• 热重载：保存文件后自动应用更改
• 即时预览：在游戏中立即看到效果
• 退出 Studio：
  /iris studio close

项目结构示例

dimensions/mypack/
├── biomes/           # 生物群系定义
├── regions/          # 区域定义
├── structures/       # 结构文件
├── objects/          # 物体/装饰
├── generators/       # 地形生成器
└── pack.json         # 包配置文件

七、高级功能详解

1. 自定义生物群系颜色

• 支持内容：树叶、草、水体、天空、雾气
• 配置位置：在维度包的 biomes/ 文件中
• 数据包集成：通过资源包实现颜色覆盖

2. MCA 生成器（高性能核心）

• 性能提升：将生成速度从 15 区块/秒提升至 90+ 区块/秒
• 工作原理：利用多核 CPU 并行处理 MCA 文件
• 自动启用：在 Paper 服务端上自动优化

3. 自定义方块支持

• 兼容插件：Oraxen、ItemsAdder
• 集成方式：通过 API 自动识别自定义方块
• 应用场景：在结构中使用模组方块

4. 噪声生成器系统

• 内置生成器：50+ 种预设噪声类型
• 自定义方法：使用分形系统（Fracturing System）创建
• 应用场景：地形高度、生物群系分布、结构生成

5. 拼图结构系统（Jigsaw）

• 多对象组合：创建城镇、村庄等大型结构
• 自定义参数：生成规则、旗帜、物品
• 递归生成：结构内嵌套结构

6. 装饰系统（Decorator）

• 装饰目标：洞穴、地表、天空、熔岩
• 放置规则：任意位置、任意物品
• 密度控制：杂乱度、稀有度调节

八、性能优化建议

1. 充分利用多核

• 在 config.yml 中设置 maxThreads 为 CPU 核心数
• 预生成时使用最大线程数

2. 内存配置

• 为预生成分配足够内存（建议 8GB+）
• 在 paper.yml 中优化区块设置：

chunk-loading:
  max-concurrent-sends: 2
  autonomic-target-chunk-send-rate: 100.0

3. 预生成策略

• 先小半径测试，再大半径正式生成
• 定期检查 TPS，低于 15 时暂停

4. 维度包优化

• 减少不必要的装饰物密度
• 使用噪声生成器而非手动放置
• 合并小型结构为大型拼图结构

九、资源链接

• 插件下载：https://www.spigotmc.org/resources/.84586
• 官方文档（新）：https://docs.volmit.com/en/doc/iris
• 官方文档（旧）：https://old.docs.volmit.com/iris
• GitHub 仓库：https://github.com/VolmitSoftware/Iris
• 社区维度包：在 GitHub 搜索 "Iris dimension pack"

十、快速开始 checklist

• [ ] 确认使用 Paper 1.17+ 服务端
• [ ] 安装 Iris 插件并重启服务器
• [ ] 运行 /iris list 查看可用维度包
• [ ] 创建测试世界：/iris create test overworld
• [ ] 进入世界：/iris tp test
• [ ] 预生成 1000 区块测试：/iris pregen start test -r 1000 -t 4
• [ ] 尝试 Studio 模式：/iris studio open overworld
• [ ] 修改配置文件体验热重载