本文件随模组版本同步更新。当前版本对应 1.4.0.14009.1000.li_prerelease_im。

---

1. 兼容性

1.1. 已知不兼容模组
与以下模组同时加载将导致世界生成冲突或运行时崩溃：

· Epic Terrain
· Reterraforged
· Terraforged
· Big Globe

---

2. Mojang 旧版世界升级机制

2.1. 地形平滑强制触发
当您将低于 1.17 版本的存档升级至 1.21 并加载本模组时，Mojang 内置的地形平滑算法将被强制激活。

2.2. 已知表现

· 村庄结构悬空
· 河流被平滑为静水体，伴生地形隆起

2.3. 深层处理行为
Y= -64 及以下所有方块将被替换为空气。
⚠️ 历史遗留行为
此机制在未发布版本 1.3.0.10231.768 中曾随高度限制调整而扩展。当前版本下，从 1.17.1 升级至 1.21.10 的存档，Y= -64 及以下方块仍会被无条件清除。旧版本中 Y= -128 层及以下的处理逻辑相同。

2.4. 反馈限制
上述现象由模组环境触发，非原版漏洞。请勿提交至 Mojang 官方追踪系统。

---

3. Android 平台兼容说明

3.1. 推荐运行配置

· 渲染器：用系统的Vulkan驱动（1.3.278以上就行了）
· 建议搭配性能优化模组使用

3.2. 性能不保证设备列表
以下硬件因性能不足，无法保证流畅运行：

· 骁龙 4 系、骁龙 6 系
· 高通骁龙8Gen3及以下 骁龙7+ Gen3及以下 骁龙7Gen4及以下 骁龙7s Gen4及以下
· 初代酷睿及更旧英特尔处理器
· 核显压根没有Vulkan1.3的显卡

---

4. 版本升级风险声明

4.1. 【严重】1.0.0 → 1.1.0
如您在旧存档中使用 Canyon_and_cliffs_and_biome 1.0.0，严禁直接升级至 1.1.0。新旧区块交界处将产生不可修复的地形断裂。

4.2. 1.2.0 beta.1 及后续版本
自该版本起，地形生成代码已全面重构。不再兼容 Minecraft 1.21.9 以下版本。部分漏洞已修复。

4.3. 旧版已知缺陷
1.2.0 前版本中，紫水晶洞与湖泊生成存在崩溃风险。

4.4. 含水层噪声缺陷（已修复）
自 1.0.0 起，含水层噪声生成器存在位置与形态异常。此问题已修复。

4.5. 1.2.0 RC.1 洞穴算法变更
该版本更改洞穴生成算法。升级后，已生成区块中的洞穴可能出现错位或接缝。

4.6. 1.2.0 RC.2 代码库重构
世界生成及 JSON 代码库部分重构。升级后新旧区块间可能存在地形偏差。  （build 1.3.0.10231.1000 已修复）

---

5. 巨型生物群系世界类型

5.1. 支持状态
当前版本对“巨型生物群系”的修改尚未完整实现。

5.2. 升级影响
升级至 1.2.0 beta.1 后，新生成区块地形将出现异常。

5.3. 含水层问题
同 4.4，该世界类型下含水层生成亦存在相同缺陷。（build 1.3.0.10231.1000 已修复）

5.4. 特定群系缺陷

· 巨型生物群系中，沼泽地下广泛分布异常含水层
· 温水深海、冷水深海等群系存在同类问题
  （build 1.3.0.10231.1124 已修复）

5.5. 放大化世界类型
支持存在缺陷，修复周期预估较长。
（build 1.3.0.10231.1124 已支持）

---

6. 噪声生成器重构（自 1.3.0-Insider-Preview.2025-11-22）

6.1. 变更目的与性能影响
为根治含水层问题，引入多组新洞穴噪声。
当前代价：地形生成速度较此前版本下降约 2–3 倍。
（build 1.3.0.10231.1000 已删除此项代码）

---

7. 地形生成机制重大调整（自 1.3.0-Insider-Preview.2025-11-22）

7.1. 调整内容

· 生物群系规模扩大，分布逻辑更趋近真实地理
· 沼泽等群系生成频率降低、形态更完整
· 温度参数同步校准

7.2. 兼容性影响

· 此版本与 Canyon_and_cliffs_and_biome 1.2.0 及更早版本完全不兼容
· 后续预览版（2025-11-23、2025-11-27、2025-12-02）因算法持续重构，各版本间互不兼容

7.3. 后续版本说明
自 1.3.0-beta.3 起，地形生成代码再次完全重写。
7.1 条描述内容已不适用于该版本及后续版本，但版本间不兼容警告仍有效。
（build 1.3.0.10231.1124 已再次微调代码）

7.4. build 1.3.0.10231.1124 变更
本版本未重构核心代码，但引入类侵蚀算法的伪代码实现，以下为当前版本实际运行的 JSON 噪声配置片段：

7.4.json
{
    "type": "minecraft:min",
    "argument1": {
        "type": "minecraft:mul",
        "argument1": 0.283,
        "argument2": {
            "type": "minecraft:add",
            "argument1": {
                "type": "minecraft:flat_cache",
                "argument": {
                    "type": "minecraft:invert",
                    "argument": {
                        "type": "minecraft:add",
                        "argument1": {
                            "type": "minecraft:abs",
                            "argument": {
                                "type": "minecraft:shifted_noise",
                                "noise": "minecraft:ridge",
                                "shift_x": "minecraft:shift_x",
                                "shift_y": {
                                    "type": "minecraft:mul",
                                    "argument1": 200,
                                    "argument2": "minecraft:overworld/erosion"
                                },
                                "shift_z": "minecraft:shift_z",
                                "xz_scale": 0.163,
                                "y_scale": 0.0
                            }
                        },
                        "argument2": 0.1
                    }
                }
            },
            "argument2": {
                "type": "minecraft:abs",
                "argument": {
                    "type": "minecraft:shifted_noise",
                    "noise": "minecraft:ridge-1",
                    "shift_x": "minecraft:shift_x",
                    "shift_y": {
                        "type": "minecraft:mul",
                        "argument1": 100,
                        "argument2": "minecraft:overworld/erosion"
                    },
                    "shift_z": "minecraft:shift_z",
                    "xz_scale": 0.0815,
                    "y_scale": 0.0
                }
            }
        }
    },
    "argument2": {
        "type": "minecraft:mul",
        "argument1": 1.0,
        "argument2": {
            "type": "minecraft:abs",
            "argument": {
                "type": "minecraft:shifted_noise",
                "noise": "minecraft:ridge",
                "shift_x": "minecraft:shift_x",
                "shift_y": {
                    "type": "minecraft:mul",
                    "argument1": 200,
                    "argument2": "minecraft:overworld/erosion"
                },
                "shift_z": "minecraft:shift_z",
                "xz_scale": 0.163,
                "y_scale": 0.0
            }
        }
    }
}

7.4.json 代码片段以CC0 1.0 通用版（公有领域） 授权。

即：不保留任何权利。

您可自由复制、修改、分发此段代码，或将其整合至您的模组/数据包中，无需署名，无需告知，无需以相同方式共享。

此授权不溯及本模组其他部分。完整模组按All rights reserved许可证发布

---

8. 版本发布周期变更

自 1.3.0.10231.1124.he_release_betaflt 起，预览版发布周期调整为 每 3.5 天一次。

正式版版本号格式：
1.3.0.10231.1013.he_release_flt

后续正式版版本号锚点自 10231.1125 起统一。

---

文档修订记录

修订次 日期 说明
第1次 2025-10-20 16:05 初版
第2次 2025-10-30 23:35 增补兼容性
第3次 2025-11-10 21:55 增补版本升级风险
第4次 2025-11-11 14:55 细化巨型生物群系说明
第5次 2025-11-12 23:55 增补 Android 说明
第6次 2025-11-13 17:55 修订性能警告
第7次 2025-11-15 17:55 增补 1.2.0 RC.2 说明
第8次 2025-11-17 17:55 无内容变更，补全记录
第9次 2025-11-19 13:25 时间戳修正
第10次 2025-11-22 11:45 增补第7条
第11次 2025-11-22 17:45 修订第7条
第12次 2025-12-02 18:35 增补预览版不兼容说明
第13次 2025-12-12 23:35 修订第5条、第7条
第14次 2026-02-12 20:55 同步更新周期至3.5天；增补1124修复状态；增补7.4 JSON配置；版本基线明确为10231.1125
第15次 2026-06-03 20:35 修订了部分关于Vulkan 1.3的说明