Aetherial Structure Compatibility

模组

· 作者 OurElephant

适用于飞行岛屿类型生成的结构兼容模组。将结构的起始位置转移到合适的飞行岛屿上。与 C2ME、YOUNG 的整合结构兼容。

0 本站下载 0 关注 更新于 3 个月前

最新 1.0.0g · 1.21.1 · NeoForge

一键开服(送7天)

Aetherial Structure Compatibility

版本: 1.0.0g
Minecraft: 1.21.1
加载器: NeoForge 21.1.242+
Java: 21
作者: OurElephant
联系方式: slon1k.nash@atomicmail.io

用于浮空岛类型生成的结构兼容性模组。将结构的起始位置转移至合适的浮空岛上。

用途

Aetherial Structure Compatibility (ASC) 将原版 Minecraft 的结构生成适配到由分离的浮空岛构成的世界中。在未修改的结构管线中,结构起始点是根据生物群系和结构集规则选定的,但并不会知晓在生成的结构组件周围或下方是否有足够的地形。在岛屿世界中,这可能导致结构生成在虚空中、结构被分割到不相关的岛屿上、出现无支撑的房间,或在可用岩层范围外生成地下结构。

ASC 在接受结构起始点之前会评估附近的岛屿地形。它会搜索合适的岛屿和锚点,根据该岛屿验证生成的结构,并根据所选的生成策略,要么在目标位置生成起始点,要么平移已完成的结构组件。

ASC 仅更改放置方式。它不会添加结构、替换结构战利品、改变结构集间距,也不会改变除探测有效目标位置之外的生物群系资格规则。

工作原理

  1. Minecraft 在其名义区块请求一个结构起始点。
  2. ASC 识别该结构并加载其对应的配置文件,必要时回退到 defaults 配置文件。
  3. 对附近的列进行采样并将它们分组为浮空岛候选项。
  4. 根据岛屿大小、厚度、可用空间以及重定位距离对候选锚点进行排名。
  5. ASC 根据 generationStrategy(生成策略)生成或重定位结构。
  6. 实际结构组件需与单个岛屿进行校验。地表结构要求大多数组件下方有地形;地下结构要求有足够的包围性或重叠;水下结构要求具备适当的水体和底部条件。
  7. 如果没有目标通过验证,global.fallback 将决定是跳过该结构还是保留其原版位置。

名义起始区块仍作为结构的所有者。结构组件和缓存的边界框会被更新,以便放置操作和 /locate structure 命令使用重定位后的几何体,同时保持在 Minecraft 最大八区块结构引用距离之内。

对结构生成的更改

  • 结构起始点可以水平或垂直移动至经过验证的岛屿锚点。
  • regenerate_at_target 要求结构生成器在目标区块创建起始点。
  • generate_then_translate 先生成原始起始点,然后将所有已完成的组件作为一个整体进行移动。
  • auto 选择正常的目标生成路径,并对 YUNG's Better Mineshafts 和 buried treasure 采用特殊的平移处理。
  • 地表结构由其实际组件而非仅由一个大边界矩形进行验证。
  • 分支矿道按组件逐一检查,因此隧道之间的空洞不计入缺失的地形。
  • Trial Chambers 和其他感知组件的地下结构会根据实际的房间和走廊进行对齐和验证。
  • 可以使用 verticalSupports 禁用标准的垂直支撑柱。专用的 YUNG 兼容性保留链条,同时抑制不需要的实心支撑腿。
  • 已生成的结构不会被回溯移动。请在新世界或未探索的区块中测试更改。

性能

ASC 会在区块生成期间执行额外的地形采样、岛屿检测、候选项排名和结构验证。这会增加世界生成期间的 CPU 工作量,并可能显著减缓区块生成速度,尤其是在使用较大的搜索半径、高采样限制或许多结构模组时。

对于大型世界和整合包,建议在正常游戏之前使用 Chunky 预生成预期的世界区域。同时也推荐使用 C2ME 进行并行区块加载和生成,这可以减少 ASC 对探索和服务器启动的实际影响。性能仍然取决于世界预设、硬件、整合包和配置值,因此在生成生产用世界之前,请先在备份上测试设置。

兼容性

ASC 没有必需的结构模组依赖。它读取活动的动态 STRUCTURE 注册表,因此来自模组和数据包的基于标准注册表的结构可以自动获得配置文件。

内置模板包含以下可直接编辑的配置文件:

  • Vanilla Minecraft structures;
  • YUNG's Better Desert Temples;
  • YUNG's Better Dungeons;
  • YUNG's Better Nether Fortresses;
  • YUNG's Better Jungle Temples;
  • YUNG's Better Mineshafts;
  • YUNG's Better Ocean Monuments;
  • YUNG's Better Strongholds;
  • YUNG's Better Witch Huts;
  • Integrated Dungeons and Structures (IDAS);
  • Integrated Stronghold;
  • Integrated Villages;
  • Revamped Shipwrecks;
  • Supplementaries structures.

针对 YUNG's Better Mineshafts 和 YUNG's Better Dungeons 包含了专用的 mixins,因为这些模组会直接放置支撑腿。这些可选适配器不需要安装 YUNG 模组即可工作。

生成和缓存代码旨在支持并行世界生成,包括 C2ME。Distant Horizons 的辅助世界生成线程不运行岛屿扫描;在这些线程中使用配置的后备方案以避免工作线程的区块生成停滞。

配置文件位置

配置文件位于:

config/aetherial_structure_compat.json

当文件不存在时,ASC 会写入内置模板。在结构注册表可用后,ASC 会为每个注册的结构扩展文件,添加一个完整的部分。以 _ 开头的内部键是迁移或模板标记,在游戏内的结构列表中隐藏。

全局设置

字段 默认值 接受的值 描述
enabled true Boolean ASC 的主开关。设为 false 时使用原版结构生成。
searchRadius 128 16–1024 blocks 搜索岛屿地形的最大半径。
maxRelocationChunks 8 1–8 chunks 最大水平起始位置重定位距离。8 也是 Minecraft 的结构引用限制。
cacheRadius 128 16–256 blocks 岛屿分析缓存保留的半径。
maxAttempts 32 1–256 普通结构的最大候选生成尝试次数。
sampleStep 8 2–64 blocks 初始岛屿采样期间列之间的间距。较小的值更准确但开销更大。
maxSampleColumns 8192 64–16384 初始岛屿分析期间检查的列数硬上限。
validationStep 4 2–32 blocks 详细放置验证期间使用的列间距。
maxValidationColumns 4096 32–8192 详细验证期间检查的列数硬上限。
verticalConnectionTolerance 16 0–64 blocks 将采样的区域分组为一个岛屿时使用的最大垂直间隔。
maxAnchorsPerIsland 12 1–32 每个岛屿保留的最大候选锚点数量。
maxCacheEntries 64 4–2048 主岛屿缓存中的最大条目数。
maxColumnCacheEntries 786432 8192–2097152 保留的采样世界列的最大数量。
maxColumnCacheMemoryMb 384 32–512 MiB 列缓存的大致内存上限。
fallback skip skip, vanilla 未找到合适岛屿时的操作:跳过起始点或保留原版放置。
logDecisions false Boolean 将详细的放置决策和拒绝统计信息写入日志。

默认值和按结构设置的放置字段

defaults 对象提供继承的值。使用结构标识符命名的顶层对象(例如 minecraft:village_plains)会覆盖该结构的这些值。

字段 默认值 接受的值 描述
enabled true Boolean 为此范围或结构启用 ASC 处理。
chanceMultiplier 1.0 0.0–1.0 ASC 处理非强制结构起始点的概率。
mode auto auto, surface, underground, aquatic 目标环境。auto 从结构标识符推断模式。
undergroundPlacement auto auto, relaxed, contained, mandatory 地下容纳策略。relaxed 接受部分隧道重叠;contained 要求完全封闭;mandatory 执行更广泛的必需搜索。
generationStrategy auto auto, regenerate_at_target, generate_then_translate 选择是否在岛屿处重新生成起始点,还是先生成后平移。
verticalSupports false Boolean 允许在方块下方使用标准的垂直支撑列。对于浮动地形,设为 false 更安全。
minRadius 10 0–2048 blocks 最小水平岛屿半径。
minDepth 5 1–384 blocks 最小岛屿厚度或可用垂直深度。
minSurfaceArea 160 0–20000000 columns 最小可用表面积。
minSolidPercent 0.18 0.0–1.0 评估岛屿体积中最小固体方块比例。
minStonePercent 0.0 0.0–1.0 最小类石方块比例,主要用于地下结构。
minFreeSpace 0.06 0.0–1.0 目标周围或内部的最小自由空间比例。
minWaterDepth 0 0–384 blocks 水下放置的最小水深。
minWaterCoverage 0.0 0.0–1.0 被水覆盖的最小足迹比例。
minFootprintCoverage 0.56 0.0–1.0 所选岛屿支持的结构的实际方块足迹的最小比例。对于地表或感知方块的結構,有效阈值可能更严格。
maxSurfaceVariation 14 0–128 blocks 放置过程中接受的最大高度变化。
aquaticPlacement floor floor, water_surface, preserve 将水下结构对齐到海床、水面或原始相对高度。
verticalOffset 0 -64–64 blocks 对齐后应用的额外 Y 偏移量。
horizontalMargin 2 0–128 blocks 足迹周围额外的水平净空距离。
verticalMargin 1 0–128 blocks 结构上方和下方的额外净空距离。
sizeWeight 0.38 Decimal 岛屿大小对候选排名的贡献。
distanceWeight 0.12 Decimal 重定位距离对候选排名的贡献。
thicknessWeight 0.32 Decimal 岛屿厚度对候选排名的贡献。
freeSpaceWeight 0.18 Decimal 自由空间对候选排名的贡献。

这四个排名权重不必恰好总和为 1.0,但保持归一化总和可以使它们的相对影响更易于理解。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源