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 仅更改放置方式。它不会添加结构、替换结构战利品、改变结构集间距,也不会改变除探测有效目标位置之外的生物群系资格规则。
工作原理
- Minecraft 在其名义区块请求一个结构起始点。
- ASC 识别该结构并加载其对应的配置文件,必要时回退到
defaults 配置文件。
- 对附近的列进行采样并将它们分组为浮空岛候选项。
- 根据岛屿大小、厚度、可用空间以及重定位距离对候选锚点进行排名。
- ASC 根据
generationStrategy(生成策略)生成或重定位结构。
- 实际结构组件需与单个岛屿进行校验。地表结构要求大多数组件下方有地形;地下结构要求有足够的包围性或重叠;水下结构要求具备适当的水体和底部条件。
- 如果没有目标通过验证,
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,但保持归一化总和可以使它们的相对影响更易于理解。
Aetherial Structure Compatibility
Version: 1.0.0g
Minecraft: 1.21.1
Loader: NeoForge 21.1.242+
Java: 21
Author: OurElephant
Contact: slon1k.nash@atomicmail.io
Structure compatibility mod for flying isles type generation. Transfers the start of structures to suitable flying islands
Purpose
Aetherial Structure Compatibility (ASC) adapts normal Minecraft structure generation to worlds made from separated flying islands. In an unmodified structure pipeline, a structure start is chosen from the biome and structure-set rules without knowing whether enough terrain exists below or around the resulting pieces. In an island world this can produce structures in the void, structures split between unrelated islands, unsupported rooms, or underground structures outside the available rock mass.
ASC evaluates nearby island terrain before accepting a structure start. It searches for a suitable island and anchor, validates the generated structure against that island, and either generates the start at the target or translates the completed structure pieces, depending on the selected generation strategy.
ASC changes placement only. It does not add structures, replace structure loot, alter structure-set spacing, or change biome eligibility rules beyond probing valid target positions.
How it works
- Minecraft requests a structure start in its nominal chunk.
- ASC identifies the structure and loads its individual profile, falling back to the
defaults profile when necessary.
- Nearby columns are sampled and grouped into flying-island candidates.
- Candidate anchors are ranked by island size, thickness, free space, and relocation distance.
- ASC generates or relocates the structure according to
generationStrategy.
- The real structure pieces are checked against one island. Surface structures require terrain under most pieces; underground structures require enough containment or overlap; aquatic structures require appropriate water and floor conditions.
- If no target passes validation,
global.fallback determines whether the structure is skipped or kept at its vanilla position.
The nominal start chunk remains the structure owner. The structure pieces and cached bounding box are updated so placement and /locate structure use the relocated geometry while remaining inside Minecraft's maximum eight-chunk structure-reference distance.
Changes to structure generation
- Structure starts can be moved horizontally and vertically to a validated island anchor.
regenerate_at_target asks the structure generator to create the start at the target chunk.
generate_then_translate generates the original start first and then moves all completed pieces as a group.
auto selects the normal target-generation path, with special translation handling for YUNG's Better Mineshafts and buried treasure.
- Surface structures are validated by their real pieces rather than only by one large bounding rectangle.
- Branching mineshafts are checked piece by piece so empty gaps between tunnels do not count as missing terrain.
- Trial Chambers and other piece-aware underground structures are aligned and validated by actual rooms and corridors.
- Standard vertical support columns can be disabled with
verticalSupports. Dedicated YUNG compatibility keeps chains while suppressing unwanted solid support legs.
- Already generated structures are not moved retroactively. Test changes in a new world or unexplored chunks.
Performance
ASC performs additional terrain sampling, island detection, candidate ranking, and structure validation while chunks are generated. This increases CPU work during world generation and may noticeably slow chunk generation, especially when using a large search radius, high sampling limits, or many structure mods.
For large worlds and modpacks, it is recommended to use Chunky to pre-generate the intended world area before normal play. C2ME is also recommended for parallel chunk loading and generation, which can reduce the practical impact of ASC on exploration and server startup. Performance still depends on the world preset, hardware, modpack, and configuration values, so test settings on a backup before generating a production world.
Compatibility
ASC has no required structure-mod dependency. It reads the active dynamic STRUCTURE registry, so standard registry-based structures from mods and datapacks can receive profiles automatically.
The bundled template contains ready-to-edit profiles for:
- 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.
Dedicated mixins are included for YUNG's Better Mineshafts and YUNG's Better Dungeons where those mods place support legs directly. These optional adapters do not require the YUNG mods to be installed.
The generation and cache code is designed for parallel world generation, including C2ME. Distant Horizons auxiliary world-generation threads do not run island scanning; the configured fallback is used there to avoid worker-thread chunk-generation stalls.
Configuration location
The configuration file is:
config/aetherial_structure_compat.json
When the file does not exist, ASC writes the bundled template. After the structure registry becomes available, ASC expands the file with one complete section per registered structure. Internal keys beginning with _ are migration or template markers and are hidden from the in-game structure list.
Global settings
| Field |
Default |
Accepted value |
Description |
enabled |
true |
Boolean |
Master switch for ASC. When false, vanilla structure generation is used. |
searchRadius |
128 |
16–1024 blocks |
Maximum radius used to search for island terrain. |
maxRelocationChunks |
8 |
1–8 chunks |
Maximum horizontal start relocation. Eight is also Minecraft's structure-reference limit. |
cacheRadius |
128 |
16–256 blocks |
Radius retained by the island analysis cache. |
maxAttempts |
32 |
1–256 |
Maximum candidate generation attempts for a normal structure. |
sampleStep |
8 |
2–64 blocks |
Spacing of columns during initial island sampling. Smaller values are more accurate and more expensive. |
maxSampleColumns |
8192 |
64–16384 |
Hard cap on columns inspected during initial island analysis. |
validationStep |
4 |
2–32 blocks |
Column spacing used during detailed placement validation. |
maxValidationColumns |
4096 |
32–8192 |
Hard cap on columns inspected during detailed validation. |
verticalConnectionTolerance |
16 |
0–64 blocks |
Maximum vertical separation used when grouping sampled regions into one island. |
maxAnchorsPerIsland |
12 |
1–32 |
Maximum candidate anchor points retained for each island. |
maxCacheEntries |
64 |
4–2048 |
Maximum entries in the main island cache. |
maxColumnCacheEntries |
786432 |
8192–2097152 |
Maximum number of sampled world columns retained. |
maxColumnCacheMemoryMb |
384 |
32–512 MiB |
Approximate memory ceiling for the column cache. |
fallback |
skip |
skip, vanilla |
Action when no suitable island is found: skip the start or retain vanilla placement. |
logDecisions |
false |
Boolean |
Writes detailed placement decisions and rejection statistics to the log. |
Default and per-structure placement fields
The defaults object provides inherited values. A top-level object named with a structure identifier, such as minecraft:village_plains, overrides those values for that structure.
| Field |
Default |
Accepted value |
Description |
enabled |
true |
Boolean |
Enables ASC processing for this scope or structure. |
chanceMultiplier |
1.0 |
0.0–1.0 |
Probability that ASC processes a non-mandatory structure start. |
mode |
auto |
auto, surface, underground, aquatic |
Target environment. auto infers a mode from the structure identifier. |
undergroundPlacement |
auto |
auto, relaxed, contained, mandatory |
Underground containment policy. relaxed accepts partial tunnel overlap; contained requires enclosure; mandatory performs a wider required search. |
generationStrategy |
auto |
auto, regenerate_at_target, generate_then_translate |
Chooses whether the start is regenerated at the island or generated first and translated. |
verticalSupports |
false |
Boolean |
Allows standard vertical support columns beneath pieces. False is safer for floating terrain. |
minRadius |
10 |
0–2048 blocks |
Minimum horizontal island radius. |
minDepth |
5 |
1–384 blocks |
Minimum island thickness or usable vertical depth. |
minSurfaceArea |
160 |
0–20000000 columns |
Minimum usable surface area. |
minSolidPercent |
0.18 |
0.0–1.0 |
Minimum solid-block fraction in the evaluated island volume. |
minStonePercent |
0.0 |
0.0–1.0 |
Minimum stone-like fraction, primarily for underground structures. |
minFreeSpace |
0.06 |
0.0–1.0 |
Minimum free-volume fraction around or inside the target. |
minWaterDepth |
0 |
0–384 blocks |
Minimum water depth for aquatic placement. |
minWaterCoverage |
0.0 |
0.0–1.0 |
Minimum fraction of the footprint covered by water. |
minFootprintCoverage |
0.56 |
0.0–1.0 |
Minimum fraction of the structure's real piece footprint supported by the chosen island. Effective thresholds may be stricter for surface or piece-aware structures. |
maxSurfaceVariation |
14 |
0–128 blocks |
Maximum accepted height variation across the placement. |
aquaticPlacement |
floor |
floor, water_surface, preserve |
Aligns aquatic structures to the seabed, water surface, or original relative height. |
verticalOffset |
0 |
-64–64 blocks |
Additional Y offset applied after alignment. |
horizontalMargin |
2 |
0–128 blocks |
Additional horizontal clearance around the footprint. |
verticalMargin |
1 |
0–128 blocks |
Additional clearance above and below the structure. |
sizeWeight |
0.38 |
Decimal |
Contribution of island size to candidate ranking. |
distanceWeight |
0.12 |
Decimal |
Contribution of relocation distance to candidate ranking. |
thicknessWeight |
0.32 |
Decimal |
Contribution of island thickness to candidate ranking. |
freeSpaceWeight |
0.18 |
Decimal |
Contribution of free volume to candidate ranking. |
The four ranking weights do not have to total exactly 1.0, but keeping a normalized sum makes their relative influence easier to understand.
评论 0
登录后参与评分
还没有评论,来抢沙发吧