Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time


Build Status Download at Dev Builds at Latest release Commits since latest release

Nowadays, you have many options to edit how your world generates. Bukkit got a hugely expanded world generation API in 2021, and data packs are able to take control over almost any aspect of world generation. But, how would you generate a map like this?

Example biome map

The answer: first, install a data pack that increases ocean size, then install WorldGeneratorApi, then run /worldgeneratorapi biomemap.

WorldGeneratorApi is a modest API, adding some functionality for world generation. It used to be bigger, but most code has been dropped in favor of the new methods in the Bukkit API.

  • Ability to create biome maps of your world
  • Ability to modify the vanilla biome generator using code
  • Ability to view (and use) noise values for your terrain - temperature, humidity, weirdness, continentalness, erosion, factor, offset and jaggedness.

Please head to the wiki to learn more.


License is MIT, so you can freely use this API, even in premium plugins. Just put up a note that you're using WorldGeneratorApi.


We use Maven. Maven can be a bit tricky to install (you need to modify the environment variables of your computer), but once you have managed to do that, just run:

mvn install

You'll end up with a file ./target/WorldGeneratorApi-1.0.jar (version number will be different of course), which is a ready-to-use plugin. There's also the file ./worldgeneratorapi/target/worldgeneratorapi-1.0.jar, which is just the API. This file can be used by plugin developers to code against: it will not run on the server, as it is missing the implementation.

Bug reports, feature requests and pull requests

Contributions are always welcome! Just open an issue or pull request.