Documentation
DisplayComplete

Holograms

Place floating texts, items and live leaderboards in your worlds, with animations, per player values and click actions.

The holograms module places floating displays in your worlds: welcome texts, spinning items, live leaderboards or clickable buttons that open a menu. You design them in the web editor with a live preview, and place them where a player stands.

Note

This module requires the complete edition. See editions.

Warning

Holograms need Minecraft 1.19.4 or newer on the server.

Features

  • Four kinds of lines, up to 30 per hologram:
    • Text, with colors, pack images and placeholders, and an optional effect: Rainbow, Typing, Blink or Flash.
    • Item, with an animation (Spins, Spins and floats, Floats or Still), a size and a shine. Player heads can show any player, for example the leader of a leaderboard.
    • Leaderboard, showing the top places of a leaderboard, updated live.
    • Space, an empty line to space things out.
  • Templates to start from: Welcome, Leaderboard, Button and Simple text.
  • Personal display. Each player sees their own values (rank, balance, name) in their own language.
  • Click actions. Left or right click on a hologram opens a menu, runs a command, sends a message or sends the player to another server, with an optional sound.
  • Appearance: orientation, text alignment, background color and opacity, text size, shadow, visibility through blocks and particles.
  • Restricted holograms. Show a hologram only to players with a permission.
  • Network wide. Every hologram belongs to one server of your network, and you manage all of them from the same page.

Setting it up

Open Holograms in the web editor and click New hologram. Choose an ID, a template, and where to place it: Where a player stands picks the position of an online player. If nobody is online, the hologram is placed at 0 100 0 and you can move it later with /holo move.

You can also create one in game with /holo create <id> where you stand, then customize it in the web editor.

Lines

Add, remove and reorder lines. For each type:

Line type Options
Text The text and its effect. {player} and PlaceholderAPI placeholders work.
Item The item, an optional pack item, the head owner (player name, UUID or placeholder), the animation, the size and the shine.
Leaderboard The leaderboard and the number of places shown (1 to 20).
Space Nothing, it just adds space.

Appearance

Setting What it does Default
Orientation Facing players follows them, Turns sideways only rotates around the vertical axis, Fixed keeps the direction set when it was placed. Facing players
Text alignment Center, Left or Right. Center
Background Color behind the text. Black
Opacity Opacity of the background. 25 %
Text size Scale of the hologram. 1
Text shadow Adds a shadow under the text. On
Visible through blocks Players see it even behind walls. Off
Particles None, Sparkles, Hearts, Notes, Flames, Portal or Enchant. None

On click

Setting What it does
Action Nothing, Open a menu, Command run by the player, Command run by the console, Send a message or Send to a server.
Sound Sound played on click, for example ui.button.click.

Who sees it

Setting What it does Default
Personal display Each player sees their own values in their own language. Off
Permission Only players with this permission see it. Empty: everyone. Empty
View distance Distance in blocks from which the hologram is visible. 48 blocks
Refresh every (seconds) How often placeholders and leaderboards are refreshed. 5

Position

Change the world and coordinates, or use Move to a player to put the hologram where an online player stands, facing them. Y is the bottom of the hologram.

General settings

Setting What it does Default
Animations Smooth looks better, Normal is lighter for big servers, Off stops the animations. Smooth

Commands

All hologram commands need inglis.holograms.admin, given to operators by default.

Command What it does
/holo create <id> Creates a hologram where you stand.
/holo move <id> Moves a hologram where you stand.
/holo remove <id> Deletes a hologram.
/holo tp <id> Teleports you to a hologram on the server you are on.
/holo addline <id> <text> Adds a text line.
/holo setline <id> <line> <text> Replaces the text of a line, keeping its effect.
/holo removeline <id> <line> Removes a line.
/holo near Shows the nearest hologram within 20 blocks.
/holo list Lists all holograms with their server, world and position.

/hologram and /holograms are aliases of /holo.

Tips

  • To show the head of the richest player above a leaderboard, set the item head owner to %ingliscore_top_money_1_uuid%.
  • A hologram with the Open a menu click action makes a simple clickable button for your lobby. See menus.
  • Turn on Personal display when a hologram contains player placeholders such as balance or rank, otherwise every player sees the same values.