Repository navigation
Block Filters
All features of the mod can appear on some blocks but not others. To determine which blocks are valid for which features, the mod uses a set of Block Filters for each different type of block that may impact rendering. These blocks identified by these lists, in order of priority, are:
- Dirt blocks
- Grass blocks
- Blocks that obstruct short grass
- Sand blocks
- Blocks that may contain Extra Leaves
- Blocks that may spawn Falling Leaves
- Blocks that may spawn Rising Souls
- Log blocks
- Cactus blocks
- Lilypads
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 block to get relevant filter information about the block you're currently looking at.
For more information check the Resource Pack Integration wiki page.
For information about configurable features check this wiki page.
For information about Biome Filters check this wiki page.
There are two base types of block filters: block name or block 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 disregard blocks 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 block name filter is a string in the form <modName:blockName:metadata>, optionally preceded by a blacklist marker.
If modName is omitted it defaults to minecraft.
If metadata is omitted then the filter will match any instance of a block, no matter which metadata it has.
At least one of modName or metadata must be present. modName must always be present.
A block class filter is a string representation of a java classpath that inherits from the base block class: net.minecraft.block.Block, 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.
- Match any block that is an instance of, or inherits from, the Minecraft base log:
net.minecraft.block.BlockLog
- Match any of Et Futurum Requiem's leaf blocks, except the variations of Cherry Leaves:
<etfuturum:leaves>
-<etfuturum:leaves:1>
-<etfuturum:leaves:5>
-<etfuturum:leaves:13>
- Match any normal log except Extra Biomes XL's Sakura tree log:
net.minecraft.block.BlockLog
-extrabiomes.blocks.BlockMiniLog
Last updated: Version 2.0.0