Iris - 地形生成插件

[HEADING=1]二、安装教程[/HEADING]
[HEADING=2]环境要求[/HEADING]
[LIST]
[*][B]服务端类型[/B]：Paper（必须，不支持 Spigot）
[*][B]Minecraft 版本[/B]：1.17 或更高
[*][B]Java 版本[/B]：JDK 17（构建时需要）
[*][B]硬件[/B]：推荐多核 CPU 以发挥并行生成优势
[/LIST]
[HEADING=2]安装步骤[/HEADING]
[LIST=1]
[*][B]下载插件[/B]：从 [URL='https://www.spigotmc.org/resources/.84586']SpigotMC[/URL] 获取最新版本
[*][B]放置插件[/B]：将 .jar 文件放入服务器的 plugins 文件夹
[*][B]启动服务器[/B]：运行服务器一次以生成默认配置文件
[*][B]验证安装[/B]：插件将自动创建 plugins/Iris/ 目录及相关配置
[/LIST]
[HEADING=2]目录结构[/HEADING]
[CODE]plugins/Iris/
├── config.yml # 主配置文件
├── dimensions/ # 维度包存储目录
└── worlds/ # 世界数据目录[/CODE]

[HEADING=1]三、基础配置[/HEADING]
[HEADING=2]主配置文件 (config.yml)[/HEADING]
[CODE]# 核心设置
parallelGeneration: true # 启用多核并行生成
maxThreads: 4 # 最大生成线程数
studioMode: true # 启用开发模式
autoUpdate: false # 自动更新维度包[/CODE]

[HEADING=2]维度包管理[/HEADING]
[LIST]
[*][B]内置维度包[/B]：插件自带多个预设维度包
[*][B]下载社区包[/B]：可从 GitHub 获取玩家分享的维度包
[*][B]安装方法[/B]：将下载的维度包文件夹放入 plugins/Iris/dimensions/
[/LIST]
[HR][/HR]
[HEADING=1]四、指令列表（分类整理）[/HEADING]
[HEADING=2]1. 世界管理指令[/HEADING]
[CODE]/iris create <世界名称> <维度包> - 创建新的 Iris 世界
/iris tp <世界名称> - 传送到指定世界
/iris worlds - 显示所有 Iris 世界列表
/iris delete <世界名称> - 删除 Iris 世界[/CODE]

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

[HEADING=2]3. 世界预生成指令[/HEADING]

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

[B]参数说明[/B]：
[LIST]
[*]-r <半径>：预生成半径（区块数）
[*]-t <线程数>：使用的 CPU 线程数
[/LIST]
[HEADING=2]4. 维度包开发指令（Studio 模式）[/HEADING]
[CODE]/iris studio open <维度包> - 打开 Studio 模式进行实时编辑
/iris studio close - 关闭 Studio 模式
/iris studio reload - 重载 Studio 世界配置
/iris studio save - 保存当前编辑[/CODE]

[HEADING=2]5. 物体定位指令[/HEADING]
[CODE]/iris goto <对象> - 快速定位并传送到对象
/iris locate <结构/物体> - 定位最近的结构或物体[/CODE]

[HEADING=2]6. 其他实用指令[/HEADING]

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

[HEADING=1]五、世界预生成完整教程[/HEADING]
[HEADING=2]为什么要预生成？[/HEADING]
[LIST]
[*]减少玩家探索时的延迟
[*]避免实时生成导致的卡顿
[*]提前发现生成问题
[/LIST]
[HEADING=2]预生成命令详解[/HEADING]

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

[HEADING=2]最佳实践[/HEADING]
[LIST=1]
[*][B]线程数设置[/B]：建议设置为 CPU 核心数的 50%-75%
[*][B]半径规划[/B]：根据玩家活动范围决定，通常 3000-10000 区块
[*][B]分阶段生成[/B]：可多次执行不同半径的预生成
[*][B]监控性能[/B]：使用 /iris pregen status 查看进度和 TPS 影响
[*][B]定时任务[/B]：建议在低峰期进行预生成
[/LIST]
[HEADING=2]预生成管理[/HEADING]
[LIST]
[*][B]暂停/恢复[/B]：可随时暂停，不影响服务器运行
[*][B]停止[/B]：完全终止预生成任务
[*][B]后台运行[/B]：预生成在后台异步执行
[/LIST]
[HR][/HR]
[HEADING=1]六、维度包开发入门[/HEADING]
[HEADING=2]可自定义内容[/HEADING]
[LIST]
[*][B]生物群系[/B]：地形、植被、气候、颜色
[*][B]地形生成器[/B]：山脉、峡谷、平原等
[*][B]结构[/B]：建筑、遗迹、自然景观
[*][B]洞穴系统[/B]：洞穴网络、熔岩湖
[*][B]战利品表[/B]：箱子、怪物的掉落物
[*][B]实体生成规则[/B]：生物刷新规则
[*][B]装饰物[/B]：树木、岩石、地表细节
[/LIST]
[HEADING=2]Studio 开发模式[/HEADING]
[LIST=1]
[*][B]进入 Studio[/B]：
/iris studio open mypack


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

[/LIST]
[HEADING=2]项目结构示例[/HEADING]
[CODE]dimensions/mypack/
├── biomes/ # 生物群系定义
├── regions/ # 区域定义
├── structures/ # 结构文件
├── objects/ # 物体/装饰
├── generators/ # 地形生成器
└── pack.json # 包配置文件[/CODE]

[HEADING=1]七、高级功能详解[/HEADING]
[HEADING=2]1. 自定义生物群系颜色[/HEADING]
[LIST]
[*][B]支持内容[/B]：树叶、草、水体、天空、雾气
[*][B]配置位置[/B]：在维度包的 biomes/ 文件中
[*][B]数据包集成[/B]：通过资源包实现颜色覆盖
[/LIST]
[HEADING=2]2. MCA 生成器（高性能核心）[/HEADING]
[LIST]
[*][B]性能提升[/B]：将生成速度从 15 区块/秒提升至 90+ 区块/秒
[*][B]工作原理[/B]：利用多核 CPU 并行处理 MCA 文件
[*][B]自动启用[/B]：在 Paper 服务端上自动优化
[/LIST]
[HEADING=2]3. 自定义方块支持[/HEADING]
[LIST]
[*][B]兼容插件[/B]：Oraxen、ItemsAdder
[*][B]集成方式[/B]：通过 API 自动识别自定义方块
[*][B]应用场景[/B]：在结构中使用模组方块
[/LIST]
[HEADING=2]4. 噪声生成器系统[/HEADING]
[LIST]
[*][B]内置生成器[/B]：50+ 种预设噪声类型
[*][B]自定义方法[/B]：使用分形系统（Fracturing System）创建
[*][B]应用场景[/B]：地形高度、生物群系分布、结构生成
[/LIST]
[HEADING=2]5. 拼图结构系统（Jigsaw）[/HEADING]
[LIST]
[*][B]多对象组合[/B]：创建城镇、村庄等大型结构
[*][B]自定义参数[/B]：生成规则、旗帜、物品
[*][B]递归生成[/B]：结构内嵌套结构
[/LIST]
[HEADING=2]6. 装饰系统（Decorator）[/HEADING]
[LIST]
[*][B]装饰目标[/B]：洞穴、地表、天空、熔岩
[*][B]放置规则[/B]：任意位置、任意物品
[*][B]密度控制[/B]：杂乱度、稀有度调节
[/LIST]
[HR][/HR]
[HEADING=1]八、性能优化建议[/HEADING]
[HEADING=2]1. 充分利用多核[/HEADING]
[LIST]
[*]在 config.yml 中设置 maxThreads 为 CPU 核心数
[*]预生成时使用最大线程数
[/LIST]
[HEADING=2]2. 内存配置[/HEADING]
[LIST]
[*]为预生成分配足够内存（建议 8GB+）
[*]在 paper.yml 中优化区块设置：
[/LIST]

[CODE]chunk-loading:
max-concurrent-sends: 2
autonomic-target-chunk-send-rate: 100.0[/CODE]

[HEADING=2]3. 预生成策略[/HEADING]
[LIST]
[*]先小半径测试，再大半径正式生成
[*]定期检查 TPS，低于 15 时暂停
[/LIST]
[HEADING=2]4. 维度包优化[/HEADING]
[LIST]
[*]减少不必要的装饰物密度
[*]使用噪声生成器而非手动放置
[*]合并小型结构为大型拼图结构
[/LIST]
[HR][/HR]
[HEADING=1]九、资源链接[/HEADING]
[LIST]
[*][B]插件下载[/B]：[URL]https://www.spigotmc.org/resources/.84586[/URL]
[*][B]官方文档（新）[/B]：[URL]https://docs.volmit.com/en/doc/iris[/URL]
[*][B]官方文档（旧）[/B]：[URL]https://old.docs.volmit.com/iris[/URL]
[*][B]GitHub 仓库[/B]：[URL]https://github.com/VolmitSoftware/Iris[/URL]
[*][B]社区维度包[/B]：在 GitHub 搜索 "Iris dimension pack"
[/LIST]
[HR][/HR]
[HEADING=1]十、快速开始 checklist[/HEADING]
[LIST=1]
[*][ ] 确认使用 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
[*][ ] 修改配置文件体验热重载
[/LIST]
[HR][/HR]
[B]提示[/B]：首次使用建议先熟悉预设维度包，再尝试自定义开发。预生成是获得流畅体验的关键步骤，切勿忽略！