Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Invisible Item Frame
Paper plugin for Minecraft Java 26.3 that allows you to craft invisible item frames already available in the game.
Requirements
- Paper 26.3 (tested on build 249)
- Java 25 (required by Paper 26.3)
Crafting
Place the following items in a crafting table (or in the 2x2 crafting grid in your inventory):
- 1 regular item frame
- 1 invisibility potion of any type
The recipe is shapeless, meaning the two ingredients can be placed in any position.
Accepted potions:
- Invisibility Potions (regular and extended)
- Splash and Lingering variants
- Potions with custom effects that include the Invisibility effect
Glow Item Frames are not supported: they are a different item and are not accepted by the recipe.
The result is an item frame that becomes invisible when placed, exactly like the one obtainable using vanilla commands. The crafted item is named "Invisible Item Frame" and has a purple enchantment glint to distinguish it from a regular item frame.
Installation
-
Build the plugin:
mvn clean package -
Copy
target/InvisibleItemFrame-1.0.0.jarinto your server'splugins/folder. -
Restart the server.
No commands, permissions, or configuration are required.
How It Works
The plugin registers a shapeless recipe with:
- A regular item frame as an ingredient.
- A predicate-based choice that accepts any invisibility potion (regular, splash, lingering, or with custom effects).
The result is created using the vanilla minecraft:entity_data component (Invisible: 1b), the same component used by the game for invisible item frames.
Additionally, a persistent safety marker is added. If the component is lost (for example, because another plugin serializes and recreates the item), the plugin still makes the frame invisible when it is placed.
If a future version of Paper changes the internal names and the component can no longer be set, this fallback becomes the only mechanism, allowing the plugin to continue working.
When you break an invisible item frame (or one placed using this plugin), the plugin prevents the vanilla drop and directly drops the custom "Invisible Item Frame" item, preserving its name, purple glint, and invisibility data. This means you can pick it up and place it again as many times as you want.
If there was an item inside the frame, that item will also be dropped.


