Isekai API

模组

· 作者 KURONAMI

通过数据包构建任意世界——一套用于形状、生物群系、维度以及重新放置现有内容的中性世界生成原语工具箱。无需 Java 编程。

0 本站下载 0 关注 更新于 2 天前

最新 3.0.0+neoforge-1.21.1 · 1.21.1 · NeoForge

一键开服(送7天)

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

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源