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

---

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. 推荐运行配置

· 渲染器：MG Renderer 或 Zink Renderer
· 建议搭配性能优化模组使用

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

· 骁龙 4 系、天玑 6xxx 系列
· 2018 年前发布的骁龙 8/7/6 系
· 初代酷睿及更旧英特尔处理器
· 性能低于初代酷睿核显的显卡

---

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:flat_cache",
  "argument": {
    "type": "minecraft:add",
    "argument1": {
      "type": "minecraft:flat_cache",
      "argument": {
        "type": "minecraft:shifted_noise",
        "noise": "minecraft:ridge",
        "shift_x": "minecraft:shift_x",
        "shift_y": {
          "type": "minecraft:mul",
          "argument1": 100,
          "argument2": "minecraft:overworld/erosion"
        },
        "shift_z": "minecraft:shift_z",
        "xz_scale": 0.19,
        "y_scale": 0.0
      }
    },
    "argument2": {
      "type": "minecraft:add",
      "argument1": {
        "type": "minecraft:flat_cache",
        "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.08,
          "y_scale": 0.0
        }
      },
      "argument2": {
        "type": "minecraft:add",
        "argument1": {
          "type": "minecraft:flat_cache",
          "argument": {
            "type": "minecraft:shifted_noise",
            "noise": "minecraft:ridge-2",
            "shift_x": "minecraft:shift_x",
            "shift_y": {
              "type": "minecraft:mul",
              "argument1": 100,
              "argument2": "minecraft:overworld/erosion"
            },
            "shift_z": "minecraft:shift_z",
            "xz_scale": 0.035,
            "y_scale": 0.0
          }
        },
        "argument2": 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

1. Compatibility

1.1. Known Incompatible Mods
Loading the following mods alongside this one will cause world generation conflicts or runtime crashes:

· Epic Terrain
·Reterraforged
·Terraforged
·Big Globe

---

1. Mojang Legacy World Upgrade Mechanics

2.1. Forced Terrain Smoothing
When upgrading a world from below 1.17 to 1.21 with this mod loaded,Mojang's built-in terrain smoothing algorithm is forcibly activated.

2.2. Known Artifacts

· Floating village structures
·Rivers smoothed into static water bodies, with associated terrain elevation

2.3. Deep-Layer Processing
All blocks at Y=-64 and below are replaced with air.

2.4. Reporting Restriction
The above issues are triggered by a modded environment and are not vanilla bugs.Do not submit them to Mojang's official issue tracker.

---

1. Android Platform Compatibility

3.1. Recommended Configuration

· Renderer: MG Renderer or Zink Renderer
·Performance optimization mods recommended

3.2. Unsupported Hardware
Smooth gameplay cannot be guaranteed on the following hardware due to insufficient performance:

· Snapdragon 4-series, Dimensity 6xxx series
·Snapdragon 8/7/6 series released before 2018
·1st-gen Intel Core processors and older
·GPUs with performance below 1st-gen Core integrated graphics

---

1. Version Upgrade Risk Statement

4.1. 【CRITICAL】1.0.0 → 1.1.0
If you are using Canyon_and_cliffs_and_biome 1.0.0 on an existing world,do NOT upgrade directly to 1.1.0. Irreparable terrain seams will appear at the boundary between old and new chunks.

4.2. 1.2.0 beta.1 and Later
Starting from this version,the terrain generation code was fully rewritten. Compatibility with Minecraft versions below 1.21.9 is no longer guaranteed. Some bugs have been fixed.

4.3. Known Defects in Older Versions
In versions prior to 1.2.0,amethyst geodes and lake generation carried crash risks. These have been resolved.

4.4. Aquifer Noise Defect (Resolved)
Since 1.0.0,the aquifer noise generator exhibited positional and morphological anomalies. 
This issue has been fixed as of build 1.3.0.10231.1124.

4.5. 1.2.0 RC.1 – Cave Algorithm Change
This version altered the cave generation algorithm.After upgrading, previously generated cave chunks may exhibit misalignment or seams.

4.6. 1.2.0 RC.2 – Codebase Refactor
The world generation and JSON codebase were partially refactored.Terrain deviation between old and new chunks may occur after upgrading. 
(build 1.3.0.10231.1000– resolved)

---

1. Large Biomes World Type

5.1. Support Status
Modifications for the"Large Biomes" world type are not yet fully implemented in this version.

5.2. Upgrade Impact
Upgrading to 1.2.0 beta.1 will cause newly generated chunks to display abnormal terrain.

5.3. Aquifer Issues (Resolved)
Same as 4.4– aquifer generation defects previously affecting this world type have been fixed as of build 1.3.0.10231.1124.

5.4. Specific Biome Defects (Resolved)

· In Large Biomes, swamps previously exhibited widespread abnormal aquifers underground
·Deep lukewarm oceans, deep cold oceans, and similar biomes were also affected
(build 1.3.0.10231.1124 – fixed)

5.5. Amplified World Type
Support was previously defective;a fix was expected to take considerable time.
(build 1.3.0.10231.1124– support implemented)

---

1. Noise Generator Refactor (1.3.0-Insider-Preview.2025-11-22)

6.1. Rationale and Outcome
To address the aquifer issue,multiple new cave noise generators were introduced in this preview build.
The performance cost– terrain generation approximately 2–3× slower than previous versions – was deemed unacceptable.
(build 1.3.0.10231.1000– code removed)

---

1. Major Terrain Generation Overhaul (1.3.0-Insider-Preview.2025-11-22)

7.1. Changes (Historical)
This preview build introduced:

· Increased biome scale; distribution logic more geographically plausible
·Swamps and similar biomes generating less frequently, with more complete morphology
·Adjusted temperature parameters

7.2. Compatibility Impact (Historical)
·This version was completely incompatible with Canyon_and_cliffs_and_biome 1.2.0 and earlier
·Subsequent preview builds (2025-11-23, 2025-11-27, 2025-12-02) were mutually incompatible due to continuous algorithm refactoring

7.3. Later Versions
Starting from 1.3.0-beta.3,the terrain generation code was rewritten entirely.
Section 7.1 no longer applies to this or any later version,but the incompatibility warnings remain valid for the builds in question.
(The code described in 7.1 was removed in build 1.3.0.10231.1000.)

7.4. build 1.3.0.10231.1124 – Erosion-like Pseudocode Implementation
This version does not refactor core code,but introduces a pseudocode implementation of erosion-like algorithms.
Below is the actual JSON noise configuration used in this version:

7.4.json

```json
{
  "type": "minecraft:flat_cache",
  "argument": {
    "type": "minecraft:add",
    "argument1": {
      "type": "minecraft:flat_cache",
      "argument": {
        "type": "minecraft:shifted_noise",
        "noise": "minecraft:ridge",
        "shift_x": "minecraft:shift_x",
        "shift_y": {
          "type": "minecraft:mul",
          "argument1": 100,
          "argument2": "minecraft:overworld/erosion"
        },
        "shift_z": "minecraft:shift_z",
        "xz_scale": 0.19,
        "y_scale": 0.0
      }
    },
    "argument2": {
      "type": "minecraft:add",
      "argument1": {
        "type": "minecraft:flat_cache",
        "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.08,
          "y_scale": 0.0
        }
      },
      "argument2": {
        "type": "minecraft:add",
        "argument1": {
          "type": "minecraft:flat_cache",
          "argument": {
            "type": "minecraft:shifted_noise",
            "noise": "minecraft:ridge-2",
            "shift_x": "minecraft:shift_x",
            "shift_y": {
              "type": "minecraft:mul",
              "argument1": 100,
              "argument2": "minecraft:overworld/erosion"
            },
            "shift_z": "minecraft:shift_z",
            "xz_scale": 0.035,
            "y_scale": 0.0
          }
        },
        "argument2": 0.0
      }
    }
  }
}
```

7.4.json is licensed under CC0 1.0 Universal (Public Domain).

That means: No rights reserved.

You are free to copy, modify, distribute, or integrate this code into your own mods or datapacks – no attribution required, no notification required, no share-alike required.

This license applies only to this code fragment. The full mod remains under the All rights reserved license.

---

1. Version Release Cycle Change

Effective from 1.3.0.10231.1124.he_release_betaflt, the preview release cycle is adjusted to every 3.5 days.

Stable version format:
1.3.0.10231.1013.he_release_flt

All future stable versions will anchor from 10231.1125.

---

Document Revision History

Rev 1  2025-10-20 16:05  Initial version
Rev 2  2025-10-30 23:35  Added compatibility section
Rev 3  2025-11-10 21:55  Added version upgrade risks
Rev 4  2025-11-11 14:55  Detailed Large Biomes section
Rev 5  2025-11-12 23:55  Added Android instructions
Rev 6  2025-11-13 17:55  Revised performance warnings
Rev 7  2025-11-15 17:55  Added 1.2.0 RC.2 notes
Rev 8  2025-11-17 17:55  No content changes,record-keeping
Rev 9  2025-11-19 13:25  Timestamp corrections
Rev 10 2025-11-22 11:45  Added Section 7
Rev 11 2025-11-22 17:45  Revised Section 7
Rev 12 2025-12-02 18:35  Added preview incompatibility notes
Rev 13 2025-12-12 23:35  Revised Sections 5 and 7
Rev 14 2026-02-12 21:00  Synced update cycle to 3.5 days;marked aquifer defect as resolved (4.4, 5.3, 5.4); revised 6.1 and 7.3 for historical accuracy; added 7.4 JSON config; version baseline set to 10231.1124

---
