HologramMod

HologramMod — Text, Block, Item & Leaderboard Holograms

HologramMod is a server-side Fabric mod for placing floating text, blocks, items and live leaderboards anywhere in your world, all built and edited in-game. Every hologram supports rich colours, hex codes, hover text, click events, atlas sprites, player heads and per-player placeholders, and can be made clickable so a click runs a command. Everything is stored in YAML, saved automatically by the commands, and reloads without a restart. Players don't need to install anything.

Built as a companion to ChatMod. Sprite aliases from ChatMod's sprites.yml work directly in hologram lines, so you can drop any atlas icon into your text with [#spriteName].

✨ Why HologramMod

• Four hologram types: text, block, item and live scoreboard leaderboards
• Clickable holograms: run any command as the player or as the console when a hologram is clicked
• No duplicates: holograms are never saved into the world, so no extra copy can load back in when a chunk loads. Holograms in unloaded chunks are left alone until their chunk loads.
• Lightweight: text only re-sends when it actually changes, only the lines that changed are updated, and holograms aren't re-sent to players on a timer
• Per-player text: one entity shows a personalised line to every player (%player%, health, coordinates …)
• Immune to /kill, and can't be broken by players
• Full in-game editing: every command saves to YAML instantly

Formatting — Used on Every Line

| Syntax | Result |

|---|---|

| &a, &b, &c … | Minecraft colour codes |

| RRGGBB | Hex colour codes |

| &l &o &n &m &k &r | Bold, italic, underline, strikethrough, obfuscated, reset |

| Text{Hover text} | Hoverable text with a tooltip |

| Text | Click to run a command |

| Text | Click to suggest a command |

| Text | Click to open a URL |

| Text | Click to copy text |

| [#spriteName] | Atlas sprite icon (item, block or ChatMod alias) |

| [#@Name] | Player head + name |

| [##@Name] | Player head only |

| [@Name] | Player name only |

| [#@%player%] | Head of the player looking at the hologram |

| %newline% | Line break inside one line |

📝 Text Holograms — /holo

Floating text with per-line formatting. Lines stack from the top down and grow with the hologram's scale.

holograms:
  spawn_welcome:
    world: "minecraft:overworld"
    x: 0.5
    y: 65.0
    z: 0.5
    scale: 1.2
    billboard: CENTER
    shadow: true
    pages:
      default:
        - "&#FF5500&lWelcome, %player%!"
        - "[#christmas_chest] &7Seasonal crates are open"
        - "&a[ Click to teleport ]{&7Takes you to spawn}<action:run_command,/spawn>"

Appearance: billboard (CENTER / FIXED / HORIZONTAL / VERTICAL), scale (up to 200), brightness (0–15), see_through, shadow, line_width, opacity, bg_color, view_range_blocks, rotation_yaw / rotation_pitch / rotation_roll

🔄 Multi-Page Animation

Text holograms can have several pages that cycle automatically, which is useful for rotating announcements or animated signs.

| Command | What it does |

|---|---|

| /holo addpage | Adds a new page (a, b, c …) |

| /holo addline a | Adds a line to page a |

| /holo addline @ | Adds a line to every page |

| /holo setline 2a | Edits line 2 of page a (2@ = every page) |

| /holo animate true | Starts cycling |

| /holo timer 3 | Seconds per page (decimals allowed) |

| /holo freeze | Pins one page / resumes cycling |

Pages with the same number of lines switch smoothly, without any flicker.

👤 Placeholders

Lines with player placeholders are resolved separately for each player, so one hologram shows each viewer their own name and stats. Server placeholders refresh automatically every placeholder_refresh_ms (default 1 s), and only when the value actually changed.

| Placeholder | Value |

|---|---|

| %player% %player_display% | Player name / display name |

| %player_health% %player_max_health% %player_food% | Health and hunger |

| %player_level% %player_xp% | XP level / progress % |

| %player_x% %player_y% %player_z% | Coordinates |

| %player_world% %player_biome% | Dimension / biome |

| %player_ping% %player_gamemode% | Ping / game mode |

| %online% %max_players% %player_list% | Players online |

| %tps% %mspt% | Server performance |

| %ram_used% %ram_max% %ram_percent% | JVM memory |

| %time% %time_seconds% %date% %day% %month% %year% | Real-world time and date |

| %world_time% %world_day% | In-game time and day |

| %overworld_weather% | Clear / Rain / Thunder |

Placeholder API placeholders (e.g. %player:name%) also work in every hologram when it is installed.

🖱️ Clickable Holograms — All Types

Any hologram (/holo, /holoblock, /holoitem, /holoscore) can run a command when a player left- or right-clicks it. This works just like a clickable chat link, but in the world.

| Command | What it does |

|---|---|

| / interact | Turns clicking on or off (off by default) |

| / interact | Runs the command as the player who clicked |

| / interactcon | Runs the command as the console |

| / interactsize | Sets the click area size yourself (0 0 = automatic) |

• Placeholders are filled in for the player who clicked: interactcon give %player% diamond
• Text holograms with FIXED or HORIZONTAL billboard get a flat click area that exactly matches the text. Holograms that turn to face the player get a tight box around the text.
• Block and item displays get a click box that fits the model, including rotation, translation and both halves of double blocks
• The click area grows with the hologram's scale and follows page changes automatically

🧱 Block Display Holograms — /holoblock

Floating blocks with full block-state support, rotation and translation.

block_displays:
  my_block:
    world: "minecraft:overworld"
    x: 0.5
    y: 65.0
    z: 0.5
    block_state: "minecraft:stone_slab[type=top]"
    billboard: FIXED
    scale: 0.5
    rotation_yaw: 45.0

Double blocks are detected automatically: beds, doors and tall plants spawn both halves in the right place, so you only need the base block ID. To show a single half, add part= or half= to the block state.

🗡️ Item Display Holograms — /holoitem

Floating items with a configurable display context, rotation and translation.

item_displays:
  floating_sword:
    world: "minecraft:overworld"
    x: 0.5
    y: 65.0
    z: 0.5
    item: "minecraft:diamond_sword"
    display_context: FIXED
    billboard: CENTER
    scale: 1.0

Display contexts: FIXED, GROUND, GUI, HEAD, NONE, THIRD_PERSON_LEFT_HAND, THIRD_PERSON_RIGHT_HAND, FIRST_PERSON_LEFT_HAND, FIRST_PERSON_RIGHT_HAND

📊 Scoreboard Holograms — /holoscore

Live leaderboards that update the moment the data changes.

| Source | What it shows |

|---|---|

| scoreboard | Any vanilla scoreboard objective, sorted by score |

| ecobal | Top player balances from the EcoBal economy mod |

| votes | Total server votes with automatic goal milestones |

score_holograms:
  top_kills:
    world: "minecraft:overworld"
    x: 100.5
    y: 65.0
    z: 200.5
    source_type: scoreboard
    scoreboard: kills
    update_mode: scoreboard
    lines:
      - "&6&lTop Kills"
      - "&e#%rank% [#@%player%] &7— &a%score%"
      - "&e#%rank% [#@%player%] &7— &a%score%"
      - "&e#%rank% [#@%player%] &7— &a%score%"

Leaderboard placeholders: %scoreboardname%, %rank%, %player%, %displayname%, %score%, %balance%, %total_votes%, %vote_goal%, %votes_until_goal%

• Every line with a player placeholder shows the next ranked player; empty ranks stay blank
• Pagination: /holoscore newpage creates a second board that continues the ranking where the first one ends
• Update modes: scoreboard (updates when the ranking or scores change) or timed (updates every updateinterval seconds)
• Only lines whose value changed are updated, so the board never flickers or respawns

Commands

All commands save to their YAML file instantly. /hologram and /holo are the same command.

Text Holograms /holo

| Command | Description |

|---|---|

| /holo create | Create at your position |

| /holo remove | Delete permanently |

| /holo list | List all text holograms |

| /holo info | Show all settings and lines |

| /holo inforaw | Raw lines, click a line to edit it |

| /holo tp [player] | Teleport yourself or another player |

| /holo move | Move to your position |

| /holo moveto | Move to exact coordinates |

| /holo addline [page\|@] | Add a line |

| /holo setline [page\|@] | Edit a line |

| /holo removeline [page\|@] | Remove a line |

| /holo addpage / removepage | Manage animation pages |

| /holo animate | Toggle page cycling |

| /holo timer | Time per page |

| /holo freeze | Pin a page |

| /holo scale\|billboard\|brightness\|seethrough\|shadow\|linewidth\|opacity\|background\|viewrange | Appearance |

| /holo interact\|interactcon\|interactsize … | Click actions |

| /holo reload | Reload all hologram types and messages |

Block Displays /holoblock

create [block], remove, list, info, inforaw, tp [player], move, moveto, block , scale, billboard, brightness, viewrange, translate , rotate , interact, interactcon, interactsize, reload

Item Displays /holoitem

create [item], remove, list, info, inforaw, tp [player], move, moveto, item , context , scale, billboard, brightness, viewrange, translate , rotate , interact, interactcon, interactsize, reload

Scoreboard Holograms /holoscore

create scoreboard , create ecobal [label], create votes [holder], remove, list, info, inforaw, tp [player], newpage, move, moveto, addline, setline, removeline, updatemode , updateinterval , votesholder , voteinterval , scale, billboard, brightness, seethrough, shadow, linewidth, opacity, background, viewrange, interact, interactcon, interactsize, reload

Permissions

⚙️ Configuration

All files live in config/hologrammod/. Edit them freely, then run /holo reload; no restart is needed.

| File | Contains |

|---|---|

| hologramtext.yml | Text holograms |

| hologramblock.yml | Block displays |

| hologramitem.yml | Item displays |

| hologramscores.yml | Scoreboard holograms |

| messages_format.yml | All player-facing messages |

Dependencies

| Mod | Required? |

|---|---|

| Fabric API | ✅ Required |

| ChatMod | ⭐ Recommended, for shared sprite aliases |

| LuckPerms / Fabric Permissions API | 🔶 Optional, for permission nodes |

| Placeholder API | 🔶 Optional, for extra placeholders |

| EcoBal | 🔶 Optional, for ecobal leaderboards |

Modpack Policy

• ✅ You may include HologramMod in any modpack.
• ❌ The modpack must not be sold.