Isekai API 是一个用于构建 Minecraft 世界 形态与规则 的工具箱——它不是提供一个现成的世界,而是提供制造世界的“机器”。 就像网页开发中的 div/span 一样,它提供了一组中立、可组合的基础原语(primitives),你可以将它们自由组合,仅通过数据包 JSON 就能构建出你想象中的 任何 世界。它本身不附带任何生物群系、结构或主题。
两个文件即可打造浮空岛世界
在你的维度配置中引用随附的 isekai_api:hooked_overworld 预设,然后覆盖一个小型的地形形状钩子(hook)文件。无需编写 Java 代码,也无需复制原版长达 2500 行的 noise_settings ——只需修改钩子,整个世界的外形就会随之改变。可运行的示例:examples/1_shape/floating_island/。
你可以控制什么
每一个 世界生成的轴向,均由可组合的原语构成:
- 地形形状 — 17 种数学/几何密度原语 + 5 种世界形状合成器(
squeeze、y_envelope、blended_noise、band_density、sloped_density)。支持浮空岛、悬挂或倒置的大陆、空心壳层、封顶山脉、镜像/平铺空间——在任意 Y 轴带上的任何 3D 形态。 - 生物群系放置 —
isekai_api:rule生物群系源通过纯粹的空间规则来放置生物群系:垂直分层、同心环、区域,以及and/or/not组合逻辑(例如y_below 20 -> deep_dark)。无需调整气候噪声。 - 表面与填充 — 通过 JSON 重新皮肤任何生物群系的顶层方块或石头填充物。
isekai_api:vanilla_overworld_surface将原版超平坦地表规则作为一行代码提供给你,从而替换地表时无需复制那 30 KB 的内容。 - 新维度 — 将上述功能与原版的维度 JSON 结合,即可发布整个全新维度。零 Java 代码,零原版编辑。
- 大气效果 — 每个世界独立的天空、雾气和水体颜色。
- 场景、特性与树木 — 使用可组合的部分构建中性内容:仅在平坦干燥的地面上投放手工编写的 NBT 场景组件(
grounded_template),生长连接的方块簇和流体池,并从任意树干 + 树冠放置器组装防腐烂的树木。没有内置的主题——由你提供方块。 - 放置控制 — 精确决定特性/结构的位置:相对于地表或流体、基于方块上下文、Y 轴范围、坡度、距离特定方块或生物群系的远近,以及逻辑组合。
- 重新放置现有内容 — 获取任何原版 或模组 的矿石、结构、生物或特性,并将其重新分配到新世界形状中。原版深埋的稀有矿石可以重新映射到浮空岛的底部。策略包括:线性、反向、固定范围、计数缩放、带宽分割、管道——以及排除/添加选项。
- 基于地形的重新放置 —
isekai_api:column_local会根据 每一列自身的 地表和底部来计算矿石深度,而不是使用单一的绝对 Y 轴带。无论是浮空岛、环绕行星还是天空大陆,无论处于何种高度,它们内部的矿石布局都保持一致。 - 启动时验证 — 服务器启动时即可捕获损坏或拼写错误的注册表引用,防止其静默失效(no-op)。
- Java API —
Isekai.query()读取原版/模组的世界生成规则;Isekai.remap()在代码中声明世界形状。
专为扩展而构建
Isekai 并不绑定于某一个特定的世界或作者。无论你希望如何使用它,我们都欢迎 ——无论是数据包世界形状、完整的 Java 模组、整合包胶水代码、快速实验,还是彻底转换。采用 MIT 许可证:免费使用、分叉,并可捆绑在整合包中。
- 数据包作者: 数据包参考文档 列出了每个键及其 JSON 形状;从
examples/中复制一个可运行的骨架——形状、放置和适配各自拥有独立的文件夹。 - Java 模组开发者: 将
isekai_api添加为 Gradle 的compileOnly依赖项(通过 Cursemaven 或仓库自己的 maven 分支——详见 兼容性说明)并使用Isekai外观类。除api包之外的所有内容均为内部实现,因此公共接口保持小巧且稳定。每个版本均附带源码和 Javadoc jar 包。 - 扩展库本身: 五个分发接口——空间谓词、重映射策略、生物群系区域、地表锚点、过渡规则——均是基于注册表的扩展点。可以从你自己的模组 ID 注册你自己的变体,并在 JSON 中与内置项一起使用。无需分叉,无需提交 PR。
- 问题、想法、Bug: 提交 Issue。用 Isekai 构建了世界?分享一下——我很乐意看看大家做出了什么作品。
MIT · 源代码与文档。与“Isekai Adventure”整合包无关。

接受视频、直播和服务器的付费委托。发送你的想法至:kuronami.mods@gmail.com

Isekai API is a toolbox for the shape and rules of a Minecraft world — not a world, but the machine that makes worlds. Like div/span for web pages, it's a small set of neutral, composable primitives you combine to build any world you can imagine, straight from datapack JSON. It ships no biomes, structures, or themes of its own.
A floating-island world in two files
Reference the shipped isekai_api:hooked_overworld preset from your dimension, then override one small
terrain-shape hook file. No Java, and no copy of vanilla's 2500-line noise_settings — change the hook
and the whole world changes shape. Runnable example: examples/1_shape/floating_island/.
What you can control
Every axis of world generation, as composable primitives:
- Terrain shape — 17 math/geometry density primitives + 5 worldshape composers (
squeeze,y_envelope,blended_noise,band_density,sloped_density). Floating islands, hanging or inverted continents, hollow shells, capped mountains, mirrored/tiled space — any 3D form on any Y band. - Biome placement — the
isekai_api:rulebiome source places biomes by pure spatial rules: vertical layers, concentric rings, regions, andand/or/notcombos (y_below 20 -> deep_dark). No climate-noise tuning. - Surface & fill — re-skin any biome's top block or stone fill from JSON.
isekai_api:vanilla_overworld_surfacehands you the whole vanilla overworld surface rule as one line, so overworld replacements skip the 30 KB copy. - New dimensions — combine the above with vanilla dimension JSON to ship a whole new dimension. Zero Java, zero vanilla edits.
- Atmosphere — per-world sky, fog, and water colors.
- Set-pieces, features & trees — build neutral content from composable parts: drop a hand-authored NBT set-piece only on flat, dry ground (
grounded_template), grow connected block clusters and fluid pools, and assemble decay-safe trees from any trunk + foliage placer. No themes baked in — you supply the blocks. - Placement control — decide exactly where features/structures go: relative to surface or fluid, by block context, Y range, slope, proximity to a block or biome, and logical combos.
- Re-place existing content — take any vanilla or modded ore, structure, mob, or feature and redistribute it into your world's new shape. A rare ore vanilla buries deep can be remapped to the underside of your floating islands. Strategies: linear, inverted, fixed-range, count-scaling, band-split, pipelines — plus exclude/add.
- Terrain-relative re-placement —
isekai_api:column_localresolves an ore's depth against each column's own surface and underside instead of one absolute Y band. Floating islands, orbiting planets and sky continents get the same internal ore layout whatever altitude they sit at. - Boot-time validation — broken or mistyped registry references are caught at server start, before they silently no-op.
- Java API —
Isekai.query()reads vanilla/modded worldgen rules;Isekai.remap()declares worldshapes in code.
Built to be built on
Isekai isn't tied to any one world or author. However you want to use it, you're welcome — datapack worldshapes, full Java mods, modpack glue, quick experiments, total conversions. MIT licensed: free to use, fork, and bundle in modpacks.
- Datapack authors: the Datapack Reference lists every key with its JSON shape; copy a runnable skeleton from
examples/— shape, placement, and adaptation each have their own folder. - Java modders: add
isekai_apias acompileOnlyGradle dependency (Cursemaven, or the repo's own maven branch — see COMPATIBILITY) and use theIsekaifacade. Everything outside theapipackage is internal, so the public surface stays small and stable. Sources and javadoc jars ship with every release. - Extend the library itself: the five dispatch interfaces — spatial predicates, remap strategies, biome zones, surface anchors, transition rules — are registry-backed extension points. Register your own variant from your own mod id and use it in JSON alongside the built-ins. No fork, no PR.
- Questions, ideas, bugs: open an issue. Built a world with Isekai? Share it — I'd love to see what people make.
MIT · Source & docs. Unrelated to the "Isekai Adventure" modpack.

Paid commissions for videos, streams and servers. Send me your idea: kuronami.mods@gmail.com

下载 Isekai API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Isekai API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Isekai API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Isekai API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Isekai API
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
破坏性变更
- 生物生成变更现在按维度作用。
exclusions.mob_spawns、additions.mob_spawns、mob_spawn_strategy和mob_spawn_strategy_by_category之前会重写共享群系的生成器;它们现在仅对描述符所在维度生效。其他维度中的相同群系保留其原始列表。 - ** carve 排除项与添加项在基于噪声的维度中按维度作用。**
exclusions.carvers和additions.carvers现在仅在声明的维度(当其生成器为NoiseBasedChunkGenerator)内生效。使用其他生成器的维度仍保留旧的群系级编辑行为(参见限制条件)。 - 其他模组的功能遵循声明的作用域。 其他模组添加到已声明群系的功能会从共享群系中移除,并作为受保护的副本重新注入到声明该功能的维度中。未声明 worldshape 的维度将不再接收它(
ForeignFeatureReconciler)。 - 内部签名已更改(
@ApiStatus.Internal,无兼容性承诺):ModifyPhase.mobSpawnStrategy(WorldshapeDescriptor, Holder<Biome>)、RemovePhase.excludedCarvers(WorldshapeDescriptor, ResourceKey<Biome>, …)以及AddPhase.additionalCarvers(WorldshapeDescriptor, ResourceKey<Biome>, …)。 - 2.x 数据包加载方式不变,但作用域发生变化。 相同的 JSON 现在仅影响一个维度,而非所有共享该群系的维度。依赖旧版跨维度泄漏行为的数据包必须为其他维度声明描述符。
ClientAtmosphereOverride新增了skyColor组件。 记录结构现为(skyColor, fogColor, fogNearDistance, fogFarDistance);三参数构造函数已移除。源码调用者需传入Optional.empty()作为skyColor,编译过的调用者需重新编译。
新增
-
装饰生成时按维度投放特性。
ChunkGeneratorDecorationMixin在ChunkGenerator#applyBiomeDecoration中重定向了generationSettingsGetter.apply(biome);DimensionFeatureScope移除了正在生成该区块的维度所记录的控制权集合。该集合由 ADD 阶段记录,因此移除与注入副本始终一致。 -
自定义生成器的最终特性否决权。
PlacedFeatureScopeMixin在PlacedFeature#placeWithContext头部注入并拒绝相同的控制权值,因此完全重写applyBiomeDecoration的生成器也会遵守exclusions.features、feature_predicates和ore_strategy。 -
注入的特性携带
isekai_api:dimension_guard。additions.features、重映射副本以及feature_predicates副本仅在描述符所在维度内放置。 -
结构排除项按维度作用域划分。
StructureFindValidGenerationPointMixin在搜索生成点期间进行否决。在区块生成过程中,维度信息来自ChunkDimensionIndex(一个弱引用ProtoChunk→ 维度索引);/locate和/place直接使用层级数据;仅当索引匹配失败时才回退到匹配BiomeSource。 -
生物生成规则在运行时读取点强制执行。
MobSpawnScope持有每个(维度、生物群系)的规则。NaturalSpawner#mobsAt(RETURN) 和spawnMobsForChunkGeneration(getMobs重定向) 过滤列表;MobSpawnVetoHandler在FinalizeSpawnEvent(LOWEST) 取消那些从未读取列表的路径,因此排除项也涵盖巡逻队、刷怪笼、生成蛋和/summon。 -
挖掘器规则在挖掘时强制执行。
NoiseBasedChunkGeneratorCarverMixin在NoiseBasedChunkGenerator#applyCarvers中重定向了ChunkAccess#carverBiome;CarverScope对每个(维度、生物群系)应用记录的添加/移除规则。 -
client_atmosphere在专用服务器上推送至客户端。 服务器在登录、/reload和维度切换时通过可选的isekai_api:client_atmosphere通道发送活跃的 Y 区间;客户端在回退到自身注册表之前应用这些设置,从而使天空和雾气与服务器加载的内容一致。原版客户端和不包含该通道的客户端不受影响。 -
/isekai validate dimension <id>报告LevelStem配置(构建高度、海平面、默认方块、天花板)以及静默失败:applies_to未匹配任何生物群系、playable_range超出构建高度、未解析的生物群系标签、在该维度中被跳过的特性。 -
/isekai validate dimension <id>中的起始点安全性。 对于声明了世界形状(worldshape)的维度,报告将增加一行spawn OK/WARN/ERROR/SKIP:起始点下方第一个实心方块(最多 32 格)为立足点,其上方两格必须既非实心也非流体,水是警告,而岩浆、被埋藏的起始点或无立足点则是错误。起始点为世界共享出生点,或其他维度的 (0,0)MOTION_BLOCKING_NO_LEAVES高度图位置。 -
世界形状可限制为特定维度类型。
dimension还接受{ "dimension": "<key>", "required_dimension_types": ["<type>", …] };若层级的dimension_type不在列表中则保持不变。这允许一种可选的世界类型将其世界形状保留在共享minecraft:overworld键的原版世界之外。字符串形式和空列表表示无限制(即 2.x 行为)。Java:Scope(api/remap) 作用于WorldshapeDescriptor。 -
DimensionProfile(api/query) 和IsekaiQuery.getDimensionProfile(ResourceKey<Level>)在ServerLevel存在之前暴露维度的垂直边界、海平面、默认方块/流体以及DimensionType标志。 -
下界预设。
isekai_api:hooked_nether(min_y 0,height 128,海平面 32,下界岩/岩浆默认值,旧版随机源),带有isekai_api:hook/final_density_nether和isekai_api:vanilla_nether_surface。独立的钩子 ID 确保对hook/final_density的主世界覆盖不会影响到下界。 -
按维度作用的天空颜色。
client_atmosphere.sky_color(0xRRGGBB)在描述符生效期间替换生物群系的天空颜色,其解析方式类似于雾气覆盖项,取决于相机 Y 坐标。仅更改采样的基础颜色:原版的日夜、雨雷和闪电闪光着色仍然适用。由ClientLevelSkyColorMixin承载,因此仅存在于客户端,并且它适用于effects为minecraft:overworld的维度(即原版天空路径)。 -
isekai_api:none树叶放置器。 一片虚无的树冠,使得minecraft:tree特性可以放置没有叶子的光秃树干。radius和offset是可选的,默认为0,这使得{"type": "isekai_api:none"}本身即为有效配置。 -
六种树木装饰器。
minecraft:tree的decorators数组现在接受isekai_api:前缀的部分:attach_to_logs(附着在树干侧面的方块)、ground_patch(围绕基部的圆盘状方块,cover或replace)、hang_from_leaves(从树冠底部垂下的枝条)、snow_cap(朝向天空的叶子上的雪层)、branch_stubs(从树干伸出的光秃树枝,每个axis跟随步骤,方块可选以便复用树干自身的方块)和broken_top(折断顶部count个树干方块,至少保留一个;可选的fill_provider将断裂处变为玄武岩或木炭而非空气)。每个方块都是一个block_provider槽位,因此各部分不携带物种信息;装饰器写入的叶子状态会锁定distance,使其不会腐烂。字段和烧焦树木示例见docs/DATAPACK_REFERENCE.md。 -
TreeGrowers(api/wood) 根据配置的特性键构建树苗所需的TreeGrower—— 普通、巨型、次要和花朵形态 —— 使用 Isekai 自己的命名约定,因此一套木材无需手写八参数构造函数;一套木材将结果传递给WoodSet.Builder#sapling。 -
无叶树固定场景与覆盖范围。 GameTests 从磁盘通过真实配置的 feature 注册表加载一棵无叶、带枝干的树,并验证树干、短桩、Snap 和地面环,同时对新放置器和装饰器的编解码器往返测试进行断言。该固定场景及其测试包装类不会打包进 jar 文件(位于
data/isekai_api_test/**和gametest/**)。 -
/isekai validate <namespace>报告缺失的木材集文件。 对于命名空间中通过WoodSet声明的每个物种,它会检查该物种部件所隐含的战利品表、方块和物品标签、配方、语言键、方块状态、模型和纹理,并按类型和主题列出每个缺口。对于当前环境不可见的成员(专用服务器上的仅客户端资源包),会被计为“此处不可见”而非缺失。这能在游戏中出现紫黑棋盘格之前捕获缺失的纹理。 -
examples/4_wood/下的单物种示例。ExampleWoodMod声明了一套完整的木材集(原木、木头、去皮变体、木板、楼梯、台阶、栅栏、栅栏门、门、活板门、压力板、按钮、告示牌、树叶、树苗、盆栽树苗、船只)及其数据生成;旁边的资源包包含带有isekai_api装饰器的配置化特征。该类仅在 GameTest 服务器上编译和加载,且不随 jar 文件分发。 -
WoodSet.Builder#flammable(boolean)。 声明为flammable(false)的木材集会被排除在火灾概率地图之外,其原木会数据生成到#logs而不是#logs_that_burn,因此原木和木板都不会蔓延火焰或烧毁;WoodSet#isFlammable()会报告该设置。有一项无法关闭:每个方块都保留了从其复制的橡木属性中的 vanillaignited_by_lava标志,因此岩浆仍能将其点燃。 -
木材集审计涵盖告示牌纹理。 包含
sign或hanging_sign的木材集还需要textures/entity/signs/<path>.png、textures/entity/signs/hanging/<path>.png和textures/gui/hanging_signs/<path>.png,这些由WoodSets.signTexture和WoodSets.hangingSignGuiTexture命名。示例资源包提供了这三个文件。 -
isekai_api:pool接受shore_width。shore_width(整数 0–6,默认值 0)将池子的边缘方块向外扩展这么多圈,从而使池塘拥有沙滩而不是一圈方块宽的水岸。这些圈层通过邻接关系从外壳生长,因此河岸遵循盆地的真实轮廓,且仅替换实心单元格(在水线以下始终替换,水线以上一半时间替换——与外壳使用的规则相同)。它不改变容纳性:如果地形无法容纳,池子仍然拒绝生成。0是旧版的单圈模式,也是默认值,因此现有的数据包会放置相同的方块。 -
isekai_api:leaning树干放置器接受slant_curve、space_check和min_height。slant_curve(双精度 1.0–2.0,默认值 1.0)使每一步横向移动的距离增加,从而让相同的lean_length覆盖更多地面,并使弯曲加速而不是形成 L 形;1.0 表示每步一个方块,且与旧版树木字节级一致。space_check(布尔值,默认值 true)在有单元格的单元格处结束倾斜并保持树冠在树干上——参见 Fixed。min_height(整数 1–16,默认值 4)当树干高度不足时不生成任何内容,这正是刻意设计的矮棕榈树所需要的。省略所有三个参数的数据包将获得旧版形状。 -
isekai_api:leaf_distances结构处理器。 根据模板自身的#minecraft:logs方块重新计算粘贴模板的叶子衰减数据:接触原木的叶子距离为 1,每经过一级叶子 +1,当无法到达原木时为 7。orphan_leaves(decay|persist,默认值decay)决定无法到达的叶子是自然衰减还是标记为持久存在,keep_persistent(默认值 false)决定模板叶子现有的持久存在标志是否保留。它在finalizeProcessing中运行,因此能看到早期处理器生成的状态。之前保存时所有叶子距离均为 7 的模板,在第一次形状更新时不再脱落整个树冠。 -
isekai_api:grounded_template接受processors列表。 这与 jigsawsingle_pool_element拥有的字段相同:处理器列表 ID 或内联编写的列表,在片段粘贴模板时应用。省略此项则按保存的原样放置 NBT,这也是现有数据包已经获得的行为。在此处附加isekai_api:leaf_distances可以修复手动编写的树木,而无需通过 jigsaw 池路由。 -
isekai_api:grounded_template改变形状。rotation(默认值为none,加上clockwise_90、clockwise_180、counterclockwise_90、random)和mirror(默认值为none,加上left_right、front_back、random)旋转或翻转粘贴的模板,且template现在也接受加权列表,因此一个结构条目可以共享多个 NBT 变体。random从区块的结构种子中为每次放置尝试抽取一次。闸门采样旋转后的极值范围,因此旋转四分之一的模板会根据其实际覆盖的地面进行判断,并且模板在任何方向上都保持在区块中心。省略新字段的数据包会放置与之前相同的方块。 -
/isekai survey <structure> [radius]在一个方块区域的 chunk 上重放结构放置过程,并报告结构集提供的 chunk 数量、实际放置的数量,以及其余部分被哪个闸门拒绝的原因(clearance_above_fluid、max_slope、biome,或具有自身原因的结构类型的declined)。不会向磁盘写入任何内容,也不会加载任何 chunk,因此它能回答“为什么这个结构从不生成”的问题;相同的数字会写入<world>/isekai/survey/<ns>_<path>-r<radius>.json。拒绝归因通过StructureProbe运行,该探针在调查之外处于非活动状态。 -
/isekai fit <structure> [pos]以完整细节显示一个 chunk:WORLD_SURFACE_WG高度
门(gates)被读取为一个 3x3 网格,针对 clearance_above_fluid 和 max_slope 的最小值/扩散范围,判决结果,以及 vertical_offset 如何将每个模板变体定位。它还标记了会导致结构无声消失的两个制作错误:没有 NBT 的 template ID(报告为 0x0x0)以及任何结构集都不提供的区块。写入至
<world>/isekai/fit/<ns>_<path>-<chunkX>_<chunkZ>.json。
-
/isekai survey blocks <block|#tag> [radius] [center <x y z>] [biome <biome|#tag>]统计实际进入每个区块的内容:它生成正方形区域(默认半径 8,最大 32)到FEATURES,分多个刻执行,并报告树木、匹配的方块、均值/中位数/最小值/最大值、空区块的比例、最繁忙的 10% 区块中占据的总量比例,以及直方图。一棵树是区块内一个六连通的匹配方块组,因此 2x2 的树干只算一次,倾斜的树干也只算一次。可选的生物群系过滤器基于种子数据回答,因此跳过的区块永远不会被生成。每个区块的地图和相同的摘要信息写入至<world>/isekai/survey/blocks-<target>-r<radius>.json。此项确实会将地形生成到磁盘。 -
isekai_api:curved树干和isekai_api:frond树冠。 一种在攀爬时弯曲而非笔直上升然后横向移动的棕榈树:每一层都在倾斜侧添加一根原木,且随着高度增加弯曲几率增大(bend),弯曲的原木采用倾斜轴向,单个树冠位置位于顶部原木上。frond生长出八个拱形下垂的羽状叶(对角线作为面连接的楼梯),每片羽状叶采样一次,因此俯视效果是八角星形而非十字形。leaning和fan保持不变。 -
fluid_edge可以搜索一定高度范围内的流体。 可选的vertical_range({"below": n, "above": n},两者均为 0–64,默认为 0)将流体搜索范围从输入 Y 坐标扩展至Y-below … Y+above。现在一个修饰符即可表达“海平面以上 18 格范围内任意 12 格内无水”,这以前需要一层链式修饰符加上每层的一个 Y 锚点。省略该字段则仅读取输入 Y,因此现有资源包行为完全不变;扩展后的路径也在每列的MOTION_BLOCKING高度停止,因此开阔海域每列只需一次查找,而非每层一次。 -
isekai_api:biome_falloff根据距生物群系的距离以概率放置特性。P(d) = t^exponent,其中t = (max_distance - d) / (max_distance - full_distance):在full_distance内保持全密度,超过max_distance后为零,中间平滑过渡,使得生物群系边界呈现为密度渐变而非线条。full_distance = max_distance给出硬半径——这是spatial_predicate的near_biome在放置时无法做到的(它在放置时总是通过)。距离测量从未发生:一次绘制变为搜索半径,并遍历生物群系单元环直到首次命中,因此靠近生物群系的位置只需少量采样(最坏情况在step为 4 且范围内无生物群系时:32/64/128 格半径分别为 197/797/3,209 次采样)。vertical_range覆盖那些随海拔变化生物群系的维度。生物群系单元会在区块其余候选项处理期间按线程记住,因此上述最坏情况(下界中 64 格半径下每区块 76,741 次采样,耗时 29 ms)仅需 0.9 ms。 -
isekai_api:override包装另一个生物群系源,并在区域足迹内替换生物群系。 未被任何区域声明的部分由base回答,因此基础自身的规则、种子和气候采样继续工作——在 otherwise vanilla 地形中创建丛林岛屿或单生物群系区域,而不放弃原版源。区域按声明顺序评估,首个匹配生效。附带两个新区域:isekai_api:box(包含边界的块空间 X/Z 矩形,可选min_y/max_y)和isekai_api:chunk_box(包含边界的区块对齐矩形,全高度)。覆盖会改变表面生物群系——表面方块、植被、结构和特性资格、生成点、天空和雾的颜色——但不改变地形形状,后者仍由基础生成器的气候噪声决定;海洋上的补丁仍保持海洋形状。仅限新生成的区块。 -
base_biome和climate区域读取世界数据,而不仅仅是坐标。isekai_api:base_biome(biome: 一个 ID、列表或#tag)匹配条件为包装源的自身答案是这些生物群系之一,因此override补丁跟随基础的边界而非绘制的矩形——在下界中所有灵魂沙山谷都变成绯红森林,或在主世界 Y 80 以下变为森林。isekai_api:climate匹配原版气候采样在六个轴中的任何一个(至少需要一个),因此一个climate_zones规则现在可用于任何区域位置,包括override,其中替换生物群系和继续决定地形的气候保持独立。源对每个位置填充这两个值一次,并在区域间共享,因此一组气候条件只需一次采样;base_biome仅在override下有意义,在rule下返回 false,因为后者没有可查询的包装源。Java 版:BiomeZone.test(x, y, z, ZoneContext)是新重载,ZoneContext(NONE,forClimate)携带状态;三参数方法、其默认值及现有第三方区域保持不变。在 200,000 个位置上测量(getNoiseBiome的纳秒数,三次运行的中位数):包装下界零成本(122 → 122),15 个and(base_biome, noise_threshold)子节点成本 327 —— 先写噪声再写其他同样 15 个的成本为 923,因此base_biome应放在前面。 -
/isekai survey biomes <半径> [中心 <x y z>] [y <y>]用于在不生成世界的前提下测量种子文件的生物群系分布图。 它通过生物群系数据源对圆盘状区域内的每 4 格垂直列进行采样,因此得到的生物群系占比为精确计数。系统将面相邻的同种生物群系单元格合并为“斑块”,并以等效圆直径报告其面积(公式为2*sqrt(面积方块数/pi),例如一个半径为 64 的斑块显示为 128)。与边界接触的斑块会被计入总数,但排除在中位数和 P90 值之外,同时报告被排除的数量。该扫描还会报告六个原版气候轴的非量化百分位数据(P1…P99),并同时标注 JSON 名称与 F3 调试界面名称(如humidity/vegetation、weirdness/ridges)。此操作不会生成任何内容,也不会加载任何区块,因此扫描会在服务器刻更新的间隙于工作线程中运行;每个服务器同一时间仅允许运行一次biomes扫描,且必须指定半径(范围 16–4096 格,默认使用执行者所在位置及 Y 坐标)。结果写入<世界目录>/isekai/survey/biomes-<维度>-r<半径>-<x>_<y>_<z>.json;在 GameTest 服务器中测试,半径为 2048 时涉及 823,592 个单元格,耗时约 0.3 秒。
修复
isekai_api:assembled将生成位置置于地面,而非树冠。 之前的 Y 坐标直接取自WORLD_SURFACE_WG(该值会计算树叶和原木),因此如果相邻树木的树冠覆盖了生成位置的列,整个特征列表就会被抬升至树冠层:导致出现一个悬空的池塘(其包含性检查拒绝放置它)以及一块在树高位置铺设的沙地。现在 Y 坐标会向下穿过空气、#minecraft:leaves、#minecraft:logs及可替换植物,直到遇到第一个地形方块并停止;如果遇到流体则保持在水面处作为生成位置,从而确保水上结构保留其水面生成位置。isekai_api:assembled仅生成一次特征,而非针对每个重叠区块各生成一次。 之前组件的postProcess会为其边界框重叠的每个区块运行一次,且每次都有各自的随机种子,因此一个宽三区块的组合地标可能会重新生成整个特征列表多达九次,并在同一地点堆叠九个形状不同的池塘和树丛。现在执行逻辑限制在包含生成位置的区块内,这不受区块访问顺序的影响。特征仍可能写入超出该区块的范围,正如place特征在装饰阶段所做的那样。- 当启用
space_check时,倾斜树干不再将其树冠连接到被占用的单元格。 开启space_check(新默认值)后,若倾斜路径碰到被占用的单元格,则在此停止,树冠保留在树干上;此前树冠可能悬浮在无原木可放置的空中。设置space_check: false可复现旧版形状。 - 同一维度键的不同维度类型的 Worldshape 共存。 单层声明是按维度键一对一存储的,因此 Sky World 形状(
sky_world:sky)和 Tundra World 形状(frozen_world:frozen)若都指向minecraft:overworld,则会因加载顺序相互覆盖,导致一种世界类型完全没有形状。现在声明按Scope分组;getActiveDescriptor会选择其required_dimension_types包含关卡实际dimension_type的那个(优先匹配受限类型而非无限制类型,其次按更高priority排序)。同 scope 的声明保留旧的优先级规则。如果类型未知且存在两个受限声明,注册表将返回空而不是猜测。 - Worldshape 边界按维度解析。 矿石/特征的 Y 重映射和
playable_range包络线曾对所有维度使用主世界的min_y/height。现在它们来自维度的LevelStem/DimensionType,由描述符的dimension索引。只有没有LevelStem条目的关卡才会回退到主世界包络线。 - 无声明即无消耗。 每个钩子在注册表或生物群系查找前,若检查为空则立即返回;当未声明任何 worldshape 时,协调过程也会立即返回。
- 装饰器不再继承 2x2 树干的底层方块。
TreeDecorator.Context#logs()携带由TrunkPlacer.setDirtAt写入的每列树干的一个方块(对于草地上的giant_trunk_placer是四个),但之前只丢弃了第一个。因此,没有block_provider的branch_stubs可能会从泥土中获取方块,导致起始位置低了一行。现在,最底层的每个类似泥土的条目都会被丢弃,前提是上方有树干方块。 - 木材集审计以游戏的方式读取引用。 模型
parent中的裸路径、textures值或方块状态model解析为minecraft:,而非命名该文件的命名空间;无效的资源位置值会导致生成reference发现项,而不是使整个审计失败。/isekai validate <namespace>会在木材集审计之前打印验证结果,且审计失败会被记录并报告为一行,而不是被隐藏。 broken_top的fill_provider使用装饰器放置辅助工具。 用作填充物的树叶像其他所有由装饰器放置的树叶一样被固定,而不是在distance: 7处写入。- 仅在注册成功后才认领木材集的构建器。 之前
register()中途失败不会留下标记为已注册且不可用的构建器。 WoodSets支持并行模组构建。 NeoForge 并行构建模组;集合列表和船只查找现在使用并发集合。- 文档说明:固定的树叶不是永久树叶。
LeafPlacing、docs/DATAPACK_REFERENCE.md的放置者部分以及 README 现在指出,固定操作使树叶通过生成阶段,且在第一个 tick 重新计算真实距离,因此距离原木超过六格的树叶会像原版树叶一样衰减。行为保持不变。 - 文档说明:
ground_patch的半径限制有其明确原因。 16 是能完全留在特征可能写入的区块内的最大圆盘(ChunkStatus.FEATURES会向外写入一个区块),而将特征生成位置移动到相邻区块的放置修饰符仍可能超出此范围。 - 倾斜树干的水平移动上限为 12 格。
slant_curve是指数级的,因此slant_curve为 2.0 且lean_length为 16 时,横向移动了 131,071 格——远远超出了特征放置所在的区块,树冠也附着在那里。现在茎干在距离生成位置总水平移动 12 格时停止(接近垂直的倾斜计入其中)。slant_curve为 1.0 且lean_length为 13–16 的情况也在同一限制下截断;所有保持在 12 格以内的配置(包括最高至 12 的 1.0)生成效果与之前完全相同。 - 启用
space_check的倾斜树干将其树冠保留在其放置的最后一个原木上。 对占用单元格的修复移动了树冠,但返回的连接点仍指向预期的结束位置,因此装饰器或tip_crown_only扇形仍可能悬挂在没有原木支撑的位置。现在的最后一个连接点就是最后放置的原木本身。space_check: false保持旧几何结构,供故意复现该效果的整合包使用。 /isekai survey blocks不再声称耗时低于 8 毫秒。 区块生成运行于
服务器线程在刻内运行,因此每刻处理一个区块意味着每个区块耗时数十毫秒,且在运行期间 TPS 会下降;刻循环只能决定是否开始处理下一个区块,而无法将一个区块拆分。文档和 README 现已明确说明这一点,并且每区块计数被声明为下限,因为后续区块的树仍可能写入已被计数的区块。
- 同一服务器在同一窗口期内仅允许运行一次
/isekai survey blocks。 如果第二次运行与第一次在同一刻内交错进行,会导致相同区块被重复计数;现在系统会拒绝该请求,并提示当前仍在进行的运行任务。 isekai_api:pool中的shore_width(岸宽)已从xz_radius(XZ 半径)中分离。 此前,当半径加上大于特征可达范围(15 个方块)的岸宽时,会在区块边界处被截断,导致边缘呈直线而非河岸。现在有效半径等于xz_radius减去shore_width(向下取整),因此当xz_radius为 14 且shore_width为 6 时,实际覆盖范围为 15 而非 19。对于半径与岸宽之和已适配的池塘则保持不变。/isekai fit命令会显示所测量的变体。 之前的判定仅描述一种足迹——即第一个未旋转的模板变体——但报告看起来似乎涵盖了所有变体,而rotation: random(随机旋转)会为每个区块绘制不同的朝向。现在摘要会指明所测量的模板和旋转方式,JSON 输出中也包含measured_template/measured_rotation字段。/isekai validate dimension不再生成其检查的区块。 在非主世界维度中,若 (0,0) 区块未加载,则报告spawn SKIP(该列未被采样),而不是读取高度图和方块数据(这些操作会加载或生成该区块)。站在 (0,0) 坐标或使用/forceload add 0 0强制加载即可获得判定结果。- 墙壁告示牌使用独立的语言键进行检查。 物种审计原先通过
getDescriptionId()构建每个方块的语言键,而原版墙壁告示牌返回的是直立告示牌的名字,因此墙壁告示牌的关键字从未被检查,而立直告示牌的关键字却被检查了两次。现在会报告缺失的<ns>:<species>_wall_sign名称(以及悬挂式墙壁告示牌的名称)。 - 池塘围绕原木和树叶修建边缘,而不是将其掩埋。 新的边缘遵循原版
LakeFeature的规则,仅覆盖那些为固体且不在minecraft:lava_pool_stone_cannot_replace(熔岩池石头不可替换)列表中的方块,因此当池塘触及树木时,会沿着树干修建河岸;加宽的shore_width也遵循相同规则。 - 带有
space_check(空间检查)的倾斜结构在遇到垂直主干上的阻塞方块时停止。 此前主干会跳过原木继续攀爬,导致树冠悬空而茎干连接在空洞上方;现在树冠将停留在最后一个存在的原木上。 - 盆栽树苗的日文名称遵循原版的语序:对应
block.<ns>.potted_<species>_sapling的翻译为植えられた〈樹種〉の苗木,例如植えられたオークの苗木。 - 由
offset(偏移量)抬升的frond(蕨叶状树冠)不再悬垂于主干之外。 叶子距离遵循面接触原则,因此将树冠抬升至顶部原木之上会导致所有蕨叶仅通过对角线接触:整个树冠超出第六步范围,并在被刻刷新时立即腐烂,而未受影响的叶子则保留其生成时的固定状态并隐藏了这一缺陷。现在抬升区域会被填充树叶,且抬升消耗与蕨叶相同的六步预算。
已更改
/isekai survey将radius(半径)的上限从 512 改为 128。 扫描算法复杂度为二次方,且在服务器线程的命令调用中运行:512 意味着在一个游戏刻内执行 1,050,625 个区块的放置测试以及针对每个候选项的生成检查。而 128 仅为 66,049 个区块;建议改用多次较小的运行。structure_spawn_overrides的作用域限定为结构本身,而非维度。 它写入的是结构自身的生成设置,因此设置了该选项的描述符也会改变其他维度中的同一结构。数据包的参考文档现在在作用域表中明确了这一点;其他覆盖键仍保持其维度级作用域。- 基于
isekai_api:生物群系源的下界或末地不再在实验性设置提示框后打开。 原版仅接受其内置的生物群系源和噪声设置,因此即使模组将其 Isekai 下界打包在其 jar 文件中,在世界创建及首次打开时仍会要求玩家确认“实验性设置”。Isekai API 现在会在保留原版维度类型键且使用minecraft:noise生成器时,将该维度报告为稳定状态;此时允许使用其自身的噪声设置。其他原因仍会触发提示:非 Isekai 源但拥有自定义噪声设置、替换了维度类型键、维度数量不为三,以及来自用户数据包的任何世界生成注册表条目(dimension_type、noise_settings、生物群系、特性)。
已知限制
- 生物群系属性是共享的。 当生物群系被共享时,气候(
temperature、downfall、降水)和效果(颜色、粒子、声音、音乐)无法因维度而异;请使用applies_to来限制描述符编辑哪些生物群系。 atmosphere.mob_spawn_costs保持全局生效,因为NaturalSpawner#createState没有层级上下文。creature_generation_probability被写入相同的共享生物群系中。- 切割器仅在
NoiseBasedChunkGenerator上按维度隔离。 如果维度使用其他生成器,或者使用了重写applyCarvers但未调用父类方法的NoiseBasedChunkGenerator子类,则会保留旧的按生物群系添加/移除行为(CarverScope.hookable)。 - 生物排除规则不会作用于未调用
finalizeSpawn而直接调用addFreshEntity的自定义生物。 添加和权重变更仅适用于读取生物群系生成列表的区域。 /reload不会更改世界生成规则。 NeoForge 仅在服务器启动时运行一次生物群系修改器,因此添加或删除规则需要重启服务器。- 声明过的生物群系在其他所有维度中会丢失其他模组的特性。 协调过程会移除原始持有者,因此一个未声明但复用了该生物群系的维度将不再获得该特性。
- 生成过程中的结构维度解析依赖于区块是否为
ChunkAccess。 如果实现仅传递LevelHeightAccessor,则该区块不在索引中,并回退到BiomeSource匹配,当两个维度共享同一个生物群系源时,这将导致歧义(ChunkDimensionIndex,DimensionResolver)。 /place structure不受exclusions.structures阻止,因为它跳过了生成点搜索。- 最终的特性否决仅覆盖
placeWithContext路径。 通过其他路径放置特性的生成器仍可能放置该特性;装饰过滤器是主要机制。
不破坏 Java API。 唯一的变更是添加了一个 default 方法,因此针对 1.x / 2.0.0 / 2.1.0 编写的 SurfaceAnchor 变体可以无需更改即可编译和运行。数据包架构未受影响;变化的是当一个列包含多个岩层时,矿石落在哪里。
已修复 — 数据包行为
isekai_api:column_relative现在会触及列中的每一个岩层,而不仅仅是最顶部的一个。 悬浮地形列可以容纳多个上下堆叠的岛屿,而默认锚点按构造方式均解析自其中最高的一个——world_surface读取高度图,world_floor则从该高度图找到的位置向下扫描。因此,上方有悬浮物的岛屿完全不会生成任何矿石。现在,每个岩层都会在同一归一化深度生成一个位置,这样岛屿的矿石生成就不再受其上方悬浮物的影响。在 Sky World 上的实测数据显示:安山岩、花岗岩、闪长岩、煤、铁和铜在下部岛屿带中均为 0,而在该区域中,29 个下部岛屿区块中有 29 个也携带了上部岛屿。- 对于厚度不足以容纳矿脉带的岩层,将单独跳过它,而不是终止整列,因此较薄的岛屿不再隐藏其下方的岛屿。
- 包含单个岩层的列所生成的内容与之前完全一致,Y 坐标相同,且从随机源抽取的数量也相同——无论该列最终包含多少个岩层,深度只抽取一次;如果某列最终不生成任何东西,则仍不生成任何东西。地形从未堆叠的世界生成结果保持一致。
已添加 — Java API
SurfaceAnchor.resolveYBelow(PlacementContext, BlockPos, int)—— 相对于天花板处或以下的列部分解析锚点,这是遍历机制能够访问第二个岩层及其下方岩层的方式。它是一个具有单次命中语义的default方法(当锚点自身 Y 位于或低于天花板时返回该 Y 值,否则返回无结果),因此未重写此方法的变体仍像以前一样每列仅报告一个岩层。world_surface和world_floor对其进行了重写;详见 docs/COMPATIBILITY.md。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
原版世界生成优化模组
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
评论 0
登录后参与评分
还没有评论,来抢沙发吧