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. 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
  2. Rocologo
    Rocologo
    5/5,
    Version: v.2.5.0-SNAPSHOT
  3. 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
  4. SanFrancisQ
    SanFrancisQ
    4/5,
    Version: v.2.5.0-SNAPSHOT
    It's a good idea, but it removes itselfs after a reload, I am using currently the version 1.12, can you fix this?
  5. MinecraftMarcus1
    MinecraftMarcus1
    1/5,
    Version: v.2.5.0-SNAPSHOT
    Used to work but now doesnt work with 1.12 and the link to the development builds doesn't work. Please fix ASAP!
  6. IAlekseyI
    IAlekseyI
    1/5,
    Version: v.2.5.0-SNAPSHOT
    Where is the hologram update team? Where does the plug-in reboot? I do not want to edit the holograms with the team in the chat.
  7. Beppe01
    Beppe01
    3/5,
    Version: v2.4.1-SNAPSHOT
    please update to 1.12, not working on 1.12 (30/06/17), other than that brilliant alternative to holographic displays
  8. Spikey101
    Spikey101
    2/5,
    Version: v2.4.1-SNAPSHOT
    this plugin worked great, until i restarted my server. I then noticed that /h setline doesn't save the changes and you lose your work.
  9. Een_noob
    Een_noob
    1/5,
    Version: v2.4.1-SNAPSHOT
    Author is no longer active I think :/ It was a good plugin for 1.11.2 and lower :3
  10. Goetheus
    Goetheus
    5/5,
    Version: v2.4.1-SNAPSHOT
    Great plugin and great and easy use API! Thank you very much for maintain this plugin!