Holograms

Holograms is a powerful Minecraft server plugin for Folia and Paper that allows you to create and manage fully customizable holograms. Display text, blocks, items, entities, images, and animated content with support for click actions, visibility control, and persistence.

Features

Line Types

Text Lines: Display formatted text with customizable width, alignment, shadow, and background
Block Lines: Display any block type as a hologram line
Item Lines: Display items and player heads with configurable display transforms
Entity Lines: Display entity models with adjustable scale and offset
Paged Lines: Cycle through multiple pages of content with configurable intervals

Click Actions

Commands: Run commands as the player or console on click
Messages: Send chat messages, actionbar messages, or titles
Teleportation: Teleport or transfer players to other locations or servers
Sounds: Play sounds on interaction
Page Control: Cycle or set pages on paged hologram lines

Visibility Control

Permissions: Restrict hologram visibility with custom permissions
Default Visibility: Toggle whether holograms are visible by default
Individual Viewers: Add or remove specific players as viewers

Image Support

Static Images: Render images as text-based hologram lines
Animated GIFs: Display animated GIFs as paged hologram lines

Persistence

Persistent Holograms: Mark holograms as persistent to survive server restarts
Automatic Loading: Persistent holograms are automatically loaded on startup

Quick Start

Basic Usage

The main command of Holograms is /hologram, and requires the permission holograms.command.<subcommand>:

# Create a hologram at your location
/hologram create my-hologram

# Add a text line
/hologram line add my-hologram text Hello World!

# Add a block line
/hologram line add my-hologram block diamond_block

# Add an item line
/hologram line add my-hologram item diamond_sword

# Add an empty paged line
/hologram line add my-hologram paged

# List all holograms
/hologram list

# Teleport to a hologram
/hologram teleport my-hologram

# Delete a hologram
/hologram delete my-hologram

Common Scenarios

Text Hologram

Create a hologram with multiple text lines:

# Create the hologram
/hologram create welcome

# Add text lines
/hologram line add welcome text Welcome to the Server!
/hologram line add welcome text Enjoy your stay

Item Hologram

Create a hologram displaying an item:

# Create the hologram
/hologram create shop-item

# Add an item line
/hologram line add shop-item item diamond_sword

# Add a label below
/hologram line add shop-item text Legendary Sword - 500 Coins

Paged Hologram

Create a hologram with rotating content:

# Create the hologram
/hologram create announcements

# Add a paged line
/hologram line add announcements paged

# Add pages to line 1
/hologram page add announcements 1 text Server Rules
/hologram page add announcements 1 text Upcoming Events
/hologram page add announcements 1 text Latest News

Permission System

Command Permissions

Holograms uses fine-grained permissions following the pattern:

holograms.command.create - Create holograms
holograms.command.delete - Delete holograms
holograms.command.list - List holograms
holograms.command.rename - Rename holograms
holograms.command.teleport - Teleport to or move holograms
holograms.command.view-permission - Set hologram view permissions
holograms.command.translation - Manage translations
holograms.command.line - Manage hologram lines
holograms.command.page - Manage paged lines
holograms.command.action.add - Add click actions

Overview