API

This document is a WORK IN PROGRESS. Currently, it only contains some information about the used groups.

Groups

This section explains all the used groups in this subgame.

dig_by_water=1: Blocks with this group will drop when they are near flowing water
cultivatable=2: Block will be turned into Farmland by using a hoe on it
cultivatable=1: Block will be turned into Dirt by using a hoe on it
flammable: Block helps spreading fire and gets destroyed by nearby fire (rating doesn't matter)
soil=1: Saplings and other small plants can grow on it
soil_sapling=2: Soil for saplings. Intended to be natural soil. All saplings will grow on this
soil_sapling=1: Artificial soil (such as farmland) for saplings. Some saplings will not grow on this
soil_sugarcane=1: Sugar canes will grow on this near water
disable_suffocation=1: Disables suffocation for full solid cubes (1)

Normally, all walkable blocks with the default 1×1×1 cube as a collision box (e.g. sand, gravel, stone, but not fences) will damage the players while their head is inside. This is called “suffocation”. Setting this group disables this behaviour

sand=1: Sand (any color)
sandstone=1: (Yellow) sandstone and related nodes (chiseled and the like) (only full blocks)
redsandstone=1: Red sandstone and related nodes (chiseled and the like) (only full blocks)
quartz_block=1: Quartz Block and variants (chiseled, pillar, etc.) (only full blocks)
stonebrick=1: Stone Bricks and related nodes (only full blocks)
tree=1: Oak Wood, Birch Wood, etc. (tree trunks)
wood=1: Oak Wood Planks, Birch Wood Planks, etc. (only full blocks)
wood_slab=1: Slabs made out of a kind of wooden planks
wood_stairs=1: Stairs made out of a kind of wooden planks
coal=1: Coal of any kind (lumps only, not blocks)
wool=1: Wool (only full blocks)
carpet=1: (Wool) carpet

These groups are used mostly for informational purposes

water=1: Water
lava=1: Lava
liquid: Block is a liquid
- liquid=1: Unspecified type
- liquid=2: Water
- liquid=3: Lava
clock=1: Clock
compass: Compass (rating doesn't matter)
rail=1: Rail
music_record: Music Disc (rating is track ID)
boat=1: Boat
minecart=1: Minecart
food: Item is a comestible item which can be consumed (healthy or unhealthy)
- food=2: Food
- food=3: Drink
- food=1: Other/unsure
eatable: Item can be directly eaten by wielding + left click (on_use=item_eat). Rating is the satiation gain
ammo=1: Item is used as ammo for a weapon
ammo_bow=1: Item is used as ammo for bows
weapon=1: Item is primarily (!) a weapon
tool=1: Item is primarily (!) a tool
craftitem=1: Item is primarily (!) used for crafting
brewitem=1: Item is primarily (!) used in brewing
transport=1: Item is used for transportation
building_block=1: Block is a building block
deco_block=1: Block is a decorational block