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
Can someone update this plugin? http://pastebin.com/F3YufmKs
Hey can you make it so that players can use the %serveronline:server% doesn't cancel out the text on the entire line because I want it to say "There are %serveronline:prison% on this server!" but it always just comes out with the total players on that server but none of the rest.
Hello. Is it possible to spawn a hologram that only a certain player can see ?
@LukasAlt
set simplicity to true to disable saving
Hey,
is it possible to create a hologram using the api which does not saves itself. I have so many holograms that it takes ages to load them.
Thanks, Lukas
I'm using MCPC+/Cauldron 1.7.2. I have version 1.2.3 installed and when I do /holo create, it lets me enter my lines of text, however, when I enter "Done" it doesn't create the hologram. Actually, nothing happens. Is this plugin supported on MCPC+/Cauldron? I figured it should work on it. Great plugin and thanks for your time!
@DSH105
At one point, i wrote this to make holograms dissappear after walking a certian distance from a player. It works, thought id just share it with you
@DSH105
Holograms aren't showing up for players that have died and respawn nearby; EG we're using touchscreen holograms to allow players to leave a spleef arena but they respawn near the holos when they lose and the holos don't show up for players that've died nearby.
We're using the latest dev build as of this post.
%item:id% doesnt work
Having an issue with creating image holos. I am certain I have the config.yml set up right (even copied and pasted directly from the tutorial to make sure the format was correct) I have the name of the image spelled correctly as the path variable, "FILE" entered in as the type, have the image in question placed in the "images" directory of HoloAPI, and am entering in the correct image ID.
What I have entered into the config.yml:
images:
myfavouriteimage:
path: bl!nklogo.png
characterType: BLOCK
height: 35
type: FILE
requiresBorder: false
What I enter in-game:
/holo create image myfavoriteimage
What I get:
...Failed to load custom image. Make sure that it is correctly configured in config.yml
Any ideas or is this just a bug?
@DSH105
Another bug. When some simple holograms were created, they disappeared later; but if the viewer logout and login again, those simple holograms appear again and won't disappear until a server reload is executed.
@Sinuce I'm assuming that the holograms are created as 'simple', in which case yes, this is a bug with HoloAPI. Update to the latest development build (which includes a fix ;D) or wait until the next release.
@VodkaDK2 This may be possible in 1.8 and beyond :). Currently, due to the way holograms are set up it, wouldn't work very well.
Would it be possible to be able to set a distance from the hologram in blocks that the hologram displays?
For example if I'm 6 blocks away from a hologram then HoloAPI doesn't send me the data packets for the hologram but if I move within 5 blocks then it does. Is this not possible?
Bug report (likely a HoloAPI bug):
Tried stress testing the EasyLightLevel plugin. This happened (notice the 2991 entities): http://i.imgur.com/qhvDDAl.png
All the holo entities ended up crashing the server. Fair enough, I can just use a cooldown plugin on the command or lower the showarea value.
However, I found that the holograms won't go away - even on a complete server restart. They are set to disappear after four seconds. And there does not seem to be a command for HoloAPI to remove all holograms, so I am currently removing them one by one, manually :/
I posted this info on the EasyLightLevel plugin page as well, since I am uncertain to which plugin the bug applies.
UPDATE: Workaround: Delete and recreate "data.yml". Slightly faster than removing 3000 holograms manually :P
Tried setting up a simple image to test it out and it seems the width of the image wont change just the height or did i miss a config somewhere? Also could ya post a link to the globe gif so cant see how it looks :p ty
it also does it with xp damage and potions
can you add it so the chat bubbles don't save to the data.yml because if you restart the server they stay in game and act like they were placed by hand