Голограммы

Команды 1#

/hologram create spawn_welcome
/hologram addline spawn_welcome &6&lДобро пожаловать
/hologram addline spawn_welcome &7Онлайн: &f{neoessentials_online_players}/{neoessentials_max_players}
/hologram setrefresh spawn_welcome 10
/hologram scale spawn_welcome 1.3
/hologram hover spawn_welcome on 0.1 1.2
/hologram info spawn_welcome

/hologram list
/hologram setline crate_vote 1 &6Vote Crate
/hologram setline crate_vote 2 &eПКМ — открыть, ЛКМ — шансы
/hologram scale crate_vote 1.3

/hologram copy spawn_welcome portal_welcome
/hologram movehere portal_welcome
/hologram billboard portal_welcome fixed
/hologram spin portal_welcome on 3 Y
/hologram spintrack portal_welcome on

/hologram reload

Подробное руководство#

NeoEssentials uses Minecraft's native Display.TextDisplay entities to render holographic floating text in the world.
Holograms are fully server-side — no client mod required.

Storage#

Hologram data lives in the active storage backend (holograms collection — JSON files by default, or SQLite/MySQL if configured), loaded automatically on server start / world load. The legacy neoessentials/holograms.json file is only read once, to migrate any existing data into the storage backend on first boot after upgrading — it's not written to afterward.
Shop-managed holograms (prefixed shop_) are created and destroyed automatically by the Shop system — see Shop Holograms below.

Permissions#

Command Reference#

All commands use /hologram (alias /holo).

Creation & Deletion#

Line Management#

Line numbers are 1-based (1 = topmost) in every command below.

Frame Animation (per-line)#

Lines can cycle through multiple text frames automatically.

Example:

/hologram addframes welcome 1 10 &aWelcome!|&eHello!|&bHi there!

This cycles the top line (line 1) every 10 ticks (0.5 s) through three coloured greetings.

Positioning#

Visibility & Refresh#

setrefresh's seconds value is a per-hologram minimum — how often that specific hologram checks for updates is also capped by the global scheduler's own poll rate, set once for every hologram via hologram.pollIntervalTicks/animationInterval in config.json (both in server ticks; defaults 20/1, matching the previous fixed 1-second/50ms behavior). pollIntervalTicks only controls how often the scheduler checks whether a hologram is due for a refresh — it is not itself the refresh rate, and lowering it below your setrefresh seconds value does nothing visible; animationInterval covers only {animation:NAME} frame advancement, /hologram addframes cycling, and spin/hover motion — there's no benefit setting it below 1, since an animation's own frame duration is already clamped to a 50ms (1-tick) minimum. Apply changes with /neoe reload.

Billboard Mode#

Controls how the hologram faces the viewer.

Text Alignment#

Animations#

Spin

Tip: Y-axis spin with fixed billboard = classic record-player spin.
Z-axis spin with center billboard = roll-spin visible to all players.

Player-tracking (Y-axis only, default on): instead of a raw world-space spin, the renderer switches the billboard to FIXED and computes the yaw as yaw_to_nearest_player + currentSpinAngle, so the "front" of the text sweeps past every player once per revolution rather than only being readable from one fixed direction. Disable with /hologram spintrack <id> off to fall back to a raw Y-axis rotation (only useful if you also set billboard to fixed manually).

Hover / Bob

Visual Appearance#

Background examples:

/hologram background lobby transparent         ← fully transparent (default)
/hologram background lobby #40000000           ← 25% black semi-transparent panel
/hologram background lobby #000000             ← opaque solid black

Placeholders#

Hologram line text supports the full NeoEssentials placeholder syntax {identifier}.

Common useful placeholders:

Set refreshInterval > 0 on the hologram to keep placeholder values up-to-date.

Leaderboard Boards#

Any registered leaderboard board's rank/name/value is also available: {leaderboard_<board>:<rank>:name} / {leaderboard_<board>:<rank>:value}, e.g. {leaderboard_money:1:name}. Rather than typing each /hologram addline by hand, /leaderboard hologram create <board> <id> [lines] generates a full ranked hologram in one command — see Leaderboard System → Holograms.

Colour Codes#

Use & colour codes in line text:

Hex colour via &#RRGGBB is also supported.

Example Hologram Setup#

# Step 1 — create at eye level above a spawn platform
/hologram create spawn-welcome 0 70 0 minecraft:overworld

# Step 2 — add lines (top to bottom)
/hologram addline spawn-welcome &6&lWelcome to &eMyServer!
/hologram addline spawn-welcome &7Online: &f{neoessentials_online_players}/{neoessentials_max_players}
/hologram addline spawn-welcome &7&oRight-click a sign to explore

# Step 3 — refresh every 10 s so player counts stay current
/hologram setrefresh spawn-welcome 10

# Step 4 — increase size slightly and enable gentle hover
/hologram scale spawn-welcome 1.3
/hologram hover spawn-welcome on 0.1 1.2

# Step 5 — inspect the result
/hologram info spawn-welcome

holograms.json Format (Advanced)#

Fields stored per hologram:

{
  "id": "spawn-welcome",
  "world": "minecraft:overworld",
  "x": 0.0, "y": 70.0, "z": 0.0,
  "visible": true,
  "refreshInterval": 10,
  "interactive": false,
  "scale": 1.3,
  "lineSpacing": 0.3,
  "textShadow": false,
  "textOpacity": 255,
  "backgroundColorArgb": 0,
  "textAlign": 0,
  "seeThrough": false,
  "lineWidth": 200,
  "viewRange": 1.0,
  "billboardMode": 3,
  "spinEnabled": false,
  "spinSpeedDegrees": 3.0,
  "spinAxis": "Y",
  "spinTrackPlayer": true,
  "hoverEnabled": true,
  "hoverAmplitude": 0.1,
  "hoverSpeedDegrees": 1.2,
  "lines": [
    { "text": "&6&lWelcome to &eMyServer!", "frames": [], "animFrameIntervalTicks": 0 },
    { "text": "&7Online: &f{neoessentials_online_players}/{neoessentials_max_players}", "frames": [], "animFrameIntervalTicks": 0 }
  ]
}

billboardMode values: 0=FIXED, 1=VERTICAL, 2=HORIZONTAL, 3=CENTER.
textAlign values: 0=CENTER, 1=LEFT, 2=RIGHT.
backgroundColorArgb is an ARGB integer. 0 = fully transparent.
textOpacity: 0–255, 255 = fully opaque.
interactive: when true, right/left-clicking the hologram fires click events (used by shop holograms — see below). Regular admin-created holograms leave this false.

Shop Holograms#

When a sign shop enables its hologram (via the shop hologram toggle — see Economy System), NeoEssentials auto-creates an interactive hologram named shop_<dimension>_<x>_<y>_<z> above the sign showing the item, owner, and buy/sell prices. This hologram is refreshed automatically on every transaction and behaves as a second click-target for the shop:

Clicks are rate-limited to one processed interaction per player every 400 ms to prevent held-down attack-spam from firing repeated transactions.
Shop holograms can be repositioned relative to their sign (up to ±4.5 blocks per axis) via the shop's hologram-offset controls; admin /hologram commands can still be used to inspect them (/hologram info shop_...), but manual edits to their lines/position are overwritten the next time the shop transacts or reloads.

Web Dashboard API#

The dashboard exposes a REST API for hologram management:

All responses include billboard, spin, hover, scale, lineSpacing, textShadow, textOpacity, and backgroundColorArgb fields.