JWFrames

JWFrames

Invisible, rotation-locked item frames — the right way.

JWFrames is a lightweight Paper/Spigot plugin that gives server builders precise control over item frames — without cluttering your hotbar with command blocks or relying on heavy utility suites.

Toggle visibility, lock rotation, and reset frames in a single shift-click. Everything is configurable: swap the trigger items, disable messages, or adjust the prefix to match your server's style.

---

Features

- 🔒 One-click reset — prevent players from spinning frames by accident; toggle on/off with a shift-click - 👁 One-click reset — hide the frame entity completely while keeping the item inside visible and functional - ↩ One-click reset — restore a frame to its default state (visible + freely rotating) instantly

---

How to use

1. Hold the appropriate item in your main hand (see table below) 2. Sneak (Shift) + right-click the target item frame 3. The action is applied immediately and a confirmation message is shown in chat

| Item | Action | Toggles | |------|--------|---------| | Glass Pane | Lock / unlock rotation | ✅ | | Shears | Make invisible / visible | ✅ | | Brush | Reset all modifications | ❌ |

> All trigger items can be changed in `config.yml`.

---

Commands & Permissions

| Command | Description | |---------|-------------| | `/jwframes reload` | Reload the plugin configuration |

| Permission | Description | Default | |------------|-------------|---------| | `jwframes.reload` | Allows reloading the plugin configuration | op |

---

Compatibility

- Java 21+ - Java 21+ - No external dependencies — drop the jar into your `plugins/` folder and restart

---

*Made by JohnWail · Issues and suggestions are welcome on the project page.*