CoreSwap 跳过自定义维度 surface_rule → mod 自定义维度世界生成被破坏(裸石)

[XuanZhiYouXuan2025]

问题

CoreSwap 会取消原版 NoiseBasedChunkGenerator.buildSurface，导致依赖它应用自身 surface_rule 的 mod 自定义维度永远不会铺上地表规则，只剩 default_block（石头）。后果：这些维度新生成区块地表为裸石，且树/植被也种不出来（需要草/土表面）。

环境

• Minecraft 1.20.1，Forge 47.4.21（CoreSwap 为 Fabric mod，经 Sinytra Connector 加载）
• coreswap-1.20.1-1.0.24.jar（replace mode 生效）
• 受影响 mod：chaospersists（Chaos Persists / OreSpawn 1.20.1-0.3.0）自定义维度（chaospersists:utopia/village 等）

根因（已定位到字节码）

coreswap.mixins.json → wg.bench.mixin.NoiseChunkGeneratorMixin 注入到 NoiseBasedChunkGenerator：

• wgPopulateNoise（注入 populateNoise，cancellable）：if !CppBridge.enabled return；否则 fillChunk(...) 原生填块 + setReturnValue → 取消原版 populateNoise。
• wgBuildSurface（注入 buildSurface）：if !CppBridge.enabled return；否则 ci.cancel() → 取消原版 buildSurface。

即一旦 CppBridge.enabled，CoreSwap 就取消原版 buildSurface，改用其原生 surface。而其 worldgen-data/ 仅含原版内容（65 个原版 biome、原版 noise/density/surface），不识别 mod 的 surface_rule/自定义 biome。

矿石菌种自定义维度 = 自定义生成器 chaospersists:plains_terrain（ChaosPlainsChunkGenerator），它包裹一个 minecraft:noise 内层生成器并把 buildSurface 委托给内层。内层是 NoiseBasedChunkGenerator → 被 wgBuildSurface 取消 → 其 surface_rule（草皮）永不执行 → 地表只剩石头。

日志：[BenchMod] CoreSwap replace mode: C++ worldgen active、[CppBridge] init ... enabled=true、[Mixin] buildSurface skipped chunk(...)。

现象（实测）

• chaospersists:utopia 新生成区块顶部以 minecraft:stone 为主（抽样 6 块 174–252/256 列），草方块 0–6 列，0 原木/0 树叶/0 水晶树。
• 移除 CoreSwap 后重新生成 → 地表即为草方块（可作对照）。

影响范围

任何「依赖 NoiseBasedChunkGenerator.buildSurface 应用自身 surface_rule」的 mod 维度都会受影响：

• 标准 minecraft:noise 生成器 + 自定义 noise_settings/surface_rule 的维度；
• 自定义 chunk 生成器包裹 minecraft:noise 并委托 buildSurface 的维度（如本 mod）；
• 非原版 biome（CoreSwap 的 biome 参数表只有原版，不识别自定义 biome）。

（该整合包里的 aether / twilightforest / tofucraft / grising planet_x / sweet_calamity 等自定义维度同样受影响。）

建议（按优先级）

1. 识别并跳过非原版维度：维度若用了非标准生成器（自定义 codec / 非 vanilla generator）、或 noise_settings/surface_rule/biome 非原版 → 禁用原生、回退到原版(Java)世界生成，并打印「跳过非原版维度 xxx」。
2. 按维度排除的配置：提供黑/白名单（如 dimension_ids = ["minecraft:overworld","minecraft:the_nether","minecraft:the_end"]），名单外维度不接管。
3. 至少：不要无条件取消原版 buildSurface；当 generator / surface_rule 非标准时放行原版。

期望

• 原版/标准维度：CoreSwap 原生加速（保留其价值）。
• mod 自定义维度：交回原版管线 → 正确铺草皮/树/结构，不被破坏。

（如需复现，可用上述 chaospersists + coreswap 组合，进该维度生成一块看地表；移除 CoreSwap 后即为草方块。）

[unknowbug]

感谢你非常详尽的报告！一句话概括：CoreSwap 在 replace 模式下无条件取消原版 NoiseBasedChunkGenerator.buildSurface，导致依赖该入口应用自身 surface_rule 的 mod 自定义维度地表只剩裸石，植被与树也无法生成。你的字节码级根因分析、对照实验（移除 CoreSwap 后恢复草方块）和影响范围梳理都非常有价值。

为便于人工维护者确认和复现，请补充：

• CoreSwap 精确版本/commit（已知 coreswap-1.20.1-1.0.24.jar，如有 git hash 请附上），以及运行环境：操作系统、Java 版本、Sinytra Connector 版本；
• 可复现的种子 + 维度内坐标（例如 chaospersists:utopia 中出现裸石的区块坐标）；
• 期望 vs 实际：期望按 mod 的 surface_rule 铺草皮并生成树/结构，实际顶面以 minecraft:stone 为主；
• 完整日志片段（含 [BenchMod] CoreSwap replace mode、[CppBridge] init ... enabled=true、[Mixin] buildSurface skipped 等行），以及受影响维度的 noise_settings/surface_rule JSON 或 ChaosPlainsChunkGenerator 相关代码片段/链接。

我是 AI 分诊助手，人工维护者会确认此问题并跟进处理。另外，此问题涉及数据驱动世界生成与多维度（multiworld）支持方向，属于当前路线图中正在推进的领域。

[XuanZhiYouXuan2025]

补充：按建议补齐可复现信息

感谢确认。补充以下细节供人工维护者复现。

版本 / 环境

• CoreSwap：coreswap-1.20.1-1.0.24.jar（版本号已知；未拿到对应 git commit hash，如需我可以从该版本对应的 GitHub 源码/发布页对一下 commit）。
• Minecraft：1.20.1（Forge 47.4.21）。
• Sinytra Connector：Connector-1.0.0-beta.49+1.20.1（经 Connector 加载 CoreSwap 到 Forge）。
• Java：17.0.20+8；OS：Windows。

可复现

• 世界种子：-2128686773447312085（WorldGenSettings.seed）。
• 维度坐标：进入 chaospersists:utopia 后，接近出生点（区块 0,0 一带）的新生成区块，地表顶部以 minecraft:stone 为主（抽样 6 区块顶部 174–252/256 列为石头，草方块 0–6 列，0 原木 / 0 树叶 / 0 水晶树）。
• 对照：同一世界移除 CoreSwap 后再生成该维度新区块 → 顶部即为草方块。

期望 vs 实际

• 期望：按 chaospersists:chaos_plains_noise_gen 的 surface_rule 铺草皮/泥土，并正常生成树/结构。
• 实际：顶面 minecraft:stone（= default_block），无草皮、无树。

日志片段（此前捕获）

[BenchMod] CoreSwap replace mode: C++ worldgen active
[CppBridge] init ... enabled=true
[Mixin] buildSurface skipped chunk(...)

（当前 logs\latest.log 因滚动已不含这几行，如上为复现时捕获。）

受影响的 noise_settings / surface_rule / 生成器

• 维度：data/chaospersists/dimension/utopia.json → generator.type = "chaospersists:plains_terrain"（ChaosPlainsChunkGenerator）。
• 生成器：ChaosPlainsChunkGenerator 包裹一个 minecraft:noise 内层生成器（wrapped_generator），并把 buildSurface/fillFromNoise 委托给内层（super.fillFromNoise(...)）。
• 内层 noise_settings：data/chaospersists/worldgen/noise_settings/chaos_plains_noise_gen.json，其中 default_block = minecraft:stone，surface_rule 为 sequence：
  • bedrock_floor（底部基岩）；
  • stone_depth + water → minecraft:grass_block（顶部草皮，关键是这条 —— 被取消的 buildSurface 就是要执行它）；
  • stone_depth(add_surface_depth) → minecraft:dirt（表层下泥土）；
  • 另一条 water → dirt。

即：surface_rule 依赖 NoiseBasedChunkGenerator.buildSurface 来执行；CoreSwap 在 replace 模式下 wgBuildSurface 无条件 ci.cancel()，这条「草地」规则永不生效 → 顶面只剩 default_block（stone）。这与建议 1/3 一致：当 generator 非标准（自定义 codec / 包裹 vanilla noise）/ surface_rule 非原版时，应放行原版 buildSurface，或按维度白/黑名单排除非原版维度。

（如需要，我可以再补 ChaosPlainsChunkGenerator 委托 buildSurface 的字节码片段，或任一受影响 mod 维度（aether / twilightforest 等）的 material 数据。）

[unknowbug]

感谢提交这份高质量的问题报告（我是 AI 分诊助手，已做初步分类）。

摘要：CoreSwap 在 replace 模式下无条件取消原版 NoiseBasedChunkGenerator.buildSurface / populateNoise，导致依赖自身 surface_rule 的 mod 自定义维度（如 chaospersists:utopia）地表变为裸石、树木/植被无法生成；移除 CoreSwap 后地表恢复正常草方块。

信息核对清单：

• CoreSwap 版本 ✓（coreswap-1.20.1-1.0.24.jar）
• 加载方式 ✓（Forge 47.4.21 + Sinytra Connector）
• 复现步骤 ✓（chaospersists + CoreSwap 进维度生成区块，移除 CoreSwap 作对照）
• 日志/证据 ✓（[CppBridge] init ... enabled=true、[Mixin] buildSurface skipped chunk(...) 及方块抽样数据）
• 种子/坐标（非必需，不影响分诊；如方便提供受影响维度的种子与坐标，可加快人工复现）

你定位到的根因（mixin 注入点、CppBridge.enabled 分支、worldgen-data/ 仅含原版内容）以及按维度排除/白名单的建议都非常清晰，会一并转给人工维护者评估。我是 AI 分诊助手，接下来会由人工维护者跟进确认问题与修复方向，暂无法承诺具体修复时间。

[XuanZhiYouXuan2025]

补充：全维度同种子实测 + 关键修正（在 #24 基础上）

感谢分诊与维护者跟进。按你们“信息核对清单”中缺的“种子/坐标”，以及此前 unknown 提及“多维度/数据驱动属路线图领域”，我补一组同种子 A/B 对照的全维度实测数据，供人工维护者评估受影响面与修复优先级。

复现（同种子 A/B）

• 世界种子：7691421705105351955（WorldGenSettings.seed）。
• 世界 A：CoreSwap 启用（replace 模式）；世界 B：同种子、同 mod 集、CoreSwap 禁用。
• A/B 共享同生成器注册与 mod 集，唯一差异 = CoreSwap 开/关。用 region 读取器比较同坐标区块逐位置方块。

实测结果（差率 = 同坐标区块逐位置方块不一致占比）

维度	生成器	差率	CoreSwap ON 地表	CoreSwap OFF（正确）
天境(aether)	minecraft:noise(aether:skylands)	39%	裸 bedrock	aether_grass_block + aercloud + 叶
末地	minecraft:noise	38%	裸 bedrock（部分采样见下界块 mix）	end_stone + obsidian + 末地结构
糖果(sweet_calamity)	minecraft:noise	34%	原版 grass_block/stone	glazed_sponge_cake + 巧克力叶
豆腐(TofuCraftReload)	minecraft:noise	34%	原版 grass_block/stone	tofu_terrain + soymilk
村庄	plains_terrain(包裹 noise)	6%	裸 stone	grass_block
巨树	plains_terrain(包裹 noise)	4%	裸 stone	grass_block + leaf
挖掘	minecraft:noise	4%	gravel+grass 为主	grass+stone 为主
下界	minecraft:noise	2%	bedrock 天花板（正常）	同（差异为深层 ore 放置）
暮色(twilightforest)	structure_locating_wrapper	1%	grass_block+canopy 叶	canopy 叶+grass
水晶	plains_terrain	0.8%	crystalgrass+crystalstone	crystalgrass 为主
不稳定	minecraft:flat	0.3%	grass+leaf	同
主世界	minecraft:noise	0.1%	grass/gravel/叶	同
混沌	sky_islands	0.02%	grass+泥土+leaf	同

两点关键修正（相对 #24 首版）

1. 受影响面比 CoreSwap 跳过自定义维度 surface_rule → mod 自定义维度世界生成被破坏(裸石) #24 更广：不止 chaospersists:utopia/village——末地、糖果、豆腐也被整体替换（地表变原版 grass/bedrock），aether 变 bedrock。
2. 个别维度其实正常：水晶 0.8%、混沌 0.02%、边际 1% 属正常/轻微；不要一概认为所有 mod 维度都被破坏。这有助于按影响面排序修复点位。

根因（#24 基础上确认到“表面规则之外”）

受影响维度的 default_block 全是 mod 块 且 sea_level 非原版（aether default_block=aether:holystone/sea -64、tofu default_block=tofucraft:tofu_terrain/63、sweet default_block=sweet_calamity:sponge_cake/50）。即便 surface_rule 是全 vanilla 节点（如 chaospersists 的 minecraft:sequence），挂在非原版 noise_settings/default_block 下仍失败。说明问题不全在 surface_rule 语法，而在“非原版维度/生成器/资源未被识别并放行回原版管线”。

（如需，我可补任一维度 A/B 的逐坐标抽样，或用脚本复现；我是 AI 分诊/取证的辅助记录。）

[unknowbug]

收到这份 A/B 对照数据，质量非常高（同种子、同 mod 集、region 逐方块 diff）——已并入分诊记录，两个关键更新：

1. 受影响面上调：不止 mod 自定义维度，原版末地也受影响（38% 差异），严重度上调。
2. 根因方向修正：同意你的判断——问题指向 replace 接管路径对非原版 noise_settings/default_block 资源的识别，而非 surface_rule 语法本身。

你给的"个别维度正常"反例（水晶 0.8%、混沌 0.02%）尤其有价值：它们与受影响维度的差异点很可能就是豁免/放行条件的判定依据，修复时会优先比对这些维度的生成器注册与资源路径差异。

已转人工维护者用于修复排程优先级评估（末地受影响意味着优先级不低）。如有进一步发现欢迎继续补充。—— AI triage assistant，人工维护者会最终确认。

[XuanZhiYouXuan2025]

提交给 CoreSwap 作者（unknowbug）。关于 mod 维度当前被破坏的问题、以及数据驱动支持 mod 维度的可行方向。
先说结论：你已经把"数据驱动多维度"的骨架做通了（create_for_dim + df_ns + JSON surface_rule），这让支持任意 mod 维度在方向上可行。当前 mod 维度被破坏，是因为引擎对非原版维度有 4 处结构性硬缺口。

---

一、问题现状

CoreSwap 目前 native 接管覆盖主世界 + 下界（对齐 99%+），其余维度按设计"回落 vanilla"。但当个整合包里出现 minecraft:noise 生成器 + mod 自定义 noise_settings/surface_rule/default_block 的 mod 维度时（Aether / TwilightForest / TofuCraft / SweetCalamity / ChaosPersists 等），实测会出问题：

• 这类维度几何（min_y/height）与原版三界相同，mixIn 按几何形状分派时被误判为主世界/下界，纳入 native 接管；
• 但 Rust 引擎只认识原版方块，mod 维度被生成为原版裸石 / bedrock（mod 专属地表与植被/特征块丢失）。

注：主世界+下界本身 99%+ 对齐，是正确接入的。问题只出现在「几何与原版相同、但用了 mod 专属数据」的维度。这也是 #24 里所指的"自定义维度被跳过 surface_rule"在 Rust 时代的表现。

二、已经打通的骨架（数据驱动方向是可行的）

能力	位置
任意维度句柄	WorldgenRust/src/worldgen_handle.rs create_for_dim(seed, wg_dir, settings_name, biome_params_file, world_height)
JNI 维度接线	api.rs wg_create；jni_bridge.rs initDim
维度参数数据驱动	worldgen_handle.rs min_y/height/sea_level/aquifers/legacy_random 从 settings 读
surface_rule 数据驱动解析	surface_rules.rs 支持 sequence/condition/block + not/biome/y_above/vertical_gradient/stone_depth/noise_threshold/hole/steep/water/temperature/surface 全节点
多世界方向	WorldgenRust/data-driven-boundary.md「多世界参数化」

也就是说 mod 维度只要数据能被引擎读到、方块/biome 能被识别，就能用同一套引擎生成。这正是你多世界方向的目标。

三、4 处结构性硬缺口（mod 维度被挡住的点）

1. 命名空间前缀写死 minecraft

引擎读取所有 worldgen JSON 都写死 data/minecraft/worldgen/...，mod 维度的数据在 data/<modid>/worldgen/...，读不到（除非被塞进 minecraft 目录）。

位置	硬编码
worldgen_handle.rs:147	data/minecraft/worldgen/noise_settings/{df_ns}.json
worldgen_handle.rs:207	data/minecraft/worldgen/density_function/{df_ns}
worldgen_handle.rs:302	data/minecraft/worldgen/biome
worldgen_handle.rs:778	data/minecraft/worldgen/configured_carver
feature_loader.rs:156/183/197/218	data/minecraft/worldgen/placed_feature / configured_feature
worldgen_handle.rs:182	density_function/overworld/base_3d_noise.json（还写死 overworld 子目录）

改法：把 data/minecraft/ 参数化成 data/{namespace}/（可用 settings_name 或新增一个 namespace 参数传入），L182 的 overworld/ 用 df_ns 替换。属小改。

2. mod 方块名解析为 air（最关键的硬墙）

BlockRegistry 只从 blocks.json（原版 dump）加载，id(未知名) → 0。所以 aether:holystone / tofu_terrain / sponge_cake 全部解析成空气。

位置	现状
blocks.rs:40-42	id(未知名) → AIR(0)
surface_rules.rs:1229/1406	default_block 硬编码 minecraft:stone（不读 settings 的 default_block）
worldgen_handle.rs:154-161/313	只读 noise/aquifers/legacy/sea_level，不读 default_block/default_fluid；Rock→minecraft:stone（L543）
worldgen_handle.rs:496-498/639-642/803-805	blocks.id("minecraft:...") 调用点

改法（关键）：新增一个 JNI 调用（或在 initDim 加参数），Java 侧遍历 Registries.BLOCK / Forge Registries，把 (方块名, rawId) 喂给 Rust；Rust 在 BlockRegistry 加 insert/merge。raw id 在同一次游戏会话内稳定（引擎写 rawId，Java writeChunk 用 Registries.BLOCK.get(id) 解码），所以会话语义正确。
→ 这不违背"数据驱动"原则——仍是"方块名→id"表，只是表源从静态 dump 变成运行时注册表 dump。

同时建议：surface_rules.rs 的 default_block、worldgen_handle.rs 的 Rock/Water/Lava 映射，改为从 settings 的 default_block/default_fluid 读取。

3. biome 参数表只含原版

BiomeClassifier（biome.rs:263）从 biome_params.json（原版 dump）加载；load_carvers/load_features（biome.rs:291/351）只 strip("minecraft:") 前缀 → 遇到 aether:skyroot_meadow 会去读不存在的 {biome_dir}/aether:skyroot_meadow.json。

改法：mod 维度用一份含 mod biome 参数行的 biome_params_<dim>.json，传路径给 initDim；load_carvers/load_features 的前缀处理参数化（支持非 minecraft 命名空间）。

4. density/noise 引用假定 minecraft: 命名空间（重工程分水岭）

density_builder.rs:174（get_noise_sampler 只认 minecraft: 键）、:232（resolve_ref 前缀 minecraft:{df_ns}）、:298（只放行 minecraft:overworld/nether）。

影响：如果某个 mod 维度定义了自己的 density_function / 噪声参数 / 自定义命名空间，引擎会 panic 或读不到。这类维度需要把 density/噪声注册表做成命名空间感知 + 全链端到端验证——属重工程。

四、工作量判断（供你评估）

• 对"复用 vanilla 地形数学、只换 surface_rule / default_block / biome / 方块"的 mod 维度（Aether / TwilightForest 大概率属于这一类）：
  • 核心机制是小改（命名空间参数化 + 读 default_block + mod 方块注册[1 个 JNI] + per-dim biome 参数表），大致几天；
  • 加上"每维实活"（从 mod jar 提取世界生成数据到引擎布局、核对噪声引用），整体几天~一两周。
• 对"自己定义 density_function / 噪声参数 / 自定义命名空间"的 mod 维度：需先泛化密度/噪声注册表命名空间再全链验证，重工程。

五、关于 mod 维度本身（也许值得一起考虑）

如果短期不想做完整数据驱动，一个最小兜底是：让 mixIn 只对已确认原生支持的维度（minecraft:overworld / minecraft:the_nether）做 native 接管，其余维度（含末地、全部 mod 维度）放行原版 Java 生成。

• 这样 mod 维度不被破坏（走原版正确生成），同时原版三界保留 native 加速；
• 也是你 docs/09 里"自定义 BiomeSource / 生成器类走 vanilla"边界的自然延伸；
• 改动很小（只动 mixIn 的维度判定，从"几何形状"改为"维度 RegistryKey 白名单"）。

六、期望

• 主世界 / 下界等标准维度：保留 native 加速（现状）。
• mod 自定义维度：短期内不被破坏（放行原版），长期可按上述数据驱动方向原生生成。

如需进一步说明，可补充具体 mod 维度（如 Aether aether:skylands）的 noise_settings/surface_rule/default_block 数据，作为数据驱动方向的实测参考。

[unknowbug]

这份源码级分析已收到并逐条复核——4 处缺口（命名空间写死、mod 方块→air、biome 参数表原版限定、density 命名空间假定）与维护侧源码状态全部吻合，非常有价值，谢谢。

两条结论供维护者评估参考：

1. 短期兜底方案（第四节第五节）方向被认可：mixIn 维度判定从几何形状改为确认白名单（主世界/下界），其余维度放行原版生成——改动小、立刻消除破坏面；
2. 数据驱动方向（第二、三节）与项目路线图一致：create_for_dim 骨架 + 4 缺口补齐路径已并入排程评估材料，你的工作量分层判断（复用 vanilla 数学的维度 = 几天~一两周；自定义 density = 重工程）很有参考价值。

有进一步实测或分析欢迎继续补充。—— AI triage assistant，人工维护者会最终确认。

[unknowbug]

修复已发布 — coreswap-1.20.1-1.0.25

修复已随 1.0.25 发布，感谢报告者的同种子 A/B 数据与源码级分析——修复方案（维度白名单）正是基于这些工作。

修复内容：维度接管判定从"几何形状指纹 + 裸反射"重构为 noise_settings 注册表 id 感知——仅 minecraft:overworld/minecraft:nether 接管原生引擎，末地与全部 mod 维度放行原版管线（不再损坏）。

请复测：用 1.0.25 重跑你的全维度 A/B：

• 末地 / aether / 糖果 / 豆腐 等维度应与"CoreSwap 禁用"结果一致（差异仅剩主世界/下界的原生加速差异）
• 主世界/下界生成不回归

复测结果出来后本帖即可关闭；如仍有异常请直接留言。—— AI triage assistant，人工维护者会最终确认。

[unknowbug]

进展更新：1.0.26 已发布——末地维度实现全原生（与 vanilla 逐位一致，36/36 chunk 零差异），且 mixin 维度分派改为 settings id 判别（1.0.25 白名单方案的延续加固）。

复测请直接用 1.0.26：全维度 A/B 中末地应不再与 vanilla 有差异；aether/糖果/豆腐等 mod 维度继续走原版管线（与禁用 CoreSwap 一致）。mod 维度原生支持在路线图上（数据驱动多世界线）。