HoloAPI

Banner

banner

An advanced and powerful holographic display plugin

break

break

Features

With the discovery of new hologram technology (as seen in the video below), HoloAPI is designed to bring you a seamless experience in holographic display creation through the powerful command base and API.

Providing advanced Hologram Technology for your Bukkit server, HoloAPI has the following features (and more!):

Easily manage your own holographic displays
Create Holographic displays with images, animations (GIFs) and multi-line text
Allows developers to create and manage their own holographic displays through the extensive API
Holographic chat bubbles (captions) that show chat messages above the speaker'a head
Animated text support
Automatic UTF-8 character formatting and replacing
Super smooth Animated Holograms and hologram teleportation!
Automatic tag replacement e.g. "Hello there %name%!" (Where name is replaced with the observer's name)
Holographic chat bubbles with in-built support for VanishNoPacket
TouchScreen Holograms with an extensive and easy to use API
Floating Item displays with easy to use tags - %item:id%
BungeeCord support for TouchScreen holograms and online count placeholders
Supports Bukkit from 1.6.4 through to 1.7.9 and MCPC+ 1.6.4

Stay up to date and make sure you have the latest version of HoloAPI!

This extensive API is designed to provide you with the easiest, most feature packed resources for creating and managing your own holograms.

break

HoloAPI also uses intelligent image-translation technology (thanks to @bobacadodl) to transform ordinary images into futuristic holograms that can enhance your server in ways that you have never imagined.

break

break

or

break

Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.

break

Commands and Permissions

CommandPermissionDescription
/holoupdateholoapi.updateUpdate HoloAPI if a new version has been found.
/holoholoapi.holoBase HoloAPI command. All in-game methods for creating holographic displays can be found under this command. Entering this command by itself will provide version information for HoloAPI.
/holo createholoapi.holo.createCreate a holographic display. Lines can be entered one after each other.
/holo create image <image_id>holoapi.holo.createCreate a holographic display from an image. See the Configuration page on the Wiki for more information on how to set this up.
/holo create animationholoapi.holo.createCreate an animated holographic display from lines of text.
/holo create animation <animation_id>holoapi.holo.createCreate an animated hologram. See the Configuration Wiki page for info on how to set up GIFs.
/holo remove <id>holoapi.holo.removeRemove a hologram by its assigned ID.
/holo infoholoapi.holo.infoView all active holographic displays and their respective IDs.
/holo move <id>holoapi.holo.moveMove a hologram to your current position.
/holo teleport <id>holoapi.holo.teleportTeleport to a specific hologram.
/holo buildholoapi.holo.buildDynamically build a combined hologram of both text and images.
/holo edit <id> <line>holoapi.holo.editEdit a line of an existing hologram.
/holo edit <id> <line> <content>holoapi.holo.editEdit a line of an existing hologram. The content can be more than one line.
/holo nearby <radius>holoapi.holo.nearbyView information on all nearby holograms within the specified radius
/holo copy <id>holoapi.holo.copyCopy an existing hologram to your current position.
/holo refresh <id>holoapi.holo.refreshRefresh a Hologram of the specified ID.
/holo reloadholoapi.holo.reloadReload all configuration files and holograms

TouchScreen Hologram Commands

CommandPermissionDescription
/holo touch add <id> <command>holoapi.holo.touch.addAdd an action for a certain hologram to perform when touched. Actions defined without the use of the API (through this command) may only be commands. The `%name%` placeholder can be used to define the user that touched the hologram. Commands can be more than one word.
/holo touch add <id> <command> <as_console>holoapi.holo.touch.addSame functionality as `/holo touch add <command>`. `<as_console>` defines whether the action is performed by the console or the player that touched the hologram
/holo touch remove <id> <touch_id>holoapi.holo.touch.removeRemove an action for a TouchScreen hologram, where `<touch_id>` is the ID of the TouchAction. To remove a command-based Touch Action, simply enter the command"
/holo touch clear <id>holoapi.holo.touch.clearClear all Touch Actions for a particular TouchScreen hologram
/holo touch info <id>holoapi.holo.touch.infoView information on all Touch Actions for a particular TouchScreen hologram

break

Configuration

break

Metrics

Metrics is used to collect plugin statistics. Only data such as plugin version and players online is collected. If you do not wish for this data to be collected, disable it in the 'Plugin Metrics' folder of your 'plugins' directory.

break

Update Checking

HoloAPI comes with an auto-updater to save you, as a server owner, from continually checking this page for new files. It simply connects to dev.bukkit.org and compares the versions of available files. If you do not wish for HoloAPI to perform this check, navigate to the Configuration File (config.yml) in the HoloAPI directory of your plugins folder and change "checkForUpdates" and "autoUpdate" to "false". The first value disables the version comparison altogether and the second updates the plugin automatically if new files are detected.

break

Plugins Using HoloAPI

Some of the plugins that utilise the powerful features in HoloAPI:

...And many more!

break

break

github

Credit to Asdjke for coming up with the idea

break

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of DeanAyalon DeanAyalon Aug 31, 2014 at 16:44 UTC - 0 likes

    Hello, I'm a Server Owner and Developer, it is running 1.7.9, I've installed HoloAPI but it's not working, is it because the latest build is for 1.7.2? If I do /Holo Create, it works until I type Done, thank it doesn't react, anything else that I write just goes to the Chat, like I didn't even Create a Hologram. Secondly, it doesn't react when I try to Create PhotoHolograms, like the Photos I put inside the Photo Folder are not even there. Last, /Holo Help says an internal Error occurred.... /HoloDebug shows nothing wrong.

    I really want this PlugIn, but it just doesn't work.... (And I don't want to switch to "Holographic Displays", this one is better)

    Thank you, Have a nice day :D Dean Ayalon- ofekadri123- CreepaCraft Server

  • Avatar of z65703071 z65703071 Aug 26, 2014 at 10:06 UTC - 0 likes

    I turn on damage , gain health , etc ... and use it. Whenever spawn a holo message. It's normal to hide but it would save to save.yml and display again on reload. It pretty trouble! The save file can be few MB! How to fix it? please!

  • Avatar of SteviemonPlays SteviemonPlays Aug 22, 2014 at 18:22 UTC - 0 likes

    @CaptainBern: Go

    @CaptainBern I am using the latest HoloAPI (v1.2.3) Unless there is a newer one I can't find?

  • Avatar of Greenman1805 Greenman1805 Aug 21, 2014 at 01:33 UTC - 0 likes

    All my holograms are falling down when I join the server? D:

  • Avatar of CaptainBern CaptainBern Aug 20, 2014 at 09:43 UTC - 0 likes

    @SteviemonPlays: Go

    Try using the latest dev-build from DSH105's Jenkins.

    BFAK:CaptainBern,90729934,f3932eab67baa713a76a0416477440340c5692de27e6ec9fd52b2b6ece271f56

  • Avatar of SteviemonPlays SteviemonPlays Aug 15, 2014 at 21:18 UTC - 1 like

    The latest version of HoloAPI generates this error EVERY TIME I load up my Lobby server. It works fine on CraftBukkit, but it does this when I run it on my Spigot server (part of my BungeeCord network server) Any help?

    [16:48:27] [Server thread/WARN]: [HoloAPI] No such field: t! [16:48:27] [Server thread/WARN]: [HoloAPI] Task #716 for HoloAPI v1.2.3 generated an exception java.lang.NullPointerException at com.dsh105.holoapi.util.ReflectionUtil.setField(ReflectionUtil.java:114) [?:?] at com.dsh105.holoapi.util.wrapper.protocol.Packet.write(Packet.java:84) [?:?] at com.dsh105.holoapi.util.wrapper.WrapperPacketSpawnEntityLiving.setMetadata(WrapperPacketSpawnEntityLiving.java:130) [?:?] at com.dsh105.holoapi.api.Hologram.generate(Hologram.java:755) [?:?] at com.dsh105.holoapi.api.Hologram.show(Hologram.java:618) [?:?] at com.dsh105.holoapi.api.Hologram.show(Hologram.java:587) [?:?] at com.dsh105.holoapi.listeners.HoloListener$1.run(HoloListener.java:84) [?:?] at org.bukkit.craftbukkit.v1_7_R4.scheduler.CraftTask.run(CraftTask.java:71) [spigot.jar:git-Spigot-1596] at org.bukkit.craftbukkit.v1_7_R4.scheduler.CraftScheduler.mainThreadHeartbeat(CraftScheduler.java:346) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.MinecraftServer.v(MinecraftServer.java:641) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.DedicatedServer.v(DedicatedServer.java:289) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.MinecraftServer.u(MinecraftServer.java:584) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.MinecraftServer.run(MinecraftServer.java:490) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.ThreadServerApplication.run(SourceFile:628) [spigot.jar:git-Spigot-1596] [16:48:27] [Server thread/WARN]: [HoloAPI] No such field: t! [16:48:27] [Server thread/WARN]: [HoloAPI] Task #718 for HoloAPI v1.2.3 generated an exception java.lang.NullPointerException at com.dsh105.holoapi.util.ReflectionUtil.setField(ReflectionUtil.java:114) [?:?] at com.dsh105.holoapi.util.wrapper.protocol.Packet.write(Packet.java:84) [?:?] at com.dsh105.holoapi.util.wrapper.WrapperPacketSpawnEntityLiving.setMetadata(WrapperPacketSpawnEntityLiving.java:130) [?:?] at com.dsh105.holoapi.api.Hologram.generate(Hologram.java:755) [?:?] at com.dsh105.holoapi.api.Hologram.show(Hologram.java:618) [?:?] at com.dsh105.holoapi.api.Hologram.show(Hologram.java:587) [?:?] at com.dsh105.holoapi.listeners.HoloListener$1.run(HoloListener.java:84) [?:?] at org.bukkit.craftbukkit.v1_7_R4.scheduler.CraftTask.run(CraftTask.java:71) [spigot.jar:git-Spigot-1596] at org.bukkit.craftbukkit.v1_7_R4.scheduler.CraftScheduler.mainThreadHeartbeat(CraftScheduler.java:346) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.MinecraftServer.v(MinecraftServer.java:641) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.DedicatedServer.v(DedicatedServer.java:289) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.MinecraftServer.u(MinecraftServer.java:584) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.MinecraftServer.run(MinecraftServer.java:490) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.ThreadServerApplication.run(SourceFile:628) [spigot.jar:git-Spigot-1596] [16:48:27] [Server thread/WARN]: [HoloAPI] No such field: t! [16:48:27] [Server thread/WARN]: [HoloAPI] Task #717 for HoloAPI v1.2.3 generated an exception java.lang.NullPointerException at com.dsh105.holoapi.util.ReflectionUtil.setField(ReflectionUtil.java:114) [?:?] at com.dsh105.holoapi.util.wrapper.protocol.Packet.write(Packet.java:84) [?:?] at com.dsh105.holoapi.util.wrapper.WrapperPacketSpawnEntityLiving.setMetadata(WrapperPacketSpawnEntityLiving.java:130) [?:?] at com.dsh105.holoapi.api.Hologram.generate(Hologram.java:755) [?:?] at com.dsh105.holoapi.api.Hologram.show(Hologram.java:618) [?:?] at com.dsh105.holoapi.api.Hologram.show(Hologram.java:587) [?:?] at com.dsh105.holoapi.listeners.HoloListener$1.run(HoloListener.java:84) [?:?] at org.bukkit.craftbukkit.v1_7_R4.scheduler.CraftTask.run(CraftTask.java:71) [spigot.jar:git-Spigot-1596] at org.bukkit.craftbukkit.v1_7_R4.scheduler.CraftScheduler.mainThreadHeartbeat(CraftScheduler.java:346) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.MinecraftServer.v(MinecraftServer.java:641) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.DedicatedServer.v(DedicatedServer.java:289) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.MinecraftServer.u(MinecraftServer.java:584) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.MinecraftServer.run(MinecraftServer.java:490) [spigot.jar:git-Spigot-1596] at net.minecraft.server.v1_7_R4.ThreadServerApplication.run(SourceFile:628) [spigot.jar:git-Spigot-1596]

  • Avatar of DSH105 DSH105 Aug 15, 2014 at 11:11 UTC - 0 likes

    @desht: Go You can also use .updateDisplay() to avoid the flicker.

  • Avatar of desht desht Aug 15, 2014 at 06:58 UTC - 0 likes

    @CaptainBern: Go

    Hmm, OK. The problem being the old call in v1.2.4 caused an immediate (flicker-free) update of the hologram, and manager.setLineContent() doesn't update the hologram at all. Only way I could make it update is with .refreshDisplay(), and that causes an annoying flicker.

    BFAK:desht,36011,43bc839d075747c120296c9db76c8535c0db5ea53e57f598a59dcdddc58fd866

  • Avatar of austin488 austin488 Aug 14, 2014 at 13:25 UTC - 0 likes

    Hi, I really need some quick help! I love using this plugin for my server it's amazing, however I wanted to create some image and animation holograms. The problem is everytime I edit the config.yml it and then start the server up it resets! I know I am not entering it wrong as for example the chat bubble show players command, I changed it from false to true and yet it still resets. It seems whatever I alter in it, it just always resets. I make sure to stop the server everytime I alter the file but it just doesn't work, Any advice? I'm running it on 1.7.2 which is my server type also :/

  • Avatar of CaptainBern CaptainBern Aug 14, 2014 at 11:57 UTC - 0 likes

    @desht: Go

    manager.setLineContent(...); It basically just calls the deprecated one, just adds some checks.

    @Shores2510: Go

    The latest version (dev-build 2.0.0) should be compatible.

    @LogicalKnight: Go

    Added.

Facts

Date created
Feb 22, 2014
Categories
Last update
Apr 25, 2014
Development stage
Release
License
GNU General Public License version 3 (GPLv3)
Curse link
HoloAPI
Downloads
23,454
Recent files

Authors

Relationships

Optional dependency
Vanish No Packet
Vault