Terra is a modern world generation modding platform, primarily for Minecraft. Terra allows complete customization of world generation with an advanced API, tightly integrated with a powerful configuration system.

Terra consists of several parts:

A voxel world generation API with emphasis on configuration and extensibility
Several platform implementations, the layer between the API and the platform it's running on.
An addon loader, which allows interfacing with the Terra API in a platform-agnostic setting
Several "core addons," which implement the "default" configurations of Terra. These addons can be thought of as the config "standard library"

Terra currently officially supports the Fabric mod loader and the Bukkit API (Paper and friends). We welcome Pull Requests implementing additional platforms!

Downloads:

Fabric: Modrinth / CurseForge
Paper+ servers (Paper, Tuinity, Purpur, etc): SpigotMC

Building and Running Terra

To build, simply run ./gradlew build (gradlew.bat build on Windows). This will build all platforms, and produce JARs in platforms/<platform>/build/libs

Production JARs:

Bukkit: Terra-<version>-shaded.jar
Fabric: Terra-<version>-shaded-mapped.jar

Building a Specific Platform

To build a specific platform, run gradlew :platforms:<platform>:build.

JARs are produced in platforms/<platform>/build/libs.

Running Minecraft in the IDE

To run Minecraft with Terra in the IDE (for testing) use the following tasks:

Bukkit
- installPaper - Install a Paper test server. (Only needs to be run once).
- installPurpur - Install a Purpur test server. (Only needs to be run once).
- runPaper - Run the Paper test server with Terra (installPaper must have been run previously).
- runPurpur - Run the Purpur test server with Terra (installPurpur must have been run previously).
Fabric
- runClient - Run a Minecraft Fabric client with Terra installed.
- runServer - Run a Minecraft Fabric server with Terra installed.

Contributing

Contributions are welcome! If you want to see a feature in Terra, please, open an issue, or implement it yourself and submit a PR! Join the discord here if you would like to talk more about the project!

Beta

Terra is still in beta! While it is stable, it is not feature-complete. There is a lot to be added!