OBSIDREL / DOCS

Documentation

Guides, tutorials and technical references for the Obsidrel ecosystem.

DocumentationCreate blocks: basic and advanced projects

Create blocks: basic and advanced projects

An Obsidrel block combines YAML, a physical Minecraft carrier, and optional resource-pack assets. Place definitions under plugins/Obsidrel/resources/blocks/.

Basic vanilla-textured block

Create blocks.yml:

yaml
bloco_ametista:
  name: '<light_purple>Bloco de Ametista</light_purple>'
  model:
    path: obsidrel:block/bloco_ametista
    texture: minecraft:block/amethyst_block
    parent: minecraft:block/cube_all
    shape: FULL
  carrier:
    type: NOTE_BLOCK
  placement:
    orientation: NONE
    worlds: []
    allowed-faces: []
  breaking:
    hardness: 3.0

FULL generates a cube, orientation: NONE has one state and allowed-faces: [] means no face restriction. Run /obsidrel reload and test placement.

Advanced Arcane Bloom transparent plant

The bundled Showcase ships this definition and its actual texture. It demonstrates CROSS, PLANT, top-face restriction and custom drops:

yaml
showcase_arcane_bloom:
  name: '<gradient:#67e8f9:#a78bfa><bold>Arcane Bloom</bold></gradient>'
  model:
    path: obsidrel:block/showcase/arcane_bloom
    texture: obsidrel:block/showcase/arcane_bloom
    parent: minecraft:block/cross
    shape: CROSS
  carrier:
    type: PLANT
  placement:
    orientation: NONE
    permission: ''
    worlds: []
    allowed-faces: [UP]
    require-solid-support: true
  breaking:
    hardness: 0.02
    tools:
      required: false
      types: []
      minimum-tier: ANY
    drops:
      normal:
        - item: obsidrel:showcase_arcane_bloom
          amount: 1
          chance: 100.0
    experience: {min: 0, max: 0}
  sounds:
    place: BLOCK_GRASS_PLACE
    break: BLOCK_GRASS_BREAK
  effects:
    break-particle-material: AZALEA
    break-particle-count: 8
  drops:
    self: false
    creative: false
  protection:
    explosions: false

This example depends on the Showcase PNG assets/obsidrel/textures/block/showcase/arcane_bloom.png.

Add your own PNG

  1. Save flower.png under plugins/Obsidrel/pack/source/assets/obsidrel/textures/block/flower.png.
  2. Set model.texture: obsidrel:block/flower and model.path: obsidrel:block/flower (omit the PNG extension).
  3. For vegetation use minecraft:block/cross, shape: CROSS and a compatible PLANT carrier.
  4. Reload, run /obsidrel pack build, and deliver the pack.

Attach game behavior

Do not add a made-up actions field to the block itself. Use a Trigger such as BLOCK_BREAK with its target pointing to the block and an existing Action with Conditions.

Verify

Test all placement faces, solid support, breaking tools, Silk Touch, worlds and restart persistence. Back up before changing a placed block's carrier or orientation.

See Blocks reference and Carriers.

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.