Configuration

config.yml

# Ticks between checks of placeholder triggers and visibility conditions.
# Each check fills in the placeholders once per viewer per condition, so
# keep it above 1 on busy servers.
placeholder-interval: 10

web:
  # Where the web editor stores holograms between the server and your browser.
  # The public one works; to keep your holograms off it, run your own:
  # docker run -p 3000:8080 ghcr.io/lucko/bytebin
  bytebin: "https://bytebin.lucko.me"

Run /hbb reload after changing it.

messages.yml

Every message HologramBB sends is in messages.yml, written in MiniMessage. Change colours, words or language freely. When an update adds new messages, they are added to your file on start, without touching what you changed.

Hologram settings

Each hologram has its own settings. In the web editor: Menu → Hologram settings. With commands: /hbb set <id> <key> <value>.

Setting	Key	Default	What it does
Id			Its name and file name. A new id makes a new hologram when applied.
View distance	view-distance	48	How far away (in blocks) players see it.
Look radius	look-radius	1.0	How close to its centre a player must aim for "looked at".
Refresh	update-interval	20	Ticks between placeholder refreshes in its text; 0 for never.
Click box	hitbox	sized to the layers	[width, height] of the box that takes clicks. Only made when something reacts to clicks.
Permission	visibility.permission	none	Only players with it see it.
Condition	visibility.condition	none	Only players for whom it is true see it.
Hidden until shown	visibility.manual	false	Nobody sees it until /hbb show.
Location	location		Set with /hbb movehere. The server keeps its own when you apply from the web.

Files

plugins/HologramBB/
├── config.yml
├── messages.yml
├── clips.yml          optional: animations shared by every hologram
└── holograms/
    └── <id>.yml       one file per hologram