SamsCreations
SamsCreations

Holograms & Labels

The floating title above the wheel, and the reward name labels!

1 min readUpdated

Floating Title

Each wheel can show a floating title hologram above it, configured in the editor's Holograms section (appearance.hologram in YAML).

hologram:
  enabled: true
  background: default       # "default", "none", or ARGB hex like "aa000000"
  scale: 1.1
  billboard: FIXED
  lines:
    - "<#FFAA00><bold><name></bold>"
    - "<gray>Right-click to spin"
  • Lines support MiniMessage colours and the <name> placeholder (the wheel's display name).
  • Background -> the vanilla text box, transparent, or a custom ARGB colour.
  • Scale -> overall size of the title.

Title Facing (billboard)

ModeBehaviour
FIXEDFaces the front of the wheel and never turns.
CENTERAlways turns to face whoever is looking.
VERTICALTurns left/right toward the player but stays upright.
HORIZONTALLies flat and turns on the horizontal plane.

Reward Name Labels

Reward names sit just below each item on the wheel. Configure them in Reward Items:

  • Show reward items / names -> toggle the icons and their name labels.
  • Item alignment -> Spin with wheel (rotate with the segment) or Stay upright (stay level as they travel).
  • Item size -> a size multiplier for the reward icons.
  • Name gap -> the distance a name sits below its item (reward-name-distance).
  • Name background -> how the name label's backing looks (reward-name-background): default (vanilla text box), none (transparent/invisible), or an ARGB hex like a0080808

Name Visibility (reward-name-mode)

ModeWhen names show
ALWAYSNames are always visible.
LOOKOnly while a player is looking at the wheel.
ITEMOnly the specific item the player is looking at.

Big Wheels

LOOK and ITEM keep busy wheels clean, names appear on demand instead of crowding the face.