WorldGeneratorApi 1.3 (for Minecraft 1.17)

Since Bukkit now has a new world generator API, a large part of this API is now obsolete. That part has been marked as deprecated. For now, it should still work, but I'm not planning to upgrade that part to Minecraft 1.18.

Migration

First, read up on the new API over here. Next, migrate your algorithms to use the new API. Chances are you will no longer need WorldGeneratorApi.

If you use a noise generator for chunks, or if you extend the vanilla biome generator, you'll still need WorldGeneratorApi. The new methods below will be of interest for you.

Changelog

• Deprecated most of the API, as it's superseded by the new Bukkit API. Will be removed in Minecraft 1.18.
• Added a message when a plugin is built against an older version of WorldGeneratorApi, because those plugins will become incompatible with Minecraft 1.18.
• Updated for a tile entity change in Spigot.
• Added WorldGeneratorApi.createBasePopulatorFromNoiseFunction(BaseNoiseProvider)
• Added WorldGeneratorApi.setBiomeProvider(World, BiomeProvider)
• Added WorldGeneratorApi.getBiomeProvider(WorldInfo)

This should make sure that all plugins that relied on WorldGeneratorApi can be ported. If you're still missing something, let me know.

WorldGeneratorApi 1.2.2 (for Minecraft 1.17)

Bukkit introduced a new world generator API. This is great news, as most world generator plugins will no longer need to use NMS or this API. This is just a quick update to make sure that this API still works with the latest Spigot builds. In the future, this API will need a redesign so that all overlapping functionality is removed from this API.

• Updated to be compatible with latest Spigot builds, with the new world generator.
• Fix missed function update in ChunkData.setBlock. (By @SuperSpyTX )
• If changing the NoiseGeneratorSettings fails, a more descriptive error message is now printed.

WorldGeneratorApi 1.2.1 (for Minecraft 1.17)

• Fixed passive land mobs and mobs specific to structures not spawning.
• Fixed an error when TerrainSettings.stoneBlock or TerrainSettings.waterBlock were null.

WorldGeneratorApi 1.2.0 (for Minecraft 1.17)

• Updated to Minecraft 1.17.
• Added getHighestBlockYAt(x, z) to DecorationArea.
• Added spawnEntity(entityClass, x, y, z) to DecorationArea.

Note: worlds with extended height are currently untested. They'll likely work, but maybe trying to modify the base shape of the terrain will produce an error. Please let me know if that's the case.

WorldGeneratorApi 1.1.4 (for Minecraft 1.16.5)

• Updated to Minecraft 1.16.5. (Spigot renamed a field in the biome generator.)

WorldGeneratorApi 1.1.3 (for Minecraft 1.16.4)

• Fixed world generator injections not being performed when an org.bukkit.generator.ChunkGenerator is assigned to another world. Fixes //regen in WorldEdit.

WorldGeneratorApi 1.1.2 (for Minecraft 1.16.4)

• Updated to Minecraft 1.16.4. No longer compatible with Minecraft 1.16.3 or older.
• Fix NoiseToTerrainGenerator not respecting a change of BiomeGenerator.
• Fix incorrect generator settings being used for Nether and End dimensions. Thanks @ChimneySwift!

WorldGeneratorApi 1.1.1 (for Minecraft 1.16.2-1.16.3)

• Fix decorations being spawned multiple times.
• Fix biome returning as null in DecorationArea.

WorldGeneratorApi 1.1 (for Minecraft 1.16.2)

• Updated to Minecraft 1.16.2. No longer compatible with 1.16.1 or older.
• Fixed a crash when Minecraft attempts to save settings of a custom biome generator.
• Fixed initial spawn chunks not being affected when modifying the world generator using the WorldGeneratorInitEvent.

WorldGeneratorApi 1.0.1 (for Minecraft 1.16)

• Fixed setBiomeGenerator throwing an exception.