Wiki and plugin tutorials -
Bug reports
Designing your own world generator for Bukkit is hard. Bukkit doesn't let you hook into the Minecraft terrain generator, so if you just want to change the shape of the terrain, you would need to rewrite almost the entirety of the Minecraft terrain generator. Alternatively, you can hook into Minecraft internals, but this is tricky and tends to break on every Minecraft update.
WorldGeneratorApi provides a clean API to design your own world generator, while still using components of Minecraft if you want. In just a few lines of code, we can create a complete plugin that generates flat worlds:
public class YourPlugin extends JavaPlugin {
public ChunkGenerator getDefaultWorldGenerator ( String worldName, String id ) {
return WorldGeneratorApi. getInstance ( this, 0, 6 ). createCustomGenerator (WorldRef. ofName (worldName ), generator -> {
// Code modifying the world generator goes here
generator. setBaseTerrainGenerator ( new BaseTerrainGenerator ( ) {
@Override
public int getHeight (BiomeGenerator biomeGenerator, int x, int z, HeightType type ) {
// Used by for example village generation to probe if the terrain is not too hilly
// If calculating the terrain height would be too complex, you can also extend a
// "BaseNoiseGenerator" instead of a "BaseChunkGenerator" - that class automatically
// calculates the terrain height based on the noise function you give it
return 70 ;
}
@Override
public void setBlocksInChunk (GeneratingChunk chunk ) {
chunk. getBlocksForChunk ( ). setRegion ( 0, 0, 0, CHUNK_SIZE, 70, CHUNK_SIZE, Material. STONE ) ;
}
} ) ;
} ) ;
}
}
![[IMG]](//proxy.spigotmc.org/5e3d74cd1b7441615706dbf08914bbeb4ddfa8e8?url=https%3A%2F%2Fcamo.githubusercontent.com%2F2a6ca74b3e3708fb9109d6389214f20206aad22e%2F68747470733a2f2f7275746765726b6f6b2e6e6c2f61666265656c64696e67656e2f6d696e6563726166742f776f726c6467656e657261746f726170692e6a7067)
As you can see, only the shape of the terrain is modified, the rest of the world generator is untouched. Want to disable flowers and grass? Add generator.getWorldDecorator().withoutDefaultDecorations(DecorationType.VEGETAL_DECORATION);. Don't like caves and ravines? Add generator.getWorldDecorator().withoutDefaultDecorations(DecorationType.CARVING_AIR);.
Features
Limitations
You'll only need this plugin if another plugin asks you to download it. To modify the terrain, you will need to download one of the plugins listed below at "Plugins using WorldGeneratorApi".
There's a command /worldgeneratorapi reload that you may find useful: it reloads the world generators of all worlds, applying any updated settings. This might save you quite a few server restarts. The permission node for the command is worldgeneratorapi.command. OPs have this permission node by default.
Plugins using WorldGeneratorApi
Dough World Generator
This is a little plugin designed to show the power of WorldGeneratorApi. It allows you to customize the shape of your terrain. It can import the settings from the old Customized world type.
![[IMG]](//proxy.spigotmc.org/43c7c1763f5626c5ce90cdc30b75f51a89c31af0?url=https%3A%2F%2Fraw.githubusercontent.com%2Frutgerkok%2FDough%2Fmaster%2F.github%2Fscreenshot.png)
More information - Install
Pancake World Generator
This is a tiny plugin that flattens your terrain, while leaving all other elements of world generation intact. So you will still have biomes, caves, structures, ores, trees, grass, etc.
![[IMG]](//proxy.spigotmc.org/f8727a9e6c4a00bd8e3623f978c1fcb9a7e8036c?url=https%3A%2F%2Fraw.githubusercontent.com%2Frutgerkok%2FPancakeWorldGenerator%2Fmaster%2F.github%2Fscreenshot.png)
More information - Install
Bento's Boxed
Start in a tiny box, which expands as you gain achievements. Uses WorldGeneratorApi for custom terrain height and biome placement.
More information
Made a plugin? Please tell me, I will add it here!
Designing your own world generator for Bukkit is hard. Bukkit doesn't let you hook into the Minecraft terrain generator, so if you just want to change the shape of the terrain, you would need to rewrite almost the entirety of the Minecraft terrain generator. Alternatively, you can hook into Minecraft internals, but this is tricky and tends to break on every Minecraft update.
WorldGeneratorApi provides a clean API to design your own world generator, while still using components of Minecraft if you want. In just a few lines of code, we can create a complete plugin that generates flat worlds:
Code (Java):
public class YourPlugin extends JavaPlugin {
public ChunkGenerator getDefaultWorldGenerator ( String worldName, String id ) {
return WorldGeneratorApi. getInstance ( this, 0, 6 ). createCustomGenerator (WorldRef. ofName (worldName ), generator -> {
// Code modifying the world generator goes here
generator. setBaseTerrainGenerator ( new BaseTerrainGenerator ( ) {
@Override
public int getHeight (BiomeGenerator biomeGenerator, int x, int z, HeightType type ) {
// Used by for example village generation to probe if the terrain is not too hilly
// If calculating the terrain height would be too complex, you can also extend a
// "BaseNoiseGenerator" instead of a "BaseChunkGenerator" - that class automatically
// calculates the terrain height based on the noise function you give it
return 70 ;
}
@Override
public void setBlocksInChunk (GeneratingChunk chunk ) {
chunk. getBlocksForChunk ( ). setRegion ( 0, 0, 0, CHUNK_SIZE, 70, CHUNK_SIZE, Material. STONE ) ;
}
} ) ;
} ) ;
}
}
As you can see, only the shape of the terrain is modified, the rest of the world generator is untouched. Want to disable flowers and grass? Add generator.getWorldDecorator().withoutDefaultDecorations(DecorationType.VEGETAL_DECORATION);. Don't like caves and ravines? Add generator.getWorldDecorator().withoutDefaultDecorations(DecorationType.CARVING_AIR);.
Features
- Control the base shape of the terrain.
- Control the locations of biomes.
- Disable vanilla resources (caves, flowers, villages, etc.)
- Add custom resources
- Supports the async chunk generator of Spigot and Paper
Limitations
- There is no way to add custom biomes yet.
- There is no way to spawn entities yet.
You'll only need this plugin if another plugin asks you to download it. To modify the terrain, you will need to download one of the plugins listed below at "Plugins using WorldGeneratorApi".
There's a command /worldgeneratorapi reload that you may find useful: it reloads the world generators of all worlds, applying any updated settings. This might save you quite a few server restarts. The permission node for the command is worldgeneratorapi.command. OPs have this permission node by default.
Plugins using WorldGeneratorApi
Dough World Generator
This is a little plugin designed to show the power of WorldGeneratorApi. It allows you to customize the shape of your terrain. It can import the settings from the old Customized world type.
![[IMG]](http://proxy.spigotmc.org/43c7c1763f5626c5ce90cdc30b75f51a89c31af0?url=https%3A%2F%2Fraw.githubusercontent.com%2Frutgerkok%2FDough%2Fmaster%2F.github%2Fscreenshot.png)
More information - Install
Pancake World Generator
This is a tiny plugin that flattens your terrain, while leaving all other elements of world generation intact. So you will still have biomes, caves, structures, ores, trees, grass, etc.
![[IMG]](http://proxy.spigotmc.org/f8727a9e6c4a00bd8e3623f978c1fcb9a7e8036c?url=https%3A%2F%2Fraw.githubusercontent.com%2Frutgerkok%2FPancakeWorldGenerator%2Fmaster%2F.github%2Fscreenshot.png)
More information - Install
Bento's Boxed
Start in a tiny box, which expands as you gain achievements. Uses WorldGeneratorApi for custom terrain height and biome placement.
More information
Made a plugin? Please tell me, I will add it here!
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.17
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
WorldGeneratorApi is a free Minecraft Java mod. Compatible with Minecraft 1.17. Downloaded 2,477 times (via Spigot). Download it and open it directly in the game.