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

📝 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.

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 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.

• 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.

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 <name> 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

Block Displays /holoblock

create <name> [block], remove, list, info, <name> inforaw, tp <name> [player], <name> move, moveto, block <state>, scale, billboard, brightness, viewrange, translate <x> <y> <z>, rotate <yaw> <pitch> <roll>, interact, interactcon, interactsize, reload

Item Displays /holoitem

create <name> [item], remove, list, info, <name> inforaw, tp <name> [player], <name> move, moveto, item <id>, context <context>, scale, billboard, brightness, viewrange, translate <x> <y> <z>, rotate <yaw> <pitch> <roll>, interact, interactcon, interactsize, reload

Scoreboard Holograms /holoscore

create <name> scoreboard <objective>, create <name> ecobal [label], create <name> votes <objective> [holder], remove, list, <name> info, <name> inforaw, tp <name> [player], <name> newpage, move, moveto, addline, setline, removeline, updatemode <scoreboard|timed>, updateinterval <seconds>, votesholder <name>, voteinterval <n>, 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.

Dependencies

Modpack Policy

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