Skip to content
Conduit

Void world helper

VoidWorldHelper builds a ChunkGenerator that produces an empty void world — void biome, no flat layers, no terrain. Use it for instance dimensions you’ll populate from a prefab, hub-style dimensions where every block is barrier, or any custom dimension where you don’t want vanilla generation poking through.

When to use it

Section titled “When to use it”
  • You’re building a custom instance dimension and want a clean slate.
  • You’re rolling your own hub dimension and only need a void backdrop.
  • You’re writing a test world with explicit, hand-placed geometry.

API

Section titled “API”
package me.zlex.conduit.dimension;


public final class VoidWorldHelper {
    public static ChunkGenerator createVoidGenerator(HolderGetter<Biome> biomes);
}

The generator is a FlatLevelSource with THE_VOID biome and an empty layer list. It’s the same generator the engine’s InstanceManager uses for WorldTemplate.VOID.

Example

Section titled “Example”
import me.zlex.conduit.dimension.VoidWorldHelper;
import net.minecraft.core.HolderGetter;
import net.minecraft.core.registries.Registries;
import net.minecraft.server.MinecraftServer;
import net.minecraft.world.level.biome.Biome;
import net.minecraft.world.level.chunk.ChunkGenerator;


public final class CustomVoidDimension {


    public static ChunkGenerator generatorFor(MinecraftServer server) {
        HolderGetter<Biome> biomes = server.registryAccess()
                .lookupOrThrow(Registries.BIOME);
        return VoidWorldHelper.createVoidGenerator(biomes);
    }
}

Notes

Section titled “Notes”
  • The void biome has zero ambient light at sky-level — set a fixed-time game rule (gamerule doDaylightCycle false; time set day) if your dimension uses overworld dimension type and you want it bright.
  • The dimension type and LevelStem wiring are separate concerns — this helper only builds the chunk generator.
  • For instance dimensions, prefer InstanceManager.acquire(server, WorldTemplate.VOID) — that path uses this helper under the hood and handles dimension registration for you.
Section titled “Related”