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
Latest dev build
This is too awesome!! it seems the flickering stopped too (where nearby holograms would flicker when dmg indicators were created/removed)
one in five generated damage indicators do not unload. They remain static in location(relogging on to server clears artifacts untill new ones get stuck)
My friend and I both see "flying wither skulls" they're definitely from the hologram plugin but we don't know what it means. I do /holo reload and it returns to normal(they disappear). While the skulls are out and about it causes a good amount of client-side lag. Not sure if any one else has encountered this?
--update: the skulls are linked to the animals/mobs dieing in lava a very far distance directly below them and after they're dead (you can see the dmg indicators from the surface) the indicators do not despawn but the skulls do.
The second line in my two line server welcome text hologram loads one in thirty times. Usually after it loads it disappears also. The first line however displays fully about 95% of the time.
Both of these have been persistent since I started using holoapi a week or two ago
It doesnt work for me.
Is another plugin required or something?
Hum, I have problem with damage indicator: when you take damage with lava => Indicator stay and they aren't remove. Build #87
When will you upload a version with 1.6.4 support?
@men8 Try using a later version of HoloAPI (v1.0.6 or v1.0.7).
@DSH105
unfortunately i must put it in config, because they dont want to generate :(
https://www.youtube.com/watch?v=9maM-P2_4wM
Created a video showcase/tutorial :)
Is it possible to change incoming/outgoing damage indicators color? this is awesauce!!
@ravand HoloAPI tries to match it to the closest chat colour available. Some images don't work out so well as there's only a few different colours to choose from.
@men8 Make sure your version of HoloAPI includes that feature. Did those values auto-generate? Try using either v1.0.6 or v1.0.7.
@DSH105
This is my config.yml: http://pastebin.com/1tLiEv6t When i want to use special code in /holo create command, I write [x] and next done. All i've got is [x] in hologram :(
Ok seems like my texturepack didn't havethose BLOCK characters in its font because its workin g on default. HOWEVER everything seems to be displayed in black-grey-white colors do you know why maybe?
@DSH105
Using HoloAPI v1.0.5
That is the image i have put into the images folder: http://puu.sh/7pYO1.png
@ravand That's really odd. What version are you using? Also, a fix for the chunks unloading was included in v1.0.6 (which isn't approved yet). EDIT: Also might be handy for you to show me the original image.
@men8 Can you show me your config and what you are putting into the hologram? :).
@Bydon No, sorry :(. MCPC+ is a modded server which HoloAPI isn't compatible with :\.
Hmmm tried creating an image but all i get is this:
screenshot: http://puu.sh/7pXxt.jpg
Am i doing something wrong? Here also my config for it: http://puu.sh/7pXC8.txt
Also i noticed that holograms dont show anymore once the chunk is unloaded. Only a reconnect or a /holo reload fixes that. It would be nice if it was refreshes for the player again as soon as he enters the chunk again.
Any chance of getting this to work with mcpc+? They don't seem to like each other.
Special characters don't work for me, or i'm doing something wrong. I've got HoloApi v1.0.6.
@Mati0703 No, stopTracking doesn't remove it from the save file. The example you posted will work though.
P.S. ;D
@Mati0703
How to remove Hologram using (dev) API?