Skip to content

Placeholders

elitescouter edited this page Jun 1, 2025 · 1 revision

Placeholders Guide

Elite Holograms features a powerful built-in placeholder system that allows you to display dynamic information in your holograms. These placeholders are automatically processed and updated in real-time. No external placeholder API is required.

How to Use Placeholders

Simply include the placeholder tag (e.g., %player%) within the text when creating or editing a hologram line. The mod will replace the tag with the corresponding current value.

Example: /eh addline server_stats Players Online: %players%/%maxplayers%

Available Placeholders

Server-Wide Placeholders

These placeholders display the same information to all players viewing the hologram.

  • %players%

    • Description: Shows the current number of players online on the server.
    • Example Output: 15
  • %maxplayers%

    • Description: Shows the maximum player capacity of the server.
    • Example Output: 100
  • %tps%

    • Description: Displays the server's current Ticks Per Second.
    • Example Output: 20.0
  • %uptime%

    • Description: Shows how long the server has been running in HH:MM:SS format.
    • Example Output: 12:34:56 (12 hours, 34 minutes, 56 seconds)
  • %memory%

    • Description: Displays the current server memory usage.
    • Example Output: 1024MB/4096MB (25%)
  • %server_time%

    • Description: Shows the real-world time of the server in HH:MM:SS format (based on server's system time).
    • Example Output: 14:30:00

Player-Specific Placeholders

These placeholders display information tailored to the individual player viewing the hologram.

  • %player%

    • Description: Shows the display name of the player viewing the hologram.
    • Example Output: Steve
  • %player_rank%

    • Description: Displays the player's rank. Integrates with LuckPerms (primary group) and FTB Ranks. Automatically capitalizes the rank name.
    • Fallback: Shows "OP" for operators or "Player" for regular users if no rank system is detected or the player has no specific rank.
    • Example Output: Admin, VIP, Member, OP, Player
  • %player_health%

    • Description: Shows the player's current health out of their maximum health.
    • Example Output: 18.5/20.0
  • %player_level%

    • Description: Displays the player's current experience level.
    • Example Output: 30
  • %player_world%

    • Description: Shows the name of the world the player is currently in (e.g., Overworld, Nether, End, or custom world names).
    • Example Output: world_the_end
  • %player_coords%

    • Description: Displays the player's current X, Y, and Z coordinates, rounded to the nearest whole number.
    • Example Output: X: 100, Y: 64, Z: -250
  • %player_gamemode%

    • Description: Shows the player's current game mode.
    • Example Output: Survival, Creative, Adventure, Spectator

Color Codes & Formatting

You can use standard Minecraft color codes (e.g., &a, &l, &n) in conjunction with placeholders to style your hologram text.

Example: /eh setline welcome 1 &eWelcome, &b&l%player%&e!

This would display the player's name in bold aqua, with yellow text around it.

Clone this wiki locally