Blocks reference: accepted values and behavior
Actual fields parsed from resources/blocks/, verified against the Core.
| Field | Values | Meaning |
|---|---|---|
model.path | namespace:block/name | Model key |
model.texture | minecraft:block/... or namespace:block/... | Texture key |
model.parent | model, default minecraft:block/cube_all | Model parent |
model.shape | FULL, CROSS | Full cube or crossed planes |
carrier.type | NOTE_BLOCK, STRING, CUTOUT_STATE, LIGHT, GRATE, SLAB, STAIR, TRAPDOOR, DOOR | Physical carrier; availability depends on version |
placement.orientation | NONE, HORIZONTAL, HORIZONTAL_OPPOSITE, FACE, AXIS | No rotation, horizontal, opposite, face or axis |
placement.allowed-faces | [] or UP, DOWN, NORTH, SOUTH, EAST, WEST | Empty permits every face |
placement.worlds | [] or world names | Empty means any world |
placement.permission | text | Placement permission |
placement.require-solid-support | boolean, false | Support requirement |
placement.min-y, max-y | optional integers | Vertical limits |
breaking.hardness | positive number, default 1.5 | Hardness |
breaking.tools.required | boolean | Tool requirement |
breaking.tools.types | PICKAXE, AXE, SHOVEL, HOE, SHEARS | Required tool kinds |
breaking.tools.minimum-tier | ANY, WOOD, GOLD, STONE, IRON, DIAMOND, NETHERITE | Tier |
breaking.drops.normal | item, amount or min/max, chance | Drops |
breaking.drops.silk-touch | enabled, item | Silk Touch output |
breaking.loot.table | loot ID | Alternative loot table |
model.animation | frametime, interpolate, frames | Vertical strip PNG animation |
sounds, effects, protection.explosions | sounds/particles/boolean | Effects and safety |
Aliases: PLANT/CROSS → STRING; TRANSPARENT/CUTOUT → GRATE; STAIRS → STAIR; TRAP_DOOR → TRAPDOOR. Orientation: PLAYER_FACING → HORIZONTAL, PLAYER_FACING_OPPOSITE → HORIZONTAL_OPPOSITE, BLOCK_FACE → FACE.
Advanced blocks can also declare model.variants, states, lighting; use version-matched Showcase examples before mixing their state variants.
Read basic/advanced blocks and carriers/orientation.