JP Plugins
All plugins

JPHolograms

Text, item and block holograms with placeholders and JPNpcs support for Paper servers.

Display plugin, version 1.0.0

Downloads open soon.

Features

  • Text, item and block holograms
  • Placeholders and animations
  • Templates for quick holograms
  • In-game editor (/holo edit)
  • Holograms that follow JPNpcs NPCs

Requirements

  • Paper 26.1 or newer (Java 25)
  • Optional:
    • PlaceholderAPI: placeholders in texts, and this plugin's own placeholders
    • JPNpcs: works with JPNpcs NPCs

Installation

  1. Put JPHolograms-<version>.jar in your server's plugins folder.
  2. Restart the server. plugins/JPHolograms/ is created with the config and messages.
  3. Change what you want in the files, then reload or restart.

Type /jp as an operator to see every JP plugin you have installed, its version and which optional plugins it found.

Commands

CommandDescriptionPermission
/holo help
Aliases: /holo, /holograms, /jpholo, /hd
Create and edit holograms.jpholograms.admin

Permissions

PermissionDefaultDescription
jpholograms.adminoperatorsCreate, edit and remove holograms.

Configuration

All files are in plugins/JPHolograms/. Files: animations.yml, config.yml, messages.yml, templates.yml.

When you update the plugin, new options are added to your config.yml by themselves, with their comments. Your own settings stay as they are, and the old file is kept as config.old-v<number>.yml.

Languages: English, Spanish, Portuguese, French and German. Set language: in config.yml (en, es, pt, fr or de).

Default config.yml
# Used to add new options to this file after an update. Don't change it.
config-version: 1

# ╔══════════════════════════════════════════════════════════════════╗
# ║                   JPHolograms  ·  config.yml                     ║
# ╚══════════════════════════════════════════════════════════════════╝
# Floating text, items and blocks. Every hologram is made in-game with /holo and
# saved in holograms.yml; this file only holds the defaults. Apply with /holo reload.
#
# Quick start:
#   /holo create welcome                   text where you stand
#   /holo text welcome set 1 <gradient:#A18CD1:#FBC2EB><bold>Welcome!</bold></gradient>
#   /holo text welcome add &7Hi {player}, there are %server_online% players online
#   /holo create spinner item              shows the item you hold
#   /holo create crate block               shows a block (the one you hold)
#   /holo help                             every command
#
# Text: &a codes, &#RRGGBB hex and MiniMessage (<gradient>, <rainbow>, <bold>...).
# Lines with {player} or %placeholders% are made for every player separately, so each
# player sees their own values (PlaceholderAPI and its expansions needed for %...%).
#
# JPNpcs link (when JPNpcs is installed):
#   /holo npc welcome guide                the hologram floats above the NPC "guide",
#                                          follows it when it walks and hides together
#                                          with it for players who cannot see the NPC.
#   /holo npc welcome guide 3              3 blocks above the NPC's feet instead
#   /holo npc welcome none                 unlink it again
#
# Who can see a hologram:
#   /holo visibility welcome permission vip.see
#   /holo visibility welcome add %jpquests_completed_story_first_steps% == true

# Language of the messages: en (messages.yml), es, pt, fr or de (lang/<code>.yml).
# Your own language: copy a file in the lang folder to lang/<code>.yml, translate it
# and set its code here (for example it for lang/it.yml).
language: en

# Editing in game: /holo edit [id] opens menus for everything (text is typed in a dialog).
#
# Animations: {animation:<name>} in a line shows frames from animations.yml, and a
# hologram can switch between pages (/holo page <id> add ...). Ready-made holograms such
# as leaderboards are in templates.yml: /holo templates, then /holo template <id> <name>.

animations:
  # How often animated holograms are redrawn, in ticks. Frames faster than this are skipped.
  redraw-ticks: 2

defaults:
  # Text of new text holograms.
  text: '<gradient:#A18CD1:#FBC2EB><bold>New hologram</bold></gradient>'
  # Blocks from which new holograms are visible.
  view-distance: 48
  # How often text with placeholders refreshes, in ticks (20 = 1 second).
  update-ticks: 40

npc-link:
  # Ticks a linked hologram takes to glide to the NPC's new spot (0 = jump, 2 = smooth).
  smooth-ticks: 2
  # Extra space above the NPC's head (and name) when no offset is given.
  gap: 0.25

hooks:
  # Fill PlaceholderAPI placeholders in hologram text.
  placeholderapi: true
  # Let holograms follow JPNpcs NPCs.
  jpnpcs: true

# Replace messages.yml with the new design when the plugin is updated.
# Your old file is kept as messages.old-vX.yml. false = never touch it.
auto-update-style: true

Support

Guides and the docs of every JP plugin are on the JP Plugins website. Questions, bugs or ideas? Join the JP Plugins Discord.

License

JPHolograms is free to use on any server, including servers that make money, but it is not open source. Don't reupload, sell or share modified copies of it. The full terms are in LICENSE.txt, which is also inside the jar.