Simple Frames

Simple Frames

Make your item frames invisible — shear a frame and the wooden border disappears, leaving just the item floating on your wall. No more ugly borders breaking up your builds, map walls, or item displays.

Fully server-side: install it on the server and every vanilla client sees the effect — no client mod required.

✨ Features

• ✂️ Shear to hide — left-click an item frame with shears and the frame turns invisible while it holds an item.
• 🧵 Leather to restore — left-click an invisible frame with leather to bring the border back.
• 👁️ Empty = visible — an emptied invisible frame reappears so you can still find and interact with it; put an item back and it hides again.
• 🎒 Survives breaking — break an invisible frame and it drops as a named, glinting item; place it and it’s invisible again.
• 🌟 Glow frames too — glow item frames work the same way (the item keeps its fullbright glow).
• ⚙️ Configurable — toggle shear durability loss and leather restoration, and rename the dropped item.
• 🔒 Permission-aware — the command is gated by a permission node (LuckPerms and friends) with an operator fallback.

🕹️ How to use

1. Put an item in an item frame (or glow item frame).
2. Left-click the frame with shears → it turns invisible.
3. To undo, left-click the invisible frame with leather.

Take the item out and the frame reappears; add an item and it hides.

🔧 Requirements

Fabric mod

• Fabric API
• Fabric Language Kotlin

Plugin — none. Just drop the jar in plugins/. Works on Paper, Purpur and Folia. An optional permission plugin (e.g. LuckPerms) lets you grant the command node to non-operators.

⚙️ Configuration

• Fabric: config/SimpleFrames.conf
• Plugin: plugins/SimpleFrames/config.yml

| Option | Default | Description |
| — | — |—–|
| doShearsBreak | true | Shears take durability damage / break when used to make a frame invisible. |
| fixWithLeather | true | Allow restoring with leather, and keeping invisibility when a frame is broken and re-placed. |
| invisibleFrameName | Invisible Item Frame | Name shown on the dropped invisible-frame item. |
| invisibleGlowFrameName | Invisible Glow Item Frame | Name shown on the dropped invisible glow-frame item. |

💬 Commands & permissions

• /simpleframes doShearsBreak <true|false>
• /simpleframes doLeatherFix <true|false>

Running a subcommand without a value shows the current setting.

The command is guarded by the permission node simpleframes.command. Grant it via your permission manager (LuckPerms / fabric-permissions-api); with no permission plugin installed it falls back to operator (level 3).