OBSIDREL / DOCS

Documentation

Guides, tutorials and technical references for the Obsidrel ecosystem.

DocumentationComplete Furniture: chair, display, states and custom models

Complete Furniture: chair, display, states and custom models

Furniture combines a visual model, display, hitboxes and optional seats. Define it in plugins/Obsidrel/resources/furniture/. Display is not a separate item: it controls how the placed model renders.

Basic chair with a seat

This uses actual bundled Showcase assets:

yaml
showcase_oak_chair:
  name: '<gold><bold>Tavern Chair</bold></gold>'
  item:
    material: PAPER
  model:
    path: obsidrel:furniture/showcase/oak_chair
    texture: obsidrel:block/showcase/furniture/dark_oak
    parent: minecraft:block/block
  placement:
    type: FLOOR
    rotation:
      mode: SNAP
      step: 45
    require-solid-support: true
    collision-radius: 0.65
  display:
    scale: 1.8
    offset: {x: 0.0, y: 0.0, z: 0.0}
  hitboxes:
    - {x: 0.0, y: 0.55, z: 0.0, width: 0.9, height: 1.15}
  seats:
    - {x: 0.0, y: 0.48, z: 0.0, yaw: 0}
  interactions:
    commands: []
  breaking:
    drop: obsidrel:showcase_oak_chair

The pack and definitions must contain obsidrel:furniture/showcase/oak_chair and obsidrel:block/showcase/furniture/dark_oak.

Advanced opening/closing forge

The bundled forge has two models, two initial hitboxes and three while open. Interact to switch states:

yaml
showcase_runic_forge:
  name: '<gradient:#fb923c:#a78bfa><bold>Runic Forge</bold></gradient>'
  item:
    material: PAPER
  model:
    path: obsidrel:furniture/showcase/runic_forge
    texture: obsidrel:block/showcase/furniture/forge_stone
    parent: minecraft:block/block
  placement:
    type: FLOOR
    require-solid-support: true
    collision-radius: 0.95
    rotation: {mode: SNAP, step: 45}
  display:
    scale: 1.8
  hitboxes:
    - {x: -0.35, y: 0.55, z: 0.0, width: 0.8, height: 1.1}
    - {x: 0.35, y: 0.55, z: 0.0, width: 0.8, height: 1.1}
  states:
    default: closed
    toggle-on-interact: true
    values:
      closed:
        model:
          path: obsidrel:furniture/showcase/runic_forge
      open:
        model:
          path: obsidrel:furniture/showcase/runic_forge_open
        hitboxes:
          - {x: -0.35, y: 0.55, z: 0.0, width: 0.8, height: 1.1}
          - {x: 0.35, y: 0.55, z: 0.0, width: 0.8, height: 1.1}
          - {x: 0.0, y: 0.5, z: -0.48, width: 0.75, height: 0.75}
        seats: []
  breaking:
    drop: obsidrel:showcase_runic_forge
  protection:
    explosions: true

The Showcase provides models/furniture/showcase/runic_forge.json and models/furniture/showcase/runic_forge_open.json. State-specific display.offset and yaw-offset are also supported.

Supply a Blockbench JSON and PNG

  1. Export your JSON to pack/source/assets/obsidrel/models/furniture/my_chair.json.
  2. Save pack/source/assets/obsidrel/textures/block/my_wood.png.
  3. Set model.path: obsidrel:furniture/my_chair and model.texture: obsidrel:block/my_wood.
  4. Fix texture references inside the JSON, not only in the YAML.
  5. Build and deliver the pack with /obsidrel pack build.

Display versus hitboxes

display.scale: 1.0 is uniform; scale: {x: 1.0, y: 1.5, z: 1.0} is per-axis. display.offset moves the visual, not the hitboxes; display.anchor aligns its origin. Hitboxes control interaction, seats control sitting locations.

Verify

Rotate, scale, click each hitbox, sit, switch states and restart the server. interactions.commands invokes interaction commands; it is not a generic actions list.

See Furniture options and States/hitboxes.

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.