OBSIDREL / DOCS

Documentation

Guides, tutorials and technical references for the Obsidrel ecosystem.

DocumentationResource Pack: create and deliver custom models, textures and audio

Resource Pack: create and deliver custom models, textures and audio

Resource packs power Items, Blocks, Furniture, Entities, Fonts and visual UI. Editable source is plugins/Obsidrel/pack/source/; never use pack/generated/ as source.

1. Custom item image

Save pack/source/assets/obsidrel/textures/item/ruby.png. In the item YAML:

yaml
ruby:
  material: EMERALD
  name: '<red>Custom Ruby</red>'
  model:
    path: obsidrel:item/ruby
    texture: obsidrel:item/ruby

obsidrel:item/ruby refers to the image without the PNG extension.

2. Blockbench Furniture model

Place:

text
pack/source/assets/obsidrel/
├── models/furniture/my_chair.json
└── textures/block/my_wood.png

Set model.path: obsidrel:furniture/my_chair and model.texture: obsidrel:block/my_wood on Furniture. Update the JSON model's own texture references too.

3. Fonts, animations and sounds

  • Bitmap glyph: textures/font/orb.png, with a font texture: obsidrel:font/orb.png (with extension).
  • Animated block: vertical strip PNG and model.animation.frametime; pack build generates animation metadata.
  • Custom sound: sounds/ui/click.ogg and sound event obsidrel:ui/click defined under resources/sounds/.
  • Optional packs/sources under pack/sources/; pack/generated/ is compiled output.

4. Build, publish, test

  1. Run /obsidrel reload for YAML.
  2. Run /obsidrel pack build for assets.
  3. Check /obsidrel pack status and delivery provider/URL.
  4. Run /obsidrel pack publish if the configured provider requires publication.
  5. Test /obsidrel pack send <player> and wait for SUCCESSFULLY_LOADED.
  6. Debug keys, namespaces, target version, JSON references, download and client cache.

See Blocks, Furniture, Items, Fonts, Sounds.

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.