Saltar al contenido principal

Custom Biome Definition

The Custom Biome Definition entry is the core of this extension. It allows you to register a entirely new biome into the server's datapack system.

Configuration​

biomeId — String

Unique ID for the biome (e.g. enchanted_forest). This is used in actions and checks.

displayName — String

The readable name used in placeholders and UI/Chat.

baseBiome — String

The vanilla biome to use as a template. Determines mob spawning and generation features unless overridden. Example: minecraft:forest.

temperature — Float

Biome temperature (0.0 to 1.0). Affects snow generation and foliage color in some resource packs.

downfall — Float

Rain/Snow amount (0.0 to 1.0).

Visuals (Colors)​

fogColor — HexColor

Color of the distance fog.

waterColor — HexColor

Color of the water surface and underwater fog.

skyColor — HexColor

Color of the sky.

grassColor — HexColor

Override color for grass blocks.

foliageColor — HexColor

Override color for tree leaves and vines.

Visual Attributes (1.21.11+)​

fogStartDistance — Float

Distance where fog starts.

fogEndDistance — Float

Distance where fog ends.

skyFogEndDistance — Float

Distance where sky fog ends.

waterFogStartDistance — Float

Distance where water fog starts.

waterFogEndDistance — Float

Distance where water fog ends.

cloudFogEndDistance — Float

Distance where cloud fog ends.

cloudHeight — Float

Height of the clouds.

skyLightFactor — Float

Multiplier for sky light brightness.

sunAngle — Float

Sun angle (0.0 = overhead).

moonAngle — Float

Moon angle.

starAngle — Float

Star angle.

starBrightness — Float

Star brightness.

moonPhase — String

Moon phase (e.g. full_moon, waning_gibbous).

id: enchanted_biome
type: custom_biome_definition
name: "Enchanted Forest"
biomeId: enchanted_forest
baseBiome: minecraft:forest
temperature: 0.7
fogColor: "#1a3d2e"
waterColor: "#3f76e4"
skyColor: "#7ba4db"

[!WARNING] You must restart your server after creating or modifying a biome definition. The server needs to generate/update the datapack during the startup sequence.