Terra is a modern world generation modding platform that allows complete customization of world generation with an advanced API, tightly integrated with a powerful configuration system.
Terra provides a set of core addons which implement a "standard" config schema, as well as a default overworld config pack.
To install Terra, visit the Getting Started page on our wiki, and choose the installation guide for your platform. Remember to choose the correct version of Terra for your Minecraft version! (see the versions wiki page).
Terra's platform-agnostic design ensures all world generation happens completely independently of Minecraft, allowing Terra to be easily portable across platforms.
Currently, Terra supports:
* Fabric - Download on Modrinth.
* Forge - Download on Modrinth.
* Quilt - Download on Modrinth.
* Bukkit (Paper servers) - Download on SpigotMC
Terra provides world generation through configuration packs. Various config packs made by the Terra community are accessible at the Community Packs page. Below is a showcase of the community packs available through the linked page:
Overworld (Pre-installed)
Origen
Hydraxia
SkyLands
Tartarus
ReimagEND
Substratum
Overworld 2 (WIP - In development)
Terra is currently in BETA. While Terra is stable and production-ready, and the default Overworld Config provides all Vanilla resources, Terra is not feature-complete. There is a lot to be added!
If you like Terra, please consider donating ~~so I can buy more Dr. Pepper~~:
You can also support us for free by starring our repository on GitHub! GitHub rolls out new beta features first to repositories with more stars, so starring our repo is a great way to support us!
Thanks to Ember Host for sponsoring Terra! You can support us by clicking the banner bellow to get 10% off your first month, which also gives us a 50% cut of your first purchase!

Unsupported
Required
Terms for using, modifying and redistributing this product.
03.10.2025 · Modrinth
This version introduces many new features including:
Screenshots and images from the original Modrinth page.

Published versions and original Modrinth files.
03.10.2025 · 34 867 downloads
This version introduces many new features including:
03.10.2025 · 6 482 downloads
This version introduces many new features including:
19.06.2025 · 11 065 downloads
This version fixes a bug when starting a server without Multiverse installed.
18.06.2025 · 2 567 downloads
This version introduces many new features including:
Overworld changes:
18.06.2025 · 379 downloads
This version introduces many new features including:
Overworld changes:
08.06.2025 · 3 634 downloads
This is a bug fix release with following fixes including:
08.06.2025 · 4 388 downloads
This is a bug fix release with following fixes including:
06.06.2025 · 1 890 downloads
This version introduces many new features including:
Overworld changes:
05.06.2025 · 431 downloads
This version introduces many new features including:
Overworld changes:
02.03.2025 · 22 189 downloads
Fixes a crash with custom portals.
01.03.2025 · 564 downloads
This version introduces many new features including:
Config pack development changes:
FBM and the basic ArithmeticSampler samplers now implement the DerivativeNoiseSampler APIsalt-lookup parameter LINEAR_MAP normalizer Paralithic changes:
* Adds support for Paralithic let expressions. Let expressions enable the ability to bind names to expressions within the context of another expression, e.g.
5 + let
a := 3.5,
b := a^2, // Optional trailing comma
in a * b * (let d := sqrt(x) in cos(d))
in invocation variable reserved as a keyword in let expressions), this must explicitly be enabled in pack.yml via the following:expressions:
options:
enable-let-expressions: trueinput instead of in if let expressions are enabled, which currently affects only the EXPRESSION_NORMALIZER sampler01.03.2025 · 8 058 downloads
This version introduces many new features including:
Config pack development changes:
FBM and the basic ArithmeticSampler samplers now implement the DerivativeNoiseSampler APIsalt-lookup parameter LINEAR_MAP normalizer Paralithic changes:
* Adds support for Paralithic let expressions. Let expressions enable the ability to bind names to expressions within the context of another expression, e.g.
5 + let
a := 3.5,
b := a^2, // Optional trailing comma
in a * b * (let d := sqrt(x) in cos(d))
in invocation variable reserved as a keyword in let expressions), this must explicitly be enabled in pack.yml via the following:expressions:
options:
enable-let-expressions: trueinput instead of in if let expressions are enabled, which currently affects only the EXPRESSION_NORMALIZER sampler13.10.2024 · 21 085 downloads
This version fixes a bug when using a jar not built with Mojang mappings.
25.09.2024 · 3 627 downloads
This version introduces many new features including:
Config pack development changes:
blend.sampler and blend.amplitude feature generation parametersPESUDOEROSION sampler added via the config-noise-function addonDerivativeNoiseSampler API currently implemented by OPEN_SIMPLEX_2' and 'OPEN_SIMPLEX_2SSalted sampler functions which accept an additional integer argument that adds salt to the samplerslant.disable-palettes parameter25.09.2024 · 22 664 downloads
This version introduces many new features including:
Config pack development changes:
blend.sampler and blend.amplitude feature generation parametersPESUDOEROSION sampler added via the config-noise-function addonDerivativeNoiseSampler API currently implemented by OPEN_SIMPLEX_2' and 'OPEN_SIMPLEX_2SSalted sampler functions which accept an additional integer argument that adds salt to the samplerslant.disable-palettes parameter18.09.2024 · 1 056 downloads
This version adds support for 1.20.6 and requires Java 21 to use. This version also introduces some new minor additions and bug fixes. See https://github.com/PolyhedralDev/Terra/pull/467 for more details.
24.12.2023 · 43 274 downloads
This minor version fixes a critical terrain generation issue involving linear interpolation in fractal samplers. All users of 6.4 versions should update IMMEDIATELY.
24.12.2023 · 36 442 downloads
This minor version fixes a critical terrain generation issue involving linear interpolation in fractal samplers. All users of 6.4 versions should update IMMEDIATELY.
18.12.2023 · 1 305 downloads
This version brings our minimum supported Minecraft version to 1.20.4 for both Fabric, and Bukkit (Paper+).
With this version config developers should update their config packs translating minecraft:grass to minecraft:short_grassand updating entity ids from ZOMBIE to minecraft:zombie, for example.
18.12.2023 · 511 downloads
This version brings our minimum supported Minecraft version to 1.20.4 for both Fabric, and Bukkit (Paper+).
With this version config developers should update their config packs translating minecraft:grass to minecraft:short_grass and updating entity ids from ZOMBIE to minecraft:zombie, for example.
25.11.2023 · 3 830 downloads
This version fixes a bug introduced in the previous version where ore blocks exposed to air were not generating properly. This bug fix does not apply retroactively to chunks that already have been generated with 6.4.0!
25.11.2023 · 6 532 downloads
This version fixes a bug introduced in the previous version where ore blocks exposed to air were not generating properly. This bug fix does not apply retroactively to chunks that already have been generated with 6.4.0!
14.11.2023 · 1 477 downloads
This version introduces many new features including:
Config pack development changes:
SCATTERED_ORE config type added via the config-ore addonrsqrt functionblock function that determines if the block should use physics (Such as setting water to flow on generation)DISTANCE - Provides the distance from a configured positionTRANSLATE - Allows translating sampler coordinate inputsEXPRESSION_NORMALIZER - Allows modifying the output of a sampler using an expressionLocalNoiseLookup CELLULAR sampler return type - Uses coordinates relative to closest cell origin for noise lookuppack.yml to reduce memory usage once images are no longer needed:images.cache.load-on-use: true - Only load images into memory upon first useimages.cache.timeout: SECONDS - Delay to unload an image after last use14.11.2023 · 1 088 downloads
This version introduces many new features including:
Config pack development changes:
SCATTERED_ORE config type added via the config-ore addonrsqrt functionblock function that determines if the block should use physics (Such as setting water to flow on generation)DISTANCE - Provides the distance from a configured positionTRANSLATE - Allows translating sampler coordinate inputsEXPRESSION_NORMALIZER - Allows modifying the output of a sampler using an expressionLocalNoiseLookup CELLULAR sampler return type - Uses coordinates relative to closest cell origin for noise lookuppack.yml to reduce memory usage once images are no longer needed:images.cache.load-on-use: true - Only load images into memory upon first useimages.cache.timeout: SECONDS - Delay to unload an image after last use14.07.2023 · 111 394 downloads
Added 1.20.1 support, includes the default Overworld 1.3.3 config featuring updated sakura mountains.
14.07.2023 · 21 011 downloads
Added 1.20.1 support, includes the default Overworld 1.3.3 config featuring updated sakura mountains.
20.06.2023 · 566 downloads
This version introduces an overhaul for image handling via the library-image addon. Notable new capabilities include:
You can find the documentation for this new addon here: https://terra.polydev.org/config/documentation/image/index.html
In addition are the following changes:
20.06.2023 · 1 762 downloads
This version introduces an overhaul for image handling via the library-image addon. Notable new capabilities include:
You can find the documentation for this new addon here: https://terra.polydev.org/config/documentation/image/index.html
In addition are the following changes:
20.06.2023 · 2 332 downloads
This version introduces an overhaul for image handling via the library-image addon. Notable new capabilities include:
You can find the documentation for this new addon here: https://terra.polydev.org/config/documentation/image/index.html
In addition are the following changes:
22.12.2022 · 11 256 downloads
This is an EXPERIMENTAL 1.19.3 development snapshot for Bukkit. It should not be used in production.
1.19.3 required a lot of internal changes to how Terra interfaces with Minecraft. This release is intended to test those changes before a full beta release.
22.12.2022 · 4 370 downloads
This is an EXPERIMENTAL 1.19.3 development snapshot for Fabric. It should not be used in production.
1.19.3 required a lot of internal changes to how Terra interfaces with Minecraft. This release is intended to test those changes before a full beta release.
16.11.2022 · 3 257 downloads
16.11.2022 · 14 321 downloads
16.11.2022 · 19 046 downloads
16.11.2022 · 6 257 downloads
Bukkit-specific fixes:
* Fix beardification on Bukkit
* Fix Bukkit misnaming end crystals
10.11.2022 · 7 084 downloads
10.11.2022 · 871 downloads
14.08.2022 · 878 downloads
This version adds full support for 3D biomes in the following addons:
* 3D Noise Chunk Generator (3D biomes are sampled for noise)
* Feature Generation Stage (Feature generator uses ranges in biome columns to place features)
A number of optimisations regarding 3D biomes were added:
* Addition of "biome columns" to avoid repeating expensive 3D computations
* Optional override for a BiomeProvider implementation to return a "base biome" used in biome columns
* More advanced biome caching
* Finer control over biome caches
Several other general-purpose optimisations were added:
* TerraScript backend was rewritten to store LVs in an array-based table with reference and store nodes containing table indices, rather than storing in an ID-based hashmap
* 3D Noise Chunk Generator was optimised to avoid biome lookups when possible
* Adjacent palette locators no longer instantiate 4 extra Column instances
* Iteration over Range using foreach was replaced with index-based iteration in hot code.
This version also adds a new core addon, the Biome Extrusion Provider.
The Extrusion Provider takes another biome provider as a parameter, which it uses as a "base." Through "extrusion" layers, 3D biomes are inserted on top of the base biomes.
This release also fixes a Minecraft bug where bee entities access the world random instance upon instantiation, which during worldgen can potentially cause an exception due to a race condition (Fixes #327)
08.07.2022 · 895 downloads
The Forge implementation is in ALPHA
This version adds full support for 3D biomes in the following addons:
* 3D Noise Chunk Generator (3D biomes are sampled for noise)
* Feature Generation Stage (Feature generator uses ranges in biome columns to place features)
A number of optimisations regarding 3D biomes were added:
* Addition of "biome columns" to avoid repeating expensive 3D computations
* Optional override for a BiomeProvider implementation to return a "base biome" used in biome columns
* More advanced biome caching
* Finer control over biome caches
Several other general-purpose optimisations were added:
* TerraScript backend was rewritten to store LVs in an array-based table with reference and store nodes containing table indices, rather than storing in an ID-based hashmap
* 3D Noise Chunk Generator was optimised to avoid biome lookups when possible
* Adjacent palette locators no longer instantiate 4 extra Column instances
* Iteration over Range using foreach was replaced with index-based iteration in hot code.
This version also adds a new core addon, the Biome Extrusion Provider.
The Extrusion Provider takes another biome provider as a parameter, which it uses as a "base." Through "extrusion" layers, 3D biomes are inserted on top of the base biomes.
This release also fixes a Minecraft bug where bee entities access the world random instance upon instantiation, which during worldgen can potentially cause an exception due to a race condition (Fixes #327)
08.07.2022 · 426 downloads
The Quilt implementation is in ALPHA
This version adds full support for 3D biomes in the following addons:
* 3D Noise Chunk Generator (3D biomes are sampled for noise)
* Feature Generation Stage (Feature generator uses ranges in biome columns to place features)
A number of optimisations regarding 3D biomes were added:
* Addition of "biome columns" to avoid repeating expensive 3D computations
* Optional override for a BiomeProvider implementation to return a "base biome" used in biome columns
* More advanced biome caching
* Finer control over biome caches
Several other general-purpose optimisations were added:
* TerraScript backend was rewritten to store LVs in an array-based table with reference and store nodes containing table indices, rather than storing in an ID-based hashmap
* 3D Noise Chunk Generator was optimised to avoid biome lookups when possible
* Adjacent palette locators no longer instantiate 4 extra Column instances
* Iteration over Range using foreach was replaced with index-based iteration in hot code.
This version also adds a new core addon, the Biome Extrusion Provider.
The Extrusion Provider takes another biome provider as a parameter, which it uses as a "base." Through "extrusion" layers, 3D biomes are inserted on top of the base biomes.
This release also fixes a Minecraft bug where bee entities access the world random instance upon instantiation, which during worldgen can potentially cause an exception due to a race condition (Fixes #327)
08.07.2022 · 188 downloads
This version adds full support for 3D biomes in the following addons:
* 3D Noise Chunk Generator (3D biomes are sampled for noise)
* Feature Generation Stage (Feature generator uses ranges in biome columns to place features)
A number of optimisations regarding 3D biomes were added:
* Addition of "biome columns" to avoid repeating expensive 3D computations
* Optional override for a BiomeProvider implementation to return a "base biome" used in biome columns
* More advanced biome caching
* Finer control over biome caches
Several other general-purpose optimisations were added:
* TerraScript backend was rewritten to store LVs in an array-based table with reference and store nodes containing table indices, rather than storing in an ID-based hashmap
* 3D Noise Chunk Generator was optimised to avoid biome lookups when possible
* Adjacent palette locators no longer instantiate 4 extra Column instances
* Iteration over Range using foreach was replaced with index-based iteration in hot code.
This version also adds a new core addon, the Biome Extrusion Provider.
The Extrusion Provider takes another biome provider as a parameter, which it uses as a "base." Through "extrusion" layers, 3D biomes are inserted on top of the base biomes.
This release also fixes a Minecraft bug where bee entities access the world random instance upon instantiation, which during worldgen can potentially cause an exception due to a race condition (Fixes #327)
08.06.2022 · 1 237 downloads
This version fixes an issue on Windows during Terra installation
07.06.2022 · 138 downloads
== operation on Strings01.06.2022 · 10 522 downloads
Version 6 is a near complete rewrite of Terra; more changes were made during 6.0 development than the entirety of Terra development prior. Here's a short overview of the changes:
You can see a full list of changes in the 6.0 tracking Pull Request.
You can read more about the new API at the new Terra wiki
27.05.2022 · 426 downloads
23.11.2021 · 1 016 downloads
Alpha snapshot of 6.0.0
For a full changelog, along with what still needs to be done, see the Pull Request on GitHub: https://github.com/PolyhedralDev/Terra/pull/227
Report any issues on GitHub: https://github.com/PolyhedralDev/Terra/issues
20.06.2021 · 4 686 downloads
08.06.2021 · 1 070 downloads
19.05.2021 · 5 865 downloads
19.05.2021 · 9 237 downloads
16.05.2021 · 518 downloads
15.05.2021 · 2 010 downloads
14.05.2021 · 308 downloads
12.05.2021 · 453 downloads
11.05.2021 · 190 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
11.05.2021 · 109 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
11.05.2021 · 138 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
11.05.2021 · 163 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
11.05.2021 · 210 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
04.05.2021 · 750 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
04.05.2021 · 3 729 downloads
The project has been updated to project ':platforms:forge'. No changelog was specified.
04.05.2021 · 158 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
04.05.2021 · 230 downloads
The project has been updated to project ':platforms:forge'. No changelog was specified.
03.05.2021 · 136 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
03.05.2021 · 178 downloads
The project has been updated to project ':platforms:forge'. No changelog was specified.
03.05.2021 · 188 downloads
The project has been updated to project ':platforms:forge'. No changelog was specified.
27.04.2021 · 126 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
16.04.2021 · 158 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
12.04.2021 · 140 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
11.04.2021 · 98 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
01.04.2021 · 138 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
01.04.2021 · 889 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
30.03.2021 · 154 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
30.03.2021 · 161 downloads
The project has been updated to project ':platforms:fabric'. No changelog was specified.
29.03.2021 · 135 downloads
17.03.2021 · 150 downloads
17.03.2021 · 127 downloads
08.03.2021 · 180 downloads
Performance improvements
25.02.2021 · 166 downloads
This version adds inventory and entity support, meaning the loot and entity TerraScript functions will now work.
It also adds more rotation stuff, so there should no longer be weirdly rotated stuff in structures.
24.02.2021 · 176 downloads