JPHolograms
Text, item and block holograms with placeholders and JPNpcs support for Paper servers.
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
- Put
JPHolograms-<version>.jarin your server'spluginsfolder. - Restart the server.
plugins/JPHolograms/is created with the config and messages. - 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
| Command | Description | Permission |
|---|---|---|
/holo helpAliases: /holo, /holograms, /jpholo, /hd | Create and edit holograms. | jpholograms.admin |
Permissions
| Permission | Default | Description |
|---|---|---|
jpholograms.admin | operators | Create, 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: trueSupport
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.