地形生成警告 - 请在下载并安装此模组/数据包后仔细阅读

1. 兼容性

· 1.1. 已知不兼容模组
  与以下模组同时使用将导致冲突，不建议搭配运行：
  · Epic Terrain
  · Reterraforged
  · Terraforged
  · Big Globe

2. 关于 Mojang 代码与旧版世界升级

· 2.1. 地形平滑机制触发
  当您将版本低于 1.17 的旧存档升级到 1.21 并加载本模组时，会触发 Mojang 内置的地形平滑机制，从而引发一系列问题。
· 2.2. 已知现象
  · 村庄结构可能浮空。
  · 河流可能被平滑处理，导致出现不自然的静止水体及地形隆起。
· 2.3. 深层地形变化
  在 Y=-64 及以下的层级，地形平滑机制会将所有方块替换为空气。
· 2.4. 问题反馈须知
  重要提醒：上述由模组环境引发的问题，请勿提交至 Mojang 官方漏洞追踪器。在模组环境下产生的问题通常不被视为原版漏洞，官方将不予处理。

3. Android 设备用户须知

· 3.1. 运行建议
  为确保最佳兼容性与性能，建议使用 MG 渲染器 或 Zink 渲染器，并可考虑安装性能优化类模组以提升体验。
· 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 及以后版本的兼容性
  自 Canyon_and_cliffs_and_biome 1.2.0 beta.1 起，地形生成代码进行了大规模重写。此版本及后续版本不再兼容旧版 Minecraft（指低于 1.21.9 的版本）。1.2.0 beta.1 修复了部分地形生成漏洞。
· 4.3. 旧版本已知缺陷
  旧版本中的紫水晶洞与湖泊生成存在严重问题，可能导致游戏崩溃。
· 4.4. 长期存在的含水层问题
  自 1.0.0 版本起，含水层的噪声生成器便存在问题，导致其生成位置和形状异常，此问题仍在处理中。
· 4.5. 1.2.0 RC.1 的洞穴生成变更
  在 Canyon_and_cliffs_and_biome 1.2.0 RC.1 中，洞穴生成算法被更改。升级后，此前已生成的洞穴区块可能会出现地形错位或接缝。
· 4.6. 1.2.0 RC.2 的代码重构
  在 Canyon_and_cliffs_and_biome 1.2.0 RC.2 中，世界生成与 JSON 代码库被部分重构（为求稳定，仍使用了原版 data/minecraft 文件夹）。升级至此版本后，旧地形区块与新生成区块之间可能出现地形偏差和接缝。

5. 关于“巨型生物群系”世界类型

· 5.1. 支持状态
  当前版本对“巨型生物群系”的修改尚未完成。
· 5.2. 升级影响
  在升级到 Canyon_and_cliffs_and_biome 1.2.0 beta.1 之前，巨型生物群系的地形是正常的；但升级后，新生成的区块地形会表现异常。
· 5.3. 含水层问题
  （同 4.4）在巨型生物群系下，含水层的生成同样存在问题。
· 5.4. 特定生物群系问题
  在巨型生物群系中，沼泽生物群系的地下遍布含水层；主世界的温水深海、冷水深海等生物群系也存在类似问题。这些问题尚未完全修复。
· 5.5. “放大化”世界类型
  对“放大化”世界类型的支持也存在已知问题，且修复可能需要较长时间。

6. 新的噪声生成器（自 Canyons_and_Cliffs_and_Biomes-1.3.0-Insider-Preview.2025-11-22 起）

· 6.1. 变更目的与影响
  为修复含水层问题，我们引入了大量新的洞穴噪声，目前带来的主要影响是：
  · 地形生成速度比之前版本慢约 2 至 3 倍。

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

· 7.1. 调整内容与影响
  鉴于旧版地形生成的生物群系分布真实性不足，我们重新调整了地形生成机制：
  · 生物群系的规模现在变得更大、更符合真实地理特征。例如，沼泽生物群系不仅范围更大、形态更真实，其生成也变得更为稀有。同时，对温度参数也进行了微调。
  · 此项改动幅度巨大，导致 Canyons_and_Cliffs_and_Biomes-1.3.0-Insider-Preview.2025-11-22 与 Canyon_and_cliffs_and_biome 1.2.0 及以前版本完全不兼容。
  · 由于在后续预览版（如 2025-11-23，2025-11-27，2025-12-02）中连续对噪声生成、雕刻器洞穴和核心地形算法进行了根本性更改，各预览版之间也彼此不兼容，且与所有旧版本不兼容。
· 7.2. 后续版本说明
  自 Canyons_and_Cliffs_and_Biomes-1.3.0-beta.3 起，地形生成代码进行了又一次彻底的重写。上述第7.1条中关于生物群系等的地形描述已不再适用，但关于版本间不兼容的警告依然有效。
  
  
---

文档修订记录

· 第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
· 第6次修订：2025年11月13日 17:55
· 第7次修订：2025年11月15日 17:55
· 第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
  第12次修订：2025年12月02日 18:35
· 第13次修订：2025年12月12日 23:35

---

Terrain Generation Warning – Please Read Carefully After Downloading This Mod/Datapack

1. Compatibility

· 1.1. Known Incompatible Mods
  Using this mod/datapack alongside the following mods will cause conflicts and is not recommended:
  · Epic Terrain Generation
  · Reterraforged
  · Terraforged
  · Big Globe

2. Regarding Mojang's Code and Legacy World Upgrades

· 2.1. Terrain Smoothing Trigger
  Upgrading a world from a version below 1.17 to 1.21 with this mod/datapack installed triggers Mojang's built-in terrain smoothing mechanics, leading to various issues.
· 2.2. Known Artifacts
  · Village structures may appear floating.
  · Rivers may be smoothed out, resulting in unnatural static water bodies and elevated terrain.
· 2.3. Deep-Level Terrain Alteration
  All blocks at Y-level -64 and below are replaced by air due to the terrain smoothing process.
· 2.4. Issue Reporting Notice
  Important: Please do not report these mod-induced issues to the official Mojang Bug Tracker. Issues arising in a modded environment are generally not considered vanilla bugs and will not be addressed.

3. For Android Users

· 3.1. Recommended Setup
  For optimal compatibility and performance, it is recommended to use the MG Renderer or Zink Renderer. Installing performance optimization mods may also enhance your experience.
· 3.2. Performance Warning
  The following devices, due to hardware limitations, may experience severe lag when running this mod, and a smooth gameplay experience cannot be guaranteed:
  · Snapdragon 4-series and MediaTek Dimensity 6xxx series.
  · Snapdragon 8/7/6 series chips released before 2018.
  · Intel Core processors of the 1st generation or older.

4. Regarding Mod Version Updates

· 4.1. 【CRITICAL WARNING】Upgrading from 1.0.0 to 1.1.0
  If you are currently using Canyon_and_cliffs_and_biome 1.0.0 on an existing world, do NOT upgrade it directly to version 1.1.0. This is highly likely to cause severe, irreparable terrain seams between old and new chunks.
· 4.2. Compatibility from 1.2.0 beta.1 Onwards
  Starting from Canyon_and_cliffs_and_biome 1.2.0 beta.1, the terrain generation code was extensively rewritten. This version and all subsequent versions are no longer compatible with older Minecraft versions (specifically, those below 1.21.9). Version 1.2.0 beta.1 fixed some terrain generation bugs.
· 4.3. Known Defects in Older Versions
  Older versions had critical issues with amethyst geode and lake generation, which could cause game crashes.
· 4.4. Persistent Aquifer Issues
  Aquifer generation has been problematic since version 1.0.0 due to issues with the noise generator, causing them to generate in incorrect locations and shapes. This issue is still being worked on.
· 4.5. Cave Generation Change in 1.2.0 RC.1
  The cave generation algorithm was changed in Canyon_and_cliffs_and_biome 1.2.0 RC.1. Caves generated in existing chunks prior to this update may exhibit terrain misalignment or seams.
· 4.6. Code Refactoring in 1.2.0 RC.2
  In Canyon_and_cliffs_and_biome 1.2.0 RC.2, the world generation and JSON codebase was partially refactored (though it still uses the vanilla data/minecraft folder for stability). Upgrading to this version may cause terrain misalignment and seams between old and new chunks.

5. Regarding the "Large Biomes" World Type

· 5.1. Support Status
  Modifications for the "Large Biomes" world type are currently incomplete in this version.
· 5.2. Upgrade Impact
  While terrain in Large Biomes was normal before upgrading to Canyon_and_cliffs_and_biome 1.2.0 beta.1, newly generated chunks after the upgrade will appear strange.
· 5.3. Aquifer Issues
  (Same as 4.4) Aquifer generation within Large Biomes is also problematic.
· 5.4. Specific Biome Issues
  In Large Biomes, the underground of swamp biomes is filled with aquifers; similar issues exist in the Overworld's deep lukewarm ocean, deep cold ocean, and other biomes. These issues are not fully resolved.
· 5.5. "Amplified" World Type
  Support for the "Amplified" world type has known issues, and a fix may take a considerable amount of time.

6. New Noise Generator (Since Canyons_and_Cliffs_and_Biomes-1.3.0-Insider-Preview.2025-11-22)

· 6.1. Purpose and Performance Impact
  To address aquifer issues, numerous new cave noise generators have been added. The primary current side effect is:
  · Terrain generation is approximately 2 to 3 times slower than in previous versions.

7. Major Terrain Generation Overhaul (Since Canyons_and_Cliffs_and_Biomes-1.3.0-Insider-Preview.2025-11-22)

· 7.1. Changes and Compatibility Impact
  To improve the realism of biome distribution, the terrain generation mechanics have been significantly reworked:
  · Biomes are now larger and more geographically plausible. For instance, swamp biomes are rarer, larger, and more realistically shaped. Temperature parameters have also been fine-tuned.
  · These changes are so extensive that Canyons_and_Cliffs_and_Biomes-1.3.0-Insider-Preview.2025-11-22 is completely incompatible with Canyon_and_cliffs_and_biome 1.2.0 and all earlier versions.
  · Due to fundamental changes to noise generation, carver caves, and core terrain algorithms in subsequent previews (e.g., 2025-11-23, 2025-11-27, 2025-12-02), these previews are also incompatible with each other and with all previous releases.
· 7.2. Note on Later Versions
  Starting with Canyons_and_Cliffs_and_Biomes-1.3.0-beta.3, the terrain generation code underwent another complete rewrite. The specific biome terrain descriptions in section 7.1 above are no longer accurate, but the warnings about version incompatibility remain valid.

---

Document Revision History

· First Revision: October 20, 2025, 16:05
· Second Revision: October 30, 2025, 23:35
· Third Revision: November 10, 2025, 21:55
· Fourth Revision: November 11, 2025, 14:55
· Fifth Revision: November 12, 2025, 23:55
· Sixth Revision: November 13, 2025, 17:55
· Seventh Revision: November 15, 2025, 17:55
· Eighth Revision: November 17, 2025, 17:55 (No content changes, added for record-keeping)
· Ninth Revision: November 19, 2025, 13:25 (Updated timestamps)
· Tenth Revision: November 22, 2025, 11:45 (Added section 7)
· Eleventh Revision: November 22, 2025, 17:45
· thirteen Revision: December 12, 2025, 23:35

-