Skip to content

Use Terra

Have you been tired of the boring ultra-flat terrain? Everyone playing on BDS server instead of your server? Well, struggle no more.

Introducing Terra, the best solution to solidify your position in the MCBE server space.

use-terra-p1.png

About

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 addons to interface 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"

Install Terra

To install Terra in Allay, reach their CI site in CodeMC, and you will see the latest build. Download the artifact named Terra-allay-<version>-shaded.jar and move it to the plugin folder.

Edit World Settings

Next, we need to specify the terrain generator for the world as Terra instead of the built-in flat generator. For example, if we want to modify the generator of default world, just open worlds/world-settings.yml and modify the following:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
built-in-dimensions:
  minecraft:overworld:
    min-height: -64
    max-height: 319
  minecraft:nether:
    min-height: 0
    max-height: 127
  minecraft:the_end:
    min-height: 0
    max-height: 255

worlds:
  world:
    storage-type: LEVELDB
    dimensions:
      minecraft:overworld:
        generator-type: TERRA
        generator-preset: meta-pack=DEFAULT;seed=114514
      minecraft:nether:
        generator-type: TERRA
        generator-preset: meta-pack=DEFAULT;seed=114514
      minecraft:the_end:
        generator-type: TERRA
        generator-preset: meta-pack=DEFAULT;seed=114514
# The default world is the world that newly joined players will be in
default-world: world

To set the pack used in Terra, edit generator-preset. The DEFAULT meta-pack is embedded in the plugin. To change the height of the built-in dimensions, edit the top-level built-in-dimensions section. If you want to disable Nether or The End, simply omit those dimension entries from the dimensions map.

You may need to delete the old world files if the world is already generated. In this example, you should delete worlds/world/db.

🥳 And that's it! Restart the server and enjoy it!

Comments