Holograms v.2.5.0-SNAPSHOT

A small and efficient Hologram managing plugin

  1. SainttX
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    Contributors:
    SainttX
    Holograms
    Holograms is an implementation of text and item holograms in a CraftBukkit/Spigot server environment. It's creation was inspired by filoghost's HolographicDisplays and was initially created to be a stripped implementation. Over time, the plugin has matured and now features a fully expansive API for developers which allows many different possibilities.
    Features
    Usage (in-game)
    The plugin currently offers a variety of commands for management of your Holograms:
    • /holograms addline <hologramName> <textToAdd>
    • /holograms create <hologramName> <initialText>
    • /holograms delete <hologramName>
    • /holograms import <plugin>
    • /holograms info <hologramName>
    • /holograms insertline <hologramName> <index> <textToAdd>
    • /holograms list
    • /holograms movehere <hologramName>
    • /holograms near <radius>
    • /holograms removeline <hologramName> <index>
    • /holograms refresh
    • /holograms setline <hologramName> <index> <text>
    All commands use the permission structure "holograms.<subcommand>" (ie. /holograms near would use the permission holograms.near).

    Using Holograms (Developers)
    To use Holograms in your plugins, add the Holograms-API module to your build path. Then add Holograms as a dependency in your plugin.yml file:
    Code (YAML):
    depend: [Holograms]
    You can also add Holograms as a Maven dependency:
    Code (XML):
    <repositories>
      <repository>
        <id>maven.sainttx.com</id>
        <url>http://maven.sainttx.com/nexus/content/groups/public/</url>
      </repository>
    </repositories>

    <dependencies>
      <dependency>
        <groupId>com.sainttx.holograms</groupId>
        <artifactId>holograms-api</artifactId>
        <version>2.0.0-SNAPSHOT</version>
        <scope>provided</scope>
      </dependency>
    </dependencies>

    Hologram creation is made easy with our API. Get a reference to the HologramManager and you're set.
    Code (Java):
    private HologramManager hologramManager;

    @Override
    public void onEnable() {
        this.hologramManager = JavaPlugin.getPlugin(HologramPlugin.class).getHologramManager();
    }

    Creating and Modifying Holograms
    Once you have the reference, you can easily work your way around the APIs offerings:
    Code (Java):
    public void createHologram(String id, Location location) {
        Hologram hologram = new Hologram(id, location);
        hologramManager.addActiveHologram(hologram); // Tells the plugin a new Hologram was added
    }
    Adding lines is easy as well:
    Code (Java):
    public void addTextLine(Hologram hologram, String text) {
        HologramLine line = new TextLine(hologram, text);
        hologram.addLine(line);
    }

    public void addItemLine(Hologram hologram, ItemStack itemstack) {
        HologramLine line = new ItemLine(hologram, itemstack);
        hologram.addLine(line);
    }

    Removing Holograms
    You can permanently remove a hologram (incl. persistence) by doing the following:
    Code (Java):
    public void deleteHologram(Hologram hologram) {
        hologramManager.deleteHologram(hologram);
    }
    Or if you want to temporarily hide a persistent hologram until the server restarts:
    Code (Java):
    public void hideHologram(Hologram hologram) {
        hologram.despawn();
        hologramManager.removeActiveHologram(hologram);
    }

Recent Reviews

  1. PurelyAnonymous
    PurelyAnonymous
    3/5,
    Version: v.2.5.0-SNAPSHOT
    was working fine for weeks then suddenly after a server restart, stopped working and started throwing out errors?? please help me fix this, really enjoy this plugin and these holograms are detrimental to the functionality of my server network

    spigot version 1.8.9
    Holograms 2.5.0-Snapshot
    HologramsPlaceholders 2.1.0-Snapshot

    Error messages on server boot up:
    https://pastebin.com/2kqTrnub
  2. BendikNorway
    BendikNorway
    3/5,
    Version: v.2.5.0-SNAPSHOT
  3. LordZargum
    LordZargum
    1/5,
    Version: v.2.5.0-SNAPSHOT
    This version causing severe lag on worlds. I use Spigot 1.12 with multiverse plugins
  4. Sam_Diggity
    Sam_Diggity
    5/5,
    Version: v.2.5.0-SNAPSHOT
    Great alternative to Holographic Displays, which I have been using up until it was no longer supported.
    Thank you for this amazing plugin!
  5. Jenesanity
    Jenesanity
    5/5,
    Version: v.2.5.0-SNAPSHOT
    Just beautiful. I love the way it allows me to create colored holograms! Very useful thanks a lot!
  6. OverMilou
    OverMilou
    4/5,
    Version: v.2.5.0-SNAPSHOT
    Good plugin! Maybe you could add some client side candies to it :) :3
  7. blue1
    blue1
    4/5,
    Version: v.2.5.0-SNAPSHOT
    Excellent plugin, lots of options in your commands! You seem to have thought of almost everything. :) A little buggy here and there, but I got it to do what I wanted with very little trouble. Thank you for making this! I've got so much to code I didn't feel like spending the time to make it myself.
  8. bbruno5
    bbruno5
    3/5,
    Version: v.2.5.0-SNAPSHOT
    Unfortunatelly on this last version is causing severe lag on worlds. Spigot server 1.11.2 with multiverse world management.

    Downgrading to older version again
  9. Rocologo
    Rocologo
    5/5,
    Version: v.2.5.0-SNAPSHOT
  10. HollowRides
    HollowRides
    5/5,
    Version: v.2.5.0-SNAPSHOT
    Beautiful plugin, so useful. please add the command for using images as holograms to the page, it can do it but you havent got it listed as one of the commands