Introduction
What ExyliaDisplays is, what it puts in the world, and how this documentation is organised.
ExyliaDisplays puts holograms and NPCs in the world of a Paper or Folia server, and gives both the same click system. It is free and open source, published under the GNU General Public License v3.0 on Modrinth.
Everything it shows is packets, drawn by ExyliaLib: nothing is a real entity, nothing is saved in the chunks, and nothing ticks on the server. A hologram or an NPC exists for whoever is close enough to see it and costs nothing when nobody is.
Each one can be edited three ways that always agree: screens and dialog windows in game, /holo and
/npc commands, or holograms.yml and npcs.yml by hand, which are applied the moment you save them.
It used to be called ExyliaHolograms. A server coming from it keeps its holograms and its permission; see Migration.
What is included
Text lines, floating items, blocks and player heads in one stack, each line with its own size, motion and colour effects.
Line tags<size:2>, <spin>, <shine>, <typewriter>, and lines only some players see: <range:8>,
<perm:vip>, <if:"%player_level% >= 10">.
A hologram with several pages, where every player reads their own and turns it with a click or on a timer.
NPCsPlayer NPCs with a skin (or each viewer's own), a pose, a size, an outline, equipment, a label and a head that turns toward each viewer.
InteractionsOne set of click lines for both: commands, [SERVER], [TELEPORT], [MESSAGE], and NPC speech
bubbles with [SAY].
DecentHolograms, HolographicDisplays, FancyHolograms, Citizens and FancyNpcs, read without touching their files.
Requirements
| Requirement | Detail |
|---|---|
| Server | Paper or Folia 1.21.4 or newer |
| Java | 21 |
| Required | packetevents, and ExyliaLib 1.299.0 or newer (the 2.4.0 jar) — installed automatically when missing |
| Optional | PlaceholderAPI, whose placeholders work in every line and every action |
| Clients | Dialog windows need a 1.21.6+ client; older clients and Bedrock players get the same fields through chat or forms |
The holograms, the NPCs, the line tags, the click lines, the screens and the dialog windows all come from ExyliaLib. ExyliaDisplays is what keeps them in files, edits them and gives them commands; every Exylia plugin that shows a hologram draws it the same way.
How to read this documentation
Getting started
Installation, what the first start writes, and a first hologram and NPC.
Holograms
Lines, line tags, pages, and who sees a hologram or what it rides.
NPCs
Skin, pose, equipment, where it looks, its label and a hologram that follows it.
Shared
Click interactions, fine adjust with the mouse wheel, editing the files by hand, the screens, and imports from other plugins.
Reference
Commands, permissions, config.yml and messages, every key of holograms.yml and npcs.yml, and
the FAQ.
Conventions
- Values marked as default are what the plugin writes when the key is missing.
- Identifiers between
<and>are variables:/holo <name> addline <text>means/holo spawn addline Welcome. - A hologram or an NPC is named by its name: lowercase letters, digits,
_and-, up to 32 characters. Commands lowercase what you type. - Colours use ExyliaLib palette tokens (
{primary},{highlight},{letters}),&codes, hex and MiniMessage. - Line numbers in commands start at 1.
Something missing on this page? Tell us on Discord