What Terra works with.
| Platform | Java Edition |
|---|---|
| Loaders | Bukkit, Folia, Paper, Purpur, Spigot |
| Minecraft versions | 1.13, 1.16.5, 1.18.2, 1.19.2, 1.20.1, 1.20.6, 1.21.1, 1.21.8 |
Terra replaces vanilla world generation on a Bukkit-family server with terrain, biomes, and structures defined entirely in YAML and TerraScript config packs. It runs on Paper, Folia, Purpur, Bukkit, and Spigot, with builds spanning Minecraft 1.13 through the current 6.6.6-BETA release on 1.21.8, and a matching Fabric, Forge, and Quilt mod line for singleplayer and modded servers.
What Terra changes in Minecraft
Instead of one fixed set of biomes, Terra reads a config pack, a folder or zip built around a pack.yml file, and generates the whole world from it: terrain shape, biome placement, structures, ore veins, and more, all defined in YAML and TerraScript rather than hardcoded into a jar. Terra ships with a single default pack called OVERWORLD, and the community has published dozens more through the project's own pack directory, from realistic overworld overhauls to Nether biome reskins, floating islands, void worlds, and even a Backrooms-style pack.
Installing Terra
- 1.Download the Terra build for your server platform and Minecraft version from Modrinth.
- 2.Place the .jar file into the server's plugins folder.
- 3.Restart the server and check the console log for Terra loading without errors.
Setting Terra as your world generator
Terra does not activate on its own after installation. Open bukkit.yml in the server directory and add a worlds entry mapping your world's level name to Terra:PACK_ID, using OVERWORLD for the default pack or the ID of an installed config pack. Delete or rename the existing world folder so the server regenerates it with Terra, then restart. Server admins running Multiverse-Core or another world manager can create a new Terra world without touching bukkit.yml directly.
Compatibility with server software
Terra targets Paper and Paper-based forks first. The project's own documentation says Terra will not be fully functional on plain CraftBukkit or Spigot, and recommends Paper, Purpur, Pufferfish, or another Paper fork instead. Recent build history lines up with that guidance: Paper, Folia, and Purpur are current at 6.6.6-BETA for 1.21.8, while the Bukkit and Spigot builds are frozen at 6.3.1-BETA for 1.20.1.
Config packs and where to find them
Installing a config pack works like installing a resource pack. Download the pack (usually a .zip from GitHub), find the folder that directly contains pack.yml, and drop that folder into Terra's packs directory. Terra's docs keep a public directory of community packs, each one versioned against a specific Terra release, so check pack compatibility before installing one on a live server.
What Terra does not do
Terra is a generation engine, not a finished map. Out of the box it only offers the plain OVERWORLD pack, so building anything more distinctive means writing a config pack yourself with YAML and TerraScript, or installing a community one. The project calls itself beta, stable but not feature-complete, so expect the occasional rough edge between releases. World generation from a heavily customized pack still takes real CPU time as new chunks load, so many admins pre-generate the map with a tool like Chunky before opening it to players.
Watch Terra set up on a server
Setting up Terra world generation on a Minecraft server
Questions about Terra.
5 questions
How do I install Terra on a Minecraft server?
Download the Terra build that matches your server software and Minecraft version from Modrinth, then place the .jar in your plugins folder and restart. Installing the plugin alone does not create a Terra world: you still need to point a world at it through bukkit.yml or a world manager plugin, and that step deletes the target world's existing folder, so back it up first.
Does Terra work on Spigot, or does it need Paper?
Terra lists Spigot and plain CraftBukkit as supported loaders on Modrinth, but its own documentation says Terra will not be fully functional on them and recommends Paper or a Paper-based fork like Purpur or Pufferfish instead. Recent build history backs that up: Paper, Folia, and Purpur are current at 6.6.6-BETA for 1.21.8, while Bukkit and Spigot builds are frozen at 6.3.1-BETA for 1.20.1.
Which Minecraft version does Terra support?
Terra's release history runs from 1.13 to 1.21.8, but the current build depends on the loader. Paper, Folia, Purpur, Fabric, and Quilt are updated to 1.21.8. Bukkit and Spigot stop at 1.20.1, and Forge lags furthest behind at 1.19.2. Check the version for your specific loader before downloading.
Is Terra the same plugin as the Terra121 Earth map mod?
No. Terra121, and its terraplusplus fork, is a separate and older Minecraft mod built on Cubic Chunks that maps real-world elevation data onto a 1:1 scale Earth. Terra, from PolyhedralDev, is a general-purpose world generation platform with its own community pack library, and none of the packs listed in its official docs generate an Earth-scale map.
Is Terra a plug-and-play plugin?
Not really. Terra ships with only a plain default pack, and its real value comes from config packs you either write yourself with YAML and TerraScript or install from the community. Budget time to pick or build a pack, back up your world, and test before opening a Terra-generated world to players.
