异世界 API

Isekai API 是一个用于塑造和定义《我的世界》世界 形态与规则 的工具箱——它不是世界本身，而是创造世界的机器。 就像网页中的 div/span 一样，它提供了一小组中立、可组合的基元，你可以通过数据包 JSON 将它们组合起来，构建出你能想象到的任何世界。它本身不附带任何生物群系、结构或主题。

你可以控制什么

世界生成的每一个维度，都以可组合基元的形式呈现：

• 地形形态 — 16 种数学/几何密度基元 + 4 种世界形状合成器（squeeze、y_envelope、blended_noise、band_density）。浮空岛、悬挂或倒置的大陆、中空球壳、平顶山、镜像/平铺空间——任何 Y 轴区间上的任何三维形态。
• 生物群系放置 — isekai_api:rule 生物群系源通过纯空间规则放置生物群系：垂直分层、同心圆环、区域，以及 and/or/not 组合（如 y_below 20 -> deep_dark）。无需调整气候噪声。
• 地表与填充 — 通过 JSON 重新定义任何生物群系的地表方块或石头填充。
• 新维度 — 将上述功能与原版维度 JSON 结合，即可发布一个全新的维度。无需 Java 代码，无需修改原版文件。
• 大气环境 — 为每个世界设置独特的天空、雾和水体颜色。
• 场景装置、结构与树木 — 从可组合的部件中构建中立内容：仅在平坦干燥的地面上放置手工制作的 NBT 场景装置（grounded_template），生成相连的方块簇和流体池，并使用任意树干 + 树叶放置器组装出不会腐烂的树木。不预设任何主题——方块由你提供。
• 放置控制 — 精确决定特征/结构的生成位置：相对于地表或流体、根据方块上下文、Y 轴范围、坡度、与某方块或生物群系的接近程度，以及逻辑组合。
• 重新放置现有内容 — 获取任何原版或模组的矿石、结构、生物或特征，并将其重新分布到你的新世界形态中。原版深层埋藏的稀有矿石可以重新映射到你浮空岛的底部。策略包括：线性、倒置、固定范围、数量缩放、波段分割、流水线——还支持排除/添加。
• 启动时验证 — 无效或拼写错误的注册表引用会在服务器启动时被发现，避免静默失效。
• Java API — Isekai.query() 读取原版/模组的生成规则；Isekai.remap() 以代码形式声明世界形状。

为二次开发而生

Isekai 不与某一个特定世界或作者绑定。无论你想如何使用它，都欢迎——数据包世界形状、完整的 Java 模组、整合包粘合、快速实验、彻底改造。MIT 许可证：可自由使用、分叉，并打包进整合包。

• 数据包作者： 数据包参考列出了每个键及其 JSON 结构；从 examples/（sky_archipelago、flipped、moon_world）复制一个可运行的骨架。
• Java 模组开发者： 将 isekai_api 作为 compileOnly 依赖添加，并使用 Isekai 门面。 api 包之外的一切都是内部实现，因此公共接口保持小巧且稳定。
• 问题、想法、错误： 开启一个 issue。用 Isekai 构建了世界？分享出来——我很期待大家的作品。

MIT · 源码与文档。 与“Isekai Adventure”整合包无关。