InvisibleFrames

A Bukkit/Paper plugin that lets players toggle item-frame visibility by sneak + right-clicking a frame with a configured tool, and optionally lock frames so they can't be broken. Built on MagicUtils with Folia support.

How it works

Sneak (hold shift) and right-click an item frame while holding the matching tool:

Tool (default)	Action
Shears	Hide the frame (make it invisible)
Brush	Show the frame (make it visible again)
Any stained-glass pane	Lock the frame so it can't be broken

Locked frames are protected from breaking by players, projectiles and other entities, unless the breaker has the invisibleframes.break.locked permission.

Commands

Base command: /invisibleframes.

Subcommand	Description
frame	Toggle visibility of the item frame you're looking at.
reload	Reload the configuration.

Permissions

Node	Grants
invisibleframes.hide	Hide frames.
invisibleframes.show	Show frames.
invisibleframes.lock	Lock frames.
invisibleframes.break.locked	Break locked frames.
invisibleframes.reload	Reload the config.

Permission checks can be turned off entirely with require-permissions: false.

Configuration

plugins/InvisibleFrames/invisibleframes.yml:

enabled: true
require-sneaking: true      # only trigger while the player is sneaking
main-hand-only: true        # ignore off-hand interactions
cancel-interaction: true    # swallow the click so nothing else fires
send-feedback: true         # message the player on each action

hide-tools:  ["minecraft:shears"]
show-tools:  ["minecraft:brush"]
lock-tools:  ["minecraft:glass_pane", "minecraft:white_stained_glass_pane", ...]

permissions:
  require-permissions: true
  hide:  "invisibleframes.hide"
  show:  "invisibleframes.show"
  lock:  "invisibleframes.lock"

Building

./gradlew build

The Bukkit/Paper jar is produced under bukkit/build/libs/.

License

Licensed under the Mozilla Public License 2.0.