HoloAPI
An advanced and powerful holographic display plugin
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.
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.
or
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.
Commands and Permissions
Command | Permission | Description |
---|---|---|
/holoupdate | holoapi.update | Update HoloAPI if a new version has been found. |
/holo | holoapi.holo | Base 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 create | holoapi.holo.create | Create a holographic display. Lines can be entered one after each other. |
/holo create image <image_id> | holoapi.holo.create | Create a holographic display from an image. See the Configuration page on the Wiki for more information on how to set this up. |
/holo create animation | holoapi.holo.create | Create an animated holographic display from lines of text. |
/holo create animation <animation_id> | holoapi.holo.create | Create an animated hologram. See the Configuration Wiki page for info on how to set up GIFs. |
/holo remove <id> | holoapi.holo.remove | Remove a hologram by its assigned ID. |
/holo info | holoapi.holo.info | View all active holographic displays and their respective IDs. |
/holo move <id> | holoapi.holo.move | Move a hologram to your current position. |
/holo teleport <id> | holoapi.holo.teleport | Teleport to a specific hologram. |
/holo build | holoapi.holo.build | Dynamically build a combined hologram of both text and images. |
/holo edit <id> <line> | holoapi.holo.edit | Edit a line of an existing hologram. |
/holo edit <id> <line> <content> | holoapi.holo.edit | Edit a line of an existing hologram. The content can be more than one line. |
/holo nearby <radius> | holoapi.holo.nearby | View information on all nearby holograms within the specified radius |
/holo copy <id> | holoapi.holo.copy | Copy an existing hologram to your current position. |
/holo refresh <id> | holoapi.holo.refresh | Refresh a Hologram of the specified ID. |
/holo reload | holoapi.holo.reload | Reload all configuration files and holograms |
TouchScreen Hologram Commands
Command | Permission | Description |
---|---|---|
/holo touch add <id> <command> | holoapi.holo.touch.add | Add 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.add | Same 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.remove | Remove 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.clear | Clear all Touch Actions for a particular TouchScreen hologram |
/holo touch info <id> | holoapi.holo.touch.info | View information on all Touch Actions for a particular TouchScreen hologram |
Configuration
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.
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.
Plugins Using HoloAPI
Some of the plugins that utilise the powerful features in HoloAPI:
...And many more!
Credit to Asdjke for coming up with the idea
Is it possible to set a distance that you can see a hologram from?
I was testing the chatbubbles and then disabled them. I then relized that they are still there. So how can i get rid of them?
Can you please help? I've been trying to test the animated holograms to flick between 2 different sets of text;
When I get to changing the ticks, it gives me a "Null" then cancels everything
http://i.imgur.com/sA80xvb.png What am I doing wrong?
@gdude2002
I have a similar issue only they disappear on restarts and don't reappear until I reload the plugin.
Attempting to edit/create/delete and getting an error, basically everything except /holo or /holo info doesn't work.
Error NULL: http://pastebin.com/MQVYBREB
@nacramell
This also happens when using:
A lot of the holograms save to file.
Used the api in my EasyLightLevel plugin. Hope you like it.
".withSimplicity(true)" does not work, Using Bukkit 1.7.9, HoloApi 1.2.3
Every Hologram gets saved to file, server ticks start to go up to over a second with 400 holograms. Those are NOT shown ingame, just loaded.
code:
Can you please add support to numbers when we are teleporting or creating the holograms to certain coordinates. I mean like this: "holo create world 15.5 100.5 10.5 test" We can only use integers right now.
Moving holograms is problematic - When you move them, they disappear (until you do /holo reload).
I'm using the latest version of the plugin on Spigot for 1.7.5.
EDIT: Also, indicator holograms appear to be saved with negative IDs, instead of being removed entirely.
Is it just me, or is anyone else getting this on version 1.2.3...
[19:35:04 WARN]: [HoloAPI] Task #159 for HoloAPI v1.2.3 generated an exception java.lang.OutOfMemoryError: Java heap space [19:35:15 WARN]: [HoloAPI] Task #160 for HoloAPI v1.2.3 generated an exception java.lang.OutOfMemoryError: Java heap space [19:35:26 WARN]: [HoloAPI] Task #161 for HoloAPI v1.2.3 generated an exception java.lang.OutOfMemoryError: Java heap space
I am not out of RAM nor HDD space... Java was set to have plenty of memory... Also on the update, all but 2 of my displays were lost saying they can't find the world they go in... but it did put in one in each world that they go in...
Server is run on Spigot 1.7.9-R.0.1 and did work correctly on HoloAPI version 1.2.0 until I updated it now...
edit: fyi, yes I've tried reloading the data.
Found a bad bug, i have item holograms setup for items in my servers PvP arena. But, everytime someone dies the holograms disapear for them only and they have to relog to see them again. Thanks!
@DSH105
Okay, sorry. So sometimes after like a restart or when I join, mostly 90% of all holograms are gone. I must type /holo reload, and then they all show up.
Holographic Displays doesn't have this issue.
@TomFromCollege We've encountered some problems with that (which are now fixed) :).
@DPOHVAR Awesome :). Use .setSimplicity(true) in the hologram factory class.
@TomFromCollege What version of HoloAPI are you using. Does it still occur on the later dev builds?
@TheCoolGuy123_5_Minecraft_ You should provide more info on why this is happening (instead of just stating it's unreliable ;)), as I have debugged and never had a problem with it.
@lecraeman Any more info? It's never been reported to not work.
@samueli5750 That's something you shouldn't need to change. It's required for many of the data tags. It shouldn't be causing that much of a problem unless you have an immense number of holograms.
@Bydon Already added a while ago. %item:id,meta%. If touchscreens aren't currently active in MCPC+, we're working on it ;).
@XiProbaseballX Yes.
@LandrioProd Make sure you're using a dev build (the most recent DBO release doesn't support that).
@Airos18 Fixed in some of the more recent dev builds :).
wow, looks awsome !!! :-)
when i use Bubblechat , chat messages convert to holographics, and don't clear.. i had remove this.. with /holo remove 1 , 2 ,3 ,70 .... please help me, i don“t want that bubble messages create a holo....
@CaptainBern
Oh ! It made me crash my minecraft to do that in a hologram :o
@LandrioProd
%item:397,1% should do the job.
%item:397:1% to display a head wither does not work :x
@XiProbaseballX
I am running it on our latest MCPC 1.6.4 servers now. So yup, it works.