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** - (https://modrinth.com/mod/fabric-api) - (https://modrinth.com/mod/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)**.