HologramsPlus - Adds support for PlaceholderAPI to RandomByte's holograms


#1

This is a discussion topic for the Ore project, HologramsPlus. View the full project on Ore for downloads and more information.


HologramsPlus

HologramPlus is an extension of RandomByte’s holograms that lets you add placeholders to your holograms.

Installation

Download HologramsPlus-1.0.0.jar.

Download holograms-3.1.5.jar.

Download PlaceholderAPI-4.4.jar.

Usage

  1. Create your hologram in the same way you do always, and use any placeholder you need (but pay attention to this).

    Example: /holograms create Hello there! Currently there are %server_online% players connected.
  2. Register the newly created hologram, by standing within 10 blocks from the entity, using the command /hologramsplus select enable and selecting what you want to modify.
  3. Profit! Now your hologram will be updated every tot seconds (according to your config), with the new placeholders.
  4. If for any reason you want to disable the placeholders of an hologram, simply run the command /hologramsplus select disable and choose the desired hologram.

Restrictions

Due to the nature of the holograms, they cannot let a player being the source of the placeholders. In other words this mean that the number of placeholders actually available are restricted to the one that doesn’t rely on players.

Some examples can be found here, here, and here.

I’m not saying there’s no way of actually achieving the use of subjects in the holograms, because technically there are a couple of ways.

The first is by sending different packets per player, but it’s way over the original function of this plugin.

The second is by parsing the placeholders using the nearest player, which isn’t such a bad idea, but it can be achieved relatively easy by other placeholders. If you’re interested in seeing it, let me know, I could implement that if people keeps to ask.

Commands

Command Permission Usage
/hologramsplus select <enable/disable> hologramsplus.command.select See usage.
/hologramsplus refresh hologramsplus.command.refresh Forces to refresh all the placeholders.