Hologram File

On this page, you will find the format of a hologram file, for editing it by hand.

Everything on this page can be set from the in-game editor. The files are only worth opening for a bulk change, or to copy holograms between servers. Run /pholo reload after saving them.

#Where the Files Are

Each hologram is one file in the holograms folder, named after its id. Renaming the file renames the hologram.

#Example

display-name: '&aLobby'
enabled: true
group: spawn
location:
  world: world
  x: 0.5
  y: 66.0
  z: 0.5
  yaw: 0.0
  pitch: 0.0
appearance:
  billboard: CENTER
  scale: 1.0
  background: transparent
visibility:
  mode: ALL
  distance: 48
update-interval: 20
page-interval: 0
click:
  permission: ''
  cooldown: 250
  actions:
    left:
    - '[PAGE] previous'
    right:
    - '[PAGE] next'
    any: []
pages:
- lines:
  - type: TEXT
    text: '{anim:rainbow}'
  - type: TEXT
    text: '&7Welcome, %player%'
  - type: ITEM
    item: DIAMOND
    spin: 90.0
- lines:
  - type: TEXT
    text: '&ePage %page% of %pages%'

#Keys

Key	Description
display-name, icon, enabled, location	The hologram itself. See Edit Hologram.
group	See Groups.
appearance	See Appearance.
attachment	See Attachments.
leaderboard	Only on leaderboards. See Leaderboards.
visibility	The mode (`ALL`, `PERMISSION` or `MANUAL`), distance, permission and the UUIDs added with `/pholo show`. See Visibility.
update-interval, page-interval	See Visibility.
click	The click permission, cooldown and the `left`, `right` and `any` action lists. See Click Actions.
pages	Each page's lines, top to bottom.

#Line Keys

Key	Lines	Description
type	All	`TEXT`, `ITEM` or `BLOCK`.
text	Text	The text.
item	Item	A material or a custom item id such as `nexo:ruby`.
item-stack	Item	A full item, used when the item is not from a supported plugin.
transform	Item	How the item is drawn, such as `FIXED`, `GROUND` or `HEAD`.
block	Block	The block.
spin, bob, glow, glow-color	Item, Block	See Edit Line.
scale, height	All	See Edit Line.
actions	All	The line's own `left`, `right` and `any` lists.
conditions	All	Each condition's `type`, `input` and `value`. See Line Conditions.

Anything left out of a line takes its default.

Last updated about 2 hours ago