Skip to content

Biome Filters

kynake edited this page Nov 16, 2026 · 3 revisions

Some features in the mod can be limited to appear in only certain biomes. The filtering of which biomes can and can't be used for a feature is determined by a list of biome filters. this allows the valid biomes for a specific feature to be pre-configured without relying on the biome's ID, which may be different for different modpacks.

These filter can also be included in mods or resource packs. In which case they will be used to dynamically generate the in-game set of filters without completely overriding the ones from packs with lower priority.

While in-game you can use the command /betterfoliage biome to get relevant filter information about the biome you're currently in.

For more information check the Resource Pack Integration wiki page.


For information about configurable features check this wiki page.
For information about Block Filters check this wiki page.


Biome Filter Template

There are two base types of biome filters: biomeID or biome class filters.

Both types of filters may optionally start with a - character. This makes the filter act as an entry on a blacklist, making the rule block biomes that match it instead of allowing them.

When the full list of filter is dynamically assembled in-game all blocking filters from the same source, be it from the player's config file, a resource pack or a mod, will take precedence over other filters in the same file.


A biomeID filter is an integer number. For example:
2, -53, -0. This number is the biome's in-game ID, optionally preceded by a blacklist marker.


A biome class filter is a string representation of a java classpath that inherits from the base biome class: net.minecraft.world.biome.BiomeGenBase, optionally preceded by a blacklist marker. A filter of this type will match any class that is an instance of, or inherits from, the given class.

Additional sub-filters may be added after the classpath, separated by :. These sub-filters are:

  • n - The biome's name must match this, exactly.
  • r - Whether rain can happen in this biome. Valid values are True or False.
  • s - Whether snow can happen in this biome. Valid values are True or False.
  • t - The biome's temperature must be strictly greater than this value.
  • T - The biome's temperature must be strictly less than this value.
  • h - The biome's humidity (rainfall) must be strictly greater than this value.
  • H - The biome's humidity (rainfall) must be strictly less than this value.

Examples

  • Match all biomes except the default vanilla Ocean (which has the biome ID 0):
net.minecraft.world.biome.BiomeGenBase
-0

  • Match any vanilla Ocean or River biome variant (or any modded biome that derives from those):
net.minecraft.world.biome.BiomeGenOcean
net.minecraft.world.biome.BiomeGenRiver

  • Match any Tropicraft biome, except rainforests:
net.tropicraft.world.biomes.BiomeGenTropicraft
-net.tropicraft.world.biomes.BiomeGenRainforest

  • Match any biome where rain can occur, temperature > 0.4 and humidity < 0.9:
net.minecraft.world.biome.BiomeGenBase:rTrue:t0.4:H0.9

  • Match any biome, unless it's named "Deep Ocean" (this will block, for example, Minecraft's default Deep Ocean and TerraFirmaCraft's biome with the same name):
net.minecraft.world.biome.BiomeGenBase
-net.minecraft.world.biome.BiomeGenBase:nDeep Ocean

Last updated: Version 2.0.0

Clone this wiki locally