Skip to content

Custom Biomes Addon

Ryandw11 edited this page Jan 23, 2022 · 5 revisions

The Custom Biomes addon allows for Custom Structures to support Custom Biomes created by Data Packs or Plugins.

Installation

  1. Download the addon jar file for your Java version from ci.ryandw11.com
    1. If your server is running Java 8 - Java 15, then download the one with Java1.8.jar at the end. (Supports Minecraft 1.15.x, 1.16.5)
    2. If your server is running Java 16+, then download the one with Java16.jar at the end. (Supports Minecraft 1.15.x, 1.16.5, 1.17.x, 1.18.x)
  2. Put the Jar file within your plugins folder like any other plugin.
  3. Start the server.

Usage

You configure the Custom Biomes addon in the structure configuration file you want.
The CustomBiomes section works like any of the default sections.

CustomBiomes:
  BiomeKey:
    Namespace: 'minecraft'
    Key: 'midlands_end'
  Depth: [0;1]
  Scale: [0;1]
  BaseTemp: [0;1]
  Category: 'taiga'

Required: No

Biome Key

BiomeKey:
    Namespace: 'minecraft'
    Key: 'midlands_end'

Required: No

This allows you to make the structure only spawn in one specific biome. If you do not want this, then you can remove the entire sub-section.

Namespace

Namespace: 'minecraft'

Required: Yes
Value: String
Default Value: None

This defines the Namespace of the biome you want to limit. The namespace is usually the plugin or data pack name. You should double check with the author or documentation of your Datapack/Plugin for the exact name.

Key

Key: 'midlands_end'

Required: Yes
Value: String
Default Value: None

This defines the key of the biome you want to limit the structure to.

Depth

Depth: [0;1]

Required: No
Value: Float Range or Float
Default Value: None

This allows you to limit the structure to only spawn in biomes within the depth range or with the exact depth value. In Minecraft the depth of a biome usually ranges between 0 and 1.
Examples Values: [0.3;0.5], 0.32

Scale

Scale: [0;1]

Required: No
Value: Float Range or Float
Default Value: None

This allows you to limit the structure to only spawn in biomes within the scale range or with the exact scale value. In Minecraft the scale of a biome usually ranges between 0 and 1.
Examples Values: [0.3;0.5], 0.32

Base Temperature

BaseTemp: [0;1]

Required: No
Value: Float Range or Float
Default Value: None

This allows you to limit the structure to only spawn in biomes within the base temperature range or with the exact base temp value. In Minecraft the base temperature of a biome usually ranges between 0 and 1.
Examples Values: [0.3;0.5], 0.32

Category

Category: 'taiga'

Required: No
Value: String
Default Value: None

This will limit the structure to only spawn in a specific biome category. Biome Categories are a group of several biomes of a certain type. In Minecraft there are often several different types of biomes that are similar, for example: GIANT_SPRUCE_TAIGA, GIANT_SPRUCE_TAIGA_HILLS, GIANT_TREE_TAIGA, GIANT_TREE_TAIGA_HILLS, SNOWY_TAIGA, SNOWY_TAIGA_HILLS, SNOWY_TAIGA_MOUNTAINS, TAIGA_HILLS, etc. are all apart of the general Taiga biome. This allows you to specify you want it to spawn in all of those biomes.