OBSIDREL / DOCS

Documentation

Guides, tutorials and technical references for the Obsidrel ecosystem.

DocumentationBlocks reference: accepted values and behavior

Blocks reference: accepted values and behavior

Actual fields parsed from resources/blocks/, verified against the Core.

FieldValuesMeaning
model.pathnamespace:block/nameModel key
model.textureminecraft:block/... or namespace:block/...Texture key
model.parentmodel, default minecraft:block/cube_allModel parent
model.shapeFULL, CROSSFull cube or crossed planes
carrier.typeNOTE_BLOCK, STRING, CUTOUT_STATE, LIGHT, GRATE, SLAB, STAIR, TRAPDOOR, DOORPhysical carrier; availability depends on version
placement.orientationNONE, HORIZONTAL, HORIZONTAL_OPPOSITE, FACE, AXISNo rotation, horizontal, opposite, face or axis
placement.allowed-faces[] or UP, DOWN, NORTH, SOUTH, EAST, WESTEmpty permits every face
placement.worlds[] or world namesEmpty means any world
placement.permissiontextPlacement permission
placement.require-solid-supportboolean, falseSupport requirement
placement.min-y, max-yoptional integersVertical limits
breaking.hardnesspositive number, default 1.5Hardness
breaking.tools.requiredbooleanTool requirement
breaking.tools.typesPICKAXE, AXE, SHOVEL, HOE, SHEARSRequired tool kinds
breaking.tools.minimum-tierANY, WOOD, GOLD, STONE, IRON, DIAMOND, NETHERITETier
breaking.drops.normalitem, amount or min/max, chanceDrops
breaking.drops.silk-touchenabled, itemSilk Touch output
breaking.loot.tableloot IDAlternative loot table
model.animationframetime, interpolate, framesVertical strip PNG animation
sounds, effects, protection.explosionssounds/particles/booleanEffects 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.

Was this article helpful?Loading ratings…

Help us improve Obsidrel documentation. One vote per account and article. Discord AI feedback can also contribute when the answer cites this article.