ModsFinder

Isekai API

by KURONAMI

Isekai API is a NeoForge library for building custom worlds with datapack JSON, without writing Java for the world itself.

NeoForgeClient and serverMIT LicenseOpen source1.21.1

What it does

The library provides a set of neutral, composable worldgen primitives. Authors combine them in datapack JSON to shape biomes, define new dimensions and control where features and structures are placed, in the way small elements combine on a web page. A new dimension can reuse the vanilla dimension JSON format and ship as a complete world.

Where a feature or structure lands can be controlled through conditions such as the surface it sits on, nearby fluids or blocks, the height band, the terrain slope, the biome and boolean logic combining them. Atmosphere settings such as sky, fog and water colors are set per world. A reference preset, isekai api:hooked, overrides the overworld with one small terrain-shape hook, which replaces the large vanilla noise settings file with a short change. Java is required to run the library, but the worlds built on it need zero Java and zero vanilla edits.

Isekai API is open source under the MIT License, so it can be used, forked and bundled into modpacks freely. Source code and the issue tracker are public. It runs on client and server, so both need it. Four catalog mods, including Sky World, Mountain World, Tropical World and Tundra World, require it, and files exist for 1.21.1 only.

Key features

  1. Composable worldgen primitives

    Neutral building blocks for shapes, biomes and dimensions can be combined in datapack JSON to build a world.

  2. Placement control

    Features and structures can be placed by surface, fluid, block context, Y range, slope, proximity or biome.

  3. Per-world atmosphere

    Sky, fog and water colors can be set separately for each world built on the library.

  4. Boot-time validation

    Broken or mistyped registry references are reported at server start instead of silently doing nothing.

  5. Runnable examples and reference

    A datapack reference lists each key with its JSON shape, and a runnable floating island example can be copied as a starting point.

Compatibility

Latest build for each game version and loader.

1.21.12.2.0+neoforge-1.21.1
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Required by 4 mods

Use cases

Who it’s for: Datapack authors and modpack builders who want custom worlds, terrain shapes or dimensions for NeoForge 1.21.1 without writing a full Java mod.

Questions

Does Sky World need Isekai API installed?

Yes. Sky World is one of the four catalog mods that require Isekai API, so the library must be installed alongside it.

Is Java needed to use Isekai API?

Java is required to run the library, but worlds built with it need zero Java and zero vanilla edits.

Which NeoForge version does Isekai API support?

Its latest NeoForge file, 2.2.0+neoforge-1.21.1, is for 1.21.1 only, and was published on 2026-09-04.

In the catalog

Isekai API is one of 3,514 Library mods on ModsFinder, and one of 1,449 Library mods for NeoForge. 32,366 mods support Minecraft 1.21.1.

More from KURONAMI

All projects

Similar mods

What the author says

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…
KURONAMI, on the Modrinth page

Official listing

Owner
KURONAMI
Published
2026-05-29
Updated on Modrinth
2026-09-04
Facts verified
2026-10-15

Tags