<\/p>\n
\n
BiomesAPI<\/h1>\n
Custom Biomes for Paper servers without datapacks.<\/p>\n
![](\"https:\/\/img.shields.io\/github\/last-commit\/LumaLibre\/BiomesAPI\")
\n ![](\"https:\/\/img.shields.io\/github\/contributors\/LumaLibre\/BiomesAPI\")
\n ![](\"https:\/\/img.shields.io\/github\/forks\/LumaLibre\/BiomesAPI\")
\n<\/div>\n
—<\/p>\n
## Docs \ud83d\udcda<\/p>\n
Documentation for BiomesAPI can be found at https:\/\/biomes.lumas.dev.
\nDocumentation is still under construction!<\/p>\n
## About \ud83d\udcc3<\/p>\n
BiomesAPI is a custom biome API for PaperMC Servers. This API is a fork of Outspending’s original BiomesAPI and
\nhas been updated to support the **modern** Minecraft versions. Currently, we support Minecraft **1.21.11**
\nbut version support will expand with time.<\/p>\n
Please be aware that BiomesAPI is in active development, and some features may not be fully implemented yet.
\nBiomesAPI was made for servers who are looking for more of an aesthetic feel to their builds.<\/p>\n
## Getting Started \u2b50<\/p>\n
BiomesAPI is built using Gradle and is hosted on my repository (repo.jsinco.dev). To get started with BiomesAPI,
\nfollow the instructions below to add BiomesAPI to your project.<\/p>\n
1. Find the latest version of BiomesAPI HERE. Versions with a git commit hash at the end are snapshot builds and may be unstable.
\n2. Add the repository to your `build.gradle.kts`, `build.gradle`, or `pom.xml` file.<\/p>\n
And example for Gradle Kotlin DSL is provided below:<\/p>\n
“`kotlin
\nplugins {
\n \/\/ Make sure to shade it in if you’re not using it as an external dependency!
\n id(“com.gradleup.shadow”) version “$SHADOW_VERSION”
\n}<\/p>\n
repositories {
\n maven(“https:\/\/repo.jsinco.dev\/releases”)
\n}<\/p>\n
\/\/ 3. Replace VERSION with the latest version found in step 1
\ndependencies {
\n implementation(“me.outspending.biomesapi:BiomesAPI:$VERSION”)
\n}<\/p>\n
\/\/ 4. Shade the BiomesAPI package to avoid conflicts
\nshadowJar {
\n relocate(“me.outspending.biomesapi”, “your.package.name.biomesapi”)
\n}
\n“`<\/p>\n
BiomesAPI comes as a shaded dependency or a standalone plugin, take your pick!<\/p>\n
## Wiki \ud83c\udf19
\nOur Wiki is a great place to learn how to use BiomesAPI. This Wiki is updated frequently to make sure our users know how to use our API.<\/p>\n
The wiki has everything from how to create a biome to how to use our API to its full potential. It’s also pretty descriptive, so you’ll know exactly what you’re doing.<\/p>\n
Check out the Wiki at https:\/\/biomes.lumas.dev<\/p>\n
## Why BiomesAPI \ud83e\udd14<\/p>\n
I believe that BiomesAPI is one of the best ways to create custom biomes on a Paper-based Minecraft server.
\nAt the time of writing, there are no other APIs that allow you to create custom biomes as easily as BiomesAPI does.<\/p>\n
BiomesAPI is designed to be easy to use, flexible, and friendly for developers of all skill levels.<\/p>\n
## Features \ud83d\udc4c<\/p>\n
– Easy to use
\n– Updated frequently
\n– Free forever
\n– Wiki and javadocs available
\n– Supports modern Minecraft versions
\n– Supports packet-based biome changing with ProtocolLib or PacketEvents<\/p>\n
## Credits \ud83d\ude4f
\nBiomesAPI was originally created by Outspending. I (Jsinco) have forked the project to add additional features and
\nsupport modern Minecraft versions. This project would not be possible without Outspending’s original work.<\/p>\n
## Contributing \ud83d\udcf0<\/p>\n
Contributions are welcome! If you find a bug or have a feature request, please open an issue on GitHub.<\/p>\n
## License \ud83e\udeaa
\nBiomesAPI is licensed under the [GPL-3.0 License](LICENSE)<\/p>\n","protected":false},"excerpt":{"rendered":"
BiomesAPI is a custom biome API for Paper servers without the use of datapacks.<\/p>\n","protected":false},"featured_media":31314,"template":"","meta":{"_minecraft_slug":"biomesapi","_minecraft_project_id":"S9oBXgoU","_minecraft_author":"Jsinco","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":12,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"biomesapi.zip","_minecraft_size_bytes":13900371,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T22:59:28.083297Z","_minecraft_date_created":"2026-05-11T01:14:36.076382Z","_minecraft_date_modified":"2026-05-12T23:31:09.547631Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/biomesapi","_minecraft_icon_attachment_id":31314,"_minecraft_imported_at":"2026-06-01T13:44:41+00:00","_minecraft_import_hash":"13ed47e0a8993a6dd414b5dfbff5397f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,127,128],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-31313","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-paper","mod_category-purpur","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
BiomesAPI - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/biomesapi\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"BiomesAPI - Minecraft\" \/>\n<meta property=\"og:description\" content=\"BiomesAPI is a custom biome API for Paper servers without the use of datapacks.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/biomesapi\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta property=\"og:image\" content=\"https:\/\/img.shields.io\/github\/last-commit\/LumaLibre\/BiomesAPI\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomesapi\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomesapi\\\/\",\"name\":\"BiomesAPI - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomesapi\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomesapi\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/biomesapi-icon-f29de94e9fbeb10ecce8917de1647100509ed60e_96.webp\",\"datePublished\":\"2026-06-01T13:44:40+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomesapi\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomesapi\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomesapi\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/biomesapi-icon-f29de94e9fbeb10ecce8917de1647100509ed60e_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/biomesapi-icon-f29de94e9fbeb10ecce8917de1647100509ed60e_96.webp\",\"width\":94,\"height\":26},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/biomesapi\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"BiomesAPI\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"BiomesAPI - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/biomesapi\/","og_locale":"en_US","og_type":"article","og_title":"BiomesAPI - Minecraft","og_description":"BiomesAPI is a custom biome API for Paper servers without the use of datapacks.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/biomesapi\/","og_site_name":"Minecraft","og_image":[{"url":"https:\/\/img.shields.io\/github\/last-commit\/LumaLibre\/BiomesAPI","type":"","width":"","height":""}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/biomesapi\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/biomesapi\/","name":"BiomesAPI - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/biomesapi\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/biomesapi\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/biomesapi-icon-f29de94e9fbeb10ecce8917de1647100509ed60e_96.webp","datePublished":"2026-06-01T13:44:40+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/biomesapi\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/biomesapi\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/biomesapi\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/biomesapi-icon-f29de94e9fbeb10ecce8917de1647100509ed60e_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/biomesapi-icon-f29de94e9fbeb10ecce8917de1647100509ed60e_96.webp","width":94,"height":26},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/biomesapi\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"BiomesAPI"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/31313","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/31314"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=31313"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=31313"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=31313"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=31313"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}