1
0
Fork 0
VoxeLibre-Fork-Pixel/API.md

113 lines
5.0 KiB
Markdown
Raw Normal View History

2017-01-11 13:34:08 +01:00
# 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.
2017-02-06 14:51:52 +01:00
### Special groups
* `not_in_creative_inventory=1`: Item will not be shown in creative inventory
* `not_in_craft_guide=1`: Item will not be shown as result or fuel item in crafting guide (but still may be shown as ingredient)
2017-01-11 13:34:08 +01:00
### Groups for interactions
* `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
2017-01-11 13:40:13 +01:00
* `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
2017-01-12 07:07:30 +01:00
* `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
2017-01-12 06:54:16 +01:00
* `soil_sugarcane=1`: Sugar canes will grow on this near water
2017-02-10 04:33:15 +01:00
* `soil_nether_wart=1`: Nether wart will grow on this
* `disable_suffocation=1`: Disables suffocation for full solid cubes (1)
2017-02-16 19:32:42 +01:00
* `destroys_items=1`: If an item happens to be *inside* this node, the item will be destroyed
2017-02-06 14:51:52 +01:00
#### Footnotes
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
2017-01-11 13:34:08 +01:00
### Groups (mostly) used for crafting recipes
* `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)
2017-02-07 02:19:25 +01:00
* `shulker_box=1`: Block is a shulker box
2017-01-11 13:34:08 +01:00
* `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
2017-01-11 13:40:13 +01:00
* `coal=1`: Coal of any kind (lumps only, not blocks)
* `wool=1`: Wool (only full blocks)
* `carpet=1:` (Wool) carpet
2017-02-07 02:54:17 +01:00
* `stick=1`: Stick
2017-01-11 13:34:08 +01:00
2017-01-16 21:21:47 +01:00
### Declarative groups
These groups are used mostly for informational purposes
2017-01-11 13:34:08 +01:00
2017-02-10 06:01:20 +01:00
* `solid=1`: Solid block (automatically assigned)
* `not_solid=1`: Block is sold (only assign this group for nodes which are automatically detected as “solid” in error
2017-01-11 13:34:08 +01:00
* `water=1`: Water
* `lava=1`: Lava
2017-02-10 14:43:45 +01:00
* `torch`: Torch or torch-like node
* `torch=1`: Torch on floor
* `torch=2`: Torch at wall
2017-01-11 13:40:13 +01:00
* `liquid`: Block is a liquid
* `liquid=1`: Unspecified type
* `liquid=2`: Water
* `liquid=3`: Lava
2017-02-10 05:33:49 +01:00
* `fence=1`: Fence
* `fence_gate=1`: Fence gate
* `fence_wood=1`: Wooden fence
* `fence_nether_brick=1`: Nether brick fence
2017-02-10 22:00:39 +01:00
* `flower_pot`: Flower pot
* `flower_pot=1`: Empty flower pot
* `flower_pot=2`: Flower pot with a plant or flower
2017-02-07 03:07:37 +01:00
* `book=1`: Book
* `pane=1`: Node is a “pane”-like node glass pane or iron bars
* `bed=1`: Bed
* `door=1`: Door
* `door=2`: Trapdoor
2017-01-11 13:40:13 +01:00
* `rail=1`: Rail
2017-01-11 16:25:49 +01:00
* `music_record`: Music Disc (rating is track ID)
2017-01-21 14:32:23 +01:00
* `tnt=1`: Block is TNT
2017-01-16 21:21:47 +01:00
* `boat=1`: Boat
* `minecart=1`: Minecart
* `food`: Item is a comestible item which can be consumed (healthy or unhealthy)
* `food=2`: Food
2017-02-16 15:08:26 +01:00
* `food=3`: Drink (including soups)
2017-01-16 21:21:47 +01:00
* `food=1`: Other/unsure
* `eatable`: Item can be *directly* eaten by wielding + left click (`on_use=item_eat`). Rating is the satiation gain
* `cocoa`: Node is a cocoa pod (rating is growth stage, ranging from 1 to 3)
2017-01-16 21:21:47 +01:00
* `ammo=1`: Item is used as ammo for a weapon
* `ammo_bow=1`: Item is used as ammo for bows
* `container`: Node is a container which physically stores items within and has at least 1 inventory
* `container=2`: Has one inventory with list name `"main"`. Items can be placed and taken freely
* `container=3`: Same as `container=2`, but shulker boxes can not be inserted
* `container=4`: Furnace-like, has lists `"src"`, `"fuel"` and `"dst"`
* `container=1`: Other/unspecified container type
2017-02-14 23:57:49 +01:00
* `spawn_egg=1`: Spawn egg
* `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
2017-01-16 21:21:47 +01:00
## Fake item groups
These groups put similar items together which should all be treated by the gameplay or the GUI as a single item.
You should not add custom items to these groups for no good reason, this is likely to cause a ton of conflicts.
* `clock=1`: Clock
* `compass`: Compass (rating doesn't matter)
This has the following implication: If you want to use a compass or clock in a crafting recipe, you *must*
use `group:compass` or `group:clock`, respectively.