Ghost Frames

Ghost Frames turns item frames into configurable ghost displays. Players can hide frames, click through them into containers, lock rotation, protect displayed items, and manage everything through a compact in-game GUI or admin commands.

Features

• Four frame modes: NORMAL, GHOST, LOCKED, PROTECTED
• Click-through access for containers behind invisible frames
• Item protection to prevent rotating or taking the displayed item
• Shift + Right Click GUI with preview and quick toggles
• Bulk admin tools for chunk, radius, and world scopes
• Audit logging to console and plugins/GhostFrames/audit.log
• Localized messages with en and ru language files
• Persistent settings stored in PersistentDataContainer

Commands

• /ghostframes reload
• /ghostframes info
• /ghostframes scan <chunk|radius|world> [radius/world]
• /ghostframes applyall <chunk|radius|world> <mode> [radius/world]
• /ghostframes setmode <mode>
• /ghostframes inspect
• /ghostframes reset

Permissions

• ghostframes.use - Use the GUI and click-through frames
• ghostframes.admin - Use admin commands and bulk actions
• ghostframes.bypass - Bypass protected frame restrictions

Compatibility

• Minecraft: 1.18 to 1.21.x
• Platforms: Bukkit, Spigot, Paper, Folia
• Java: 17

Installation

1. Download the latest .jar file.
2. Place it into your server plugins folder.
3. Start or restart the server.

Usage

1. Place an item frame on a chest, barrel, or other container.
2. Shift + Right Click the frame to open the Ghost Frames GUI.
3. Switch the frame to GHOST, LOCKED, or PROTECTED.
4. Adjust click-through, item protection, and rotation lock as needed.