HologramMod — Text, Block & Item Display Holograms with Full In-Game Editing

Built as a companion to ChatMod. Sprite aliases from ChatMod's sprites.yml work directly inside hologram lines — drop an atlas icon anywhere in your text with [#spriteName].

---

What It Does

HologramMod lets you place floating text, block, and item displays anywhere in your world — all managed through YAML config files and in-game commands that save back to disk automatically. No restarts needed. Everything supports rich colour codes, hex colours, click events, hover text, and atlas sprites.

---

Features

📝 Text Holograms — /hologram

Floating text displays with per-line formatting. Full ChatMod syntax supported on every line.

holograms:
  spawn_welcome:
    world: "minecraft:overworld"
    x: 0.5
    y: 65.0
    z: 0.5
    scale: 1.2
    billboard: CENTER
    brightness: 15
    shadow: true
    lines:
      - "&#FF5500&lWelcome to the Server!"
      - "[#christmas_chest] &7Seasonal crates are open"
      - "<action:run_command,/spawn>&a[ Click to teleport ]"

Line syntax:

• &a, &b … &r — legacy colour and format codes
• &#RRGGBB — hex colour
• [#spriteName] — atlas sprite from ChatMod's sprites.yml
• {hover text} — hover event on the preceding segment
• <action:run_command,/cmd> — click event on the preceding segment

Appearance settings: billboard (CENTER / FIXED / HORIZONTAL / VERTICAL), scale, brightness (0–15), see_through, shadow, line_width, opacity, bg_color, view_range_blocks

---

🔄 Multi-Page Animation

Any text hologram supports multiple pages that cycle automatically on a configurable interval. Useful for rotating announcements or animated signs.

animate: true
animate_interval_ms: 3000
pages:
  default:
    - "&aPage one"
  a:
    - "&bPage two"
  b:
    - "&cPage three"

Use /hologram <name> freeze <page> to pin a specific page, or /hologram <name> freeze off to resume cycling.

---

👤 Per-Player Placeholder Lines

Any line containing %player% or other player-specific tokens is resolved individually for each player — one entity, personalised text per viewer, no per-player entity duplication.

Built-in placeholders:

Placeholder	Value
%player%	Player's username
%player_health%	Current health
%player_level%	XP level
%player_x/y/z%	Coordinates
%player_ping%	Connection latency
%player_gamemode%	Game mode
%player_biome%	Current biome
%online%	Online player count
%tps%	Server TPS
%mspt%	Milliseconds per tick
%time% / %date%	Real-world time and date
%ram_used% / %ram_percent%	JVM memory
%overworld_weather%	Clear / Rain / Thunder

Placeholder API placeholders are also resolved automatically when the mod is installed.

---

🧱 Block Display Holograms — /holoblock

Spawn floating block displays with full block-state support, including rotation and translation offsets.

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-block auto-detection: Beds, doors, and tall plants are automatically split into two correctly-offset display entities. Specify just the base block ID — HologramMod handles both halves.

---

🗡️ Item Display Holograms — /holoitem

Spawn floating item displays with configurable display context, controlling exactly how the item model is oriented.

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, THIRD_PERSON_LEFT_HAND, THIRD_PERSON_RIGHT_HAND, FIRST_PERSON_LEFT_HAND, FIRST_PERSON_RIGHT_HAND

---

📊 Scoreboard Holograms — /holoscore

Live leaderboard displays that update automatically when scores change. Three data sources supported:

Source	What it shows
scoreboard	Any vanilla scoreboard objective, sorted by score
ecobal	Top player balances from EcoBal economy mod
votes	Total vote count with configurable 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% &f%displayname% &7— &a%score%"

Pagination: Use /holoscore <name> newpage to chain a second hologram that continues from where the first left off.

Update modes: scoreboard (fires when top-N changes) or timed (fires every update_interval_ms milliseconds).

---

In-Game Commands

All commands save back to their respective YAML files automatically.

Text Holograms /hologram /holo

Command	Description
/hologram create <name>	Create at your position
/hologram remove <name>	Delete permanently
/hologram list	List all holograms
/hologram info <name>	Show settings
/hologram tp <name>	Teleport to a hologram
/hologram move <name>	Move to your position
/hologram addline <name> <text>	Append a line
/hologram setline <name> <index> <text>	Edit a line
/hologram removeline <name> <index>	Delete a line
/hologram set <name> <setting> <value>	Change any appearance setting
/hologram rotate <name> <yaw>	Set horizontal rotation
/hologram addpage <name>	Add an animation page
/hologram freeze <name> <page|off>	Pin or unpin a page
/hologram reload	Reload all configs

Block Displays /holoblock

create, remove, list, move, block, set, rotate — same pattern as /hologram.

Item Displays /holoitem

create, remove, list, move, item, context, set, rotate — same pattern as /hologram.

Scoreboard Holograms /holoscore

create <name> <type> <objective>, remove, list, move, set, newpage, reload.

---

Permissions

Permission	Grants
hologrammod.command	Base /hologram command access
hologrammod.create	/hologram create
hologrammod.remove	/hologram remove
hologrammod.reload	/hologram reload
hologrammod.edit	All editing subcommands
hologrammod.*	All permissions

Works with LuckPerms and Fabric Permissions API.

---

Configuration Files

All files live under config/hologrammod/. Use /hologram reload after any edit — no restart required.

File	Contains
hologramtext.yml	Text hologram database
hologramblock.yml	Block display database
hologramitem.yml	Item display database
hologramscores.yml	Scoreboard hologram database
messages_format.yml	All player-facing system strings

---

Dependencies

Mod	Required?
Fabric API	✅ Required
LuckPerms	🔶 Optional — for permission-based command access
Fabric Permissions API	🔶 Optional — for permission nodes
ChatMod	⭐ Strongly recommended — enables sprites and full rich-text syntax
Placeholder API	🔶 Optional — enables PAPI placeholders in hologram lines

---

Modpack Policy: ✅ Free to include in any modpack. ❌ The modpack must not be sold.