🚀 Quickstart
- Craft a Display Shelf using sticks and spruce planks (see recipe below).
- Place it on a wall, floor, or any surface like a normal block.
- Right-click the shelf while holding an item to place that item on display.
- Sneak + right-click (or simply right-click an occupied shelf) to take the item back.
planks
The shelf is a wooden block, so break it with an axe to retrieve it cleanly.
🔊 Placing or removing an item plays a sound, similar to using an item frame.
🧊 If the shelf is destroyed while holding an item, the displayed item drops on the ground — nothing is lost.
📖 Overview
Display Shelf adds a slim wooden shelf block that lets you showcase a single item in full 3D. Instead of hiding items in chests or shulker boxes, put them out where everyone can see them — perfect for showing off rare finds, decorating builds, or setting up item galleries.
🪵 What It Adds
- Display Shelf — a thin wooden block that holds and shows one item at a time, tilted and rendered in 3D on top of the shelf.
- Visual clarity — items are rotated slightly for visibility from most angles.
- Synced — works reliably in multiplayer; displayed items are visible to all players.
🖱️ How To Use
- Placing an item: Right-click an empty shelf with any item in your hand. One copy is placed on the shelf and consumed (unless in Creative mode).
- Removing an item: Sneak-right-click an occupied shelf to take the item back. Right-clicking without sneaking also removes the item.
- Feedback: Placing or removing plays a sound; if you interact without sneaking, a message reminds you to sneak-right-click.
🎨 Abilities & Mechanics
- Each shelf holds exactly one item at a time, displayed at a slight tilt.
- The displayed item is purely visual — it's not consumed or altered, just held in place.
- Works with any item in the game — build custom displays, museums, or trophy walls.
- Items remain on the shelf when the chunk reloads or the server restarts.
🏛️ Progression & Strategy
- No crafting tree or upgrade path — it's a simple decorative and organizational tool.
- Highlight rare loot, enchanted gear, or unique finds.
- Build item museums, collection rooms, or shops.
- Add detail to shelves, display cases, and interior builds.
🛠️ Technical & Installation
📦 Mod Dependencies
- Fabric — requires Fabric API & Fabric Loader (recommended).
- NeoForge — requires Kotlin for Forge (KFF).
- Cross-compatible — Fabric and NeoForge clients can connect to the same server.
- Minimal version: 1.20.1+ ; works with latest releases.
🧠 Data & Sync
- Persistent storage — displayed items are saved in the world data; survives restarts.
- Multiplayer ready — item displays are synced to all players.
- Lightweight — no performance impact; uses vanilla rendering.
- Configurable via
/config/display-shelf/(future updates).
📥 Installation Guide
🧵 Fabric
1. Install Fabric Loader (recommended version).
2. Download Fabric API from Modrinth/CurseForge.
3. Download DisplayShelf-Fabric-[version].jar.
4. Place both JARs in .minecraft/mods/.
├── fabric-api-xxx.jar
└── DisplayShelf-Fabric-1.0.0.jar
⚙️ NeoForge
1. Install recommended NeoForge version.
2. Download Kotlin for Forge (KFF).
3. Download DisplayShelf-NeoForge-[version].jar.
4. Place both JARs in mods/.
├── Kotlin-For-Forge-xxx.jar
└── DisplayShelf-NeoForge-1.0.0.jar
✅ Fabric: Fabric Loader + Fabric API + DisplayShelf-Fabric ✅ NeoForge: NeoForge + Kotlin for Forge + DisplayShelf-NeoForge 📦 Both loaders → place JARs in /mods
Data location: world/display_shelf_data/ (per-dimension). No config needed for basic use.
📋 At a glance
| Feature | Detail |
|---|---|
| Block | Display Shelf (thin wooden block) |
| Capacity | 1 item per shelf |
| Interaction | Right-click to place; sneak+right-click to remove |
| Breaking | Drops displayed item + shelf (axe recommended) |
| Multiplayer | Fully synced — all players see the same item |
| Creative mode | Placing items does not consume the item |
| Sound | Plays on place/remove (item frame style) |
💡 Works with any item: tools, weapons, blocks, food, enchanted gear, and more.