BiomeTweaker Mod — Reference
Biome Properties
BiomeTweaker allows you to override almost every attribute of a biome. This is useful for creating "Sub-Biomes" or thematic variations of existing areas.
Modifiable Attributes
- Name: Changes the display name shown in the F3 debug menu.
- Temperature: Affects whether it snows or rains and determines the color of grass and leaves.
- Rainfall: Higher values generally result in more frequent weather events.
- Height/Variation: Controls the base altitude and the "ruggedness" of the terrain.
- Colors: You can manually set hex codes for Grass, Foliage, Water, and Sky colors.
Color Modification Example
myBiome = forBiome("minecraft:forest")
myBiome.set("grassColor", 0xADFF2F)
myBiome.set("foliageColor", 0x228B22)
myBiome.set("waterColor", 0x00FFFF)
myBiome.set("skyColor", 0xFF69B4)
Block Replacement
One of the most powerful features of BiomeTweaker is the ability to swap blocks during the world generation process. This can be used to create "wasteland" biomes where dirt is replaced by gravel, or "fantasy" biomes where stone is replaced by colored glass.
Replacement Stages
Block replacement can occur at different stages of generation: 1. PRE_DECORATION: Replaces blocks before trees, ores, and structures are placed. 2. POST_DECORATION: Replaces blocks after everything else has been generated.
Advanced Replacement
You can specify the Y-level range for replacements to create underground layers or unique surface crusts.
| Parameter | Description |
|---|---|
targetBlock |
The block ID to look for (e.g., "minecraft:dirt"). |
replacementBlock |
The block ID to place (e.g., "minecraft:mycelium"). |
minHeight |
The lowest Y-level for the replacement. |
maxHeight |
The highest Y-level for the replacement. |
Mob Spawning Control
BiomeTweaker provides granular control over entity spawning. You can remove vanilla mobs to make a biome more dangerous or add modded mobs to biomes they don't naturally inhabit.
Spawn Categories
Mobs are divided into categories that dictate how they spawn: * MONSTER: Hostile mobs (Zombies, Skeletons). * CREATURE: Passive mobs (Cows, Sheep). * AMBIENT: Decorative mobs (Bats). * WATER_CREATURE: Aquatic mobs (Squid, Cod).
Example: Creating a Wolf-Only Forest
forest = forBiome("minecraft:forest")
forest.removeAllSpawns("CREATURE")
forest.addSpawn("minecraft:wolf", 50, 4, 8)
Feature and Structure Control
In addition to blocks and mobs, BiomeTweaker can toggle the generation of specific world features. This includes trees, flowers, ores, and large structures like Villages or Strongholds.
Feature Manipulation
You can use the removeFeature command to strip a biome of specific elements. For example, if you want a desert with no lakes, you can target the lake feature specifically.
Note: In 1.18.2 and 1.19.2, features are heavily tied to the vanilla Tag system. BiomeTweaker allows you to interact with these tags to add or remove groups of features (like all types of trees) simultaneously.