Terra is a highly customizable data-driven world generator engine.

Images


Download

The download for the latest version of Terra can be found on this page. For
releases of Terra supporting older versions and other platforms, refer to our
[versions page]( http://terra.polydev.org/install/versions.html).

Installation

You can find installation instructions for the Bukkit version of Terra here.

Features

Extreme Configurability

Terra allows every possible facet of world generation we can practically implement to be controlled via configuration.
This means you can *modify the way everything generates* in a world, without needing to touch any Java code.

Terra's configuration system offers greater control over many facets of world generation compared to vanilla data packs,
you don't have to rely on work-arounds and limited functionality.

Aspects such as terrain shaping, biome distribution, decoration, generation stages, and so on are implemented
at the config level. Terra is not limited to overworld-like generation, meaning it can be used for any kind of dimension. You
could use it to generate the nether, the end, or even non-vanilla worlds of floating islands, abstract shapes, or any mish-mash
combination of the former.

Multiple World Generators & Config Packs

Each world generator within Terra is defined by a collection of config files, called a 'config pack'. These config packs
can easily be installed, opened up, modified for personal use, and or shared with the community!
Multiple config packs can be installed, and used for any number of worlds you wish. (Config packs work similarly to Minecraft
resource packs.)

• If you don't like a particular aspect of a Terra world - such as a specific biome generating, or how common ores are - you can roll your own of a config pack and tweak these things to better meet your vision.
• If you need a particular generated world for an event, you can make a config pack for it. For example a simple snowy world with only candy canes and pine trees for a christmas themed event, or a spooky endless forest filled with twisted trees and dark skies for a halloween event.
• If you want a tailor-made world built to your exact specification, you can create it by making your own config pack from scratch.
• If you are an artist and like making pretty worlds, you could use Terra as your medium.
• If you want to learn how procedural voxel world generation works, you could use config development as a learning tool.

Default Overworld Configuration

Terra comes pre-packaged with the comprehensive survival friendly Terra Overworld config pack by default,
and is featured in the images above.

Community Made Packs

You can find a list of free to use and modify community made packs here. The PolyDev community emphasizes sharing and collaboration in the creation and use of config packs, to make cool stuff available to everyone. (This does not mean you are obligated to share anything you have created, however we encourage giving back to the community if you feel so inclined!)

Config pack installation guide

Installed packs can be listed via the /packs command.

Vanilla Structure Compatibility

Terra has compatibility with vanilla structures, meaning you will see vanilla structures generating in a Terra world (unless explicitly disabled
either via server.properties or by your world manager). This also extends to anything that modifies or adds structures through vanilla means, such as plugins and or datapacks.

Image Based Distribution

Image based generation is one notable feature supported by the core addons. You can use images to distribute any part of world generation.
This includes aspects like biome distribution, terrain shape, and control of where structures like trees are placed.

Hot Reloads

During config development, you can reload your pack while the server is running by using the /packs reload command.
Any new chunks generated in your world will reflect changes made to your pack after running the command.

Config Development Tools

The following stand-alone tools are available to aid in config development:

• NoiseTool - A visualizer for noise configs.
• BiomeTool- Biome distribution visualizer.

Multi-platform

Terra runs on several Minecraft software platforms, including but not limited to Bukkit (specifically Paper+ servers) and Fabric (for both single player and or server use!).The codebase is designed to provide a common world generation interface for multiple platforms, which also
extends to the ability for config packs to work cross-platform!

For a full list of the various releases available for different platforms, check out the versions page.

Addon System

Terra implements its own addon loader, allowing developers to take advantage of our platform agnostic world generation API and write addons that run on any platform. Addons typically add new functionality to Terra,
and are loaded by Terra via .jars similarly to how plugins and mods are loaded. Most world generation functionality is actually implemented by a set of core addons that are shipped with Terra by default.

Starting Config Development

See the Config Development Introduction page for instructions on how to get started.

Support

If you run into any issues during installation, configuration, and or use,
refer to our documentation. If you can't find what you're looking for
there, join the PolyDev community via our Matrix space, which is also
bridged to our Discord server. Please keep in mind when seeking support that helpers and maintainers are all volunteers who graciously provide support for Terra within their free time. These people will be less inclined to help you if you are being difficult and or unclear with your support needs.

Terra is Free

Terra is, and always will be, completely free and open-source. There is no
premium version, and no paid support.

This means you can:

• Use Terra freely
• Make copies of Terra
• View and modify the source code
• Contribute code
• Copy and distribute your own versions of Terra

See the project's licence for a more comprehensive list of conditions.

Why?

For too long, world generation options on Spigot have been limited to pay-walled and/or closed source plugins, requiring server owners to gamble whether or not a particular generator meets their needs or even works in the first place* Terra aims to break this pattern by providing free highly customizable and extensible world generation for all.

Supporting the Project

If you like Terra, please consider donating so i can buy more Dr. Pepper

• Patreon

Donating grants you no extra features or benefits. (The only thing you
get is the satisfaction of supporting the project, and a fancy Discord role.)

You can also support us for free by starring the project on the Terra GitHub repository GitHub promotes starred projects, and rolls out new beta features first to repositories with more stars, so starring the project is a great way to support us!