How It Works

Vanilla HolographicDisplays shows holograms whenever a player is within the standard Minecraft view distance. pHD modifies the HolographicDisplays LineTrackerManager to filter hologram visibility for each player, based on pHD configuration and per-hologram settings.

pHD does not modify the content of the holograms themselves.

Display types

pHD supports four hologram types, with different capabilities and uses.

Display is always subject to the optional restrictions, listed below. For example: a hologram cannot be viewed if the player does not have the required permission.

type	parameter	format	description
ALWAYS			View the hologram always, restricted by other options
IRLTIME	time	hh:mm	View the hologram at the specified IRL time, restricted by other options
MCTIME	time	hh:mm	View the hologram at the specified MC time, restricted by other options
NTIMES	times	integer	View the hologram a limited number of times, restricted by other options

Display options

option	format	description
distance	number	View the hologram only within the specified distance, in blocks
seconds	integer	View the hologram for a specified duration, in seconds
flash	number	Toggle the hologram on/off at the specified period, in seconds Minimum 1.0; equivalent to flashOn=flashOff
flashOn	number	Toggle the hologram on for a specified duration, in seconds Minimum 1.0; must be combined with flashOff
flashOff	number	Toggle the hologram off for a specified duration, in seconds Minimum 1.0; must be combined with flashOn
permission	string	View the hologram only with the specified permission

In most cases, the default values for distance and duration are used if specific values are not set. See Configuration. Type ALWAYS is a special case -- see the table below.

Examples

phd manage hologram_A ALWAYS distance 5.5

Display hologram_A whenever the player moves within 5.5 blocks of it. Use case: Create a secret hologram that is viewable only when very near to it. This is similar to a standard hologram, but with the view distance reduced to 5.5 blocks.

phd manage hologram_B NTIMES 3 distance 20

Display hologram_B whenever the player moves within 20 blocks of it, but only 3 times. After that, the player cannot see it. Use case: Create an instructional hologram at a spawn point, that the player sees the first 3 times it is encountered, and never again. Note that the player count can be reset by command. Restricting the acquisition distance helps ensure that the player actually sees the hologram.

phd manage hologram_C ALWAYS permission multiverse.portal.access.lobby_world

Display hologram_C whenever the player moves within the default view distance, if the player has the required permission. Use case: Create a portal hologram that is visible only if the player has the associated permission to use the portal.

Type ALWAYS options combinations

ALWAYS is a special case, depending on whether distance and duration options are specified or unspecified. The following table explains the effect of the various combinations on hologram activation and deactivation. In all cases, if a permission is specified, the player must have the required permission.

distance	seconds	description
specified	specified	Activates for the specified duration when the player moves within the specified distance
		Deactivates after the specified duration, regardless of player distance
specified	unspecified	Activates when the player moves within the specified distance
		Deactivates when the player moves outside the specified distance
unspecified	specified	Activates for the specified duration, when the player moves within the default distance
		Deactivates after the specified duration, regardless of player distance
unspecified	unspecified	Activates when the player joins the world, even if outside MC view distance
		Deactivates when the player leaves the world or disconnects from the server