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
@TheRynoMyte
I must agree...you can't even add text next to an item. It takes the entire line.
You need to be able to add other stuff, but I still love the items :D
However, The /holo remove command doesn't seem to work at all.
@DSH105
Got it, but now it says "An update is available(1.2.0)" whenever I join in, but that would be a DOWNGRADE. Does that have to do with it not being approved yet?
Is there a way to display the floating item with an integer containing a ':'? I like the smooth stone brick of 43:8 but am unable to use with %item:43:8% or any other configuration for that matter. I am trying to set an admin shop, and add floating items with purchase points added with the touch screen commands. And also is there a way to use more than one %item:id% in a single line, or with text on the same line? When I try this, whatever text or second %item% is overwritten by the first %item%. If ya know what i mean Vern!?!
@lecraeman Hopefully we got it right this time :3
@sanjay900 Nice ;D
@DJNuts If you enter a space, or a chat colour code without anything else it should be close to blank (e.g. "&r").
@lecraeman
Late Aprils Fools. :/
@DSH105
Got a notification today...but I can't find the file :'(
Hey guys. Sorry if the question I`m about to do is answered above, but is there a way to leave a blank line, with nothing in it, so that I can have a space between two lines ?
I had a minigame where you had to walk through blocks. Normal falling blocks change to their normal blocks when they hit the ground, however, a falling entity riding a horse (similar to how holograms work) will stay frozen, wont fall and wont change to a block, it will stay an entity, meaning you can make fake walls and really fun traps (i put some in the floor once and tricked so many people). The idea really made the minigame work well though. I can show you tomorrow if you like. Send me a pm if your interested.
@sanjay900
Just wondering what you use fake falling blocks for?
Thanks for this plugin, ended up making a plugin using this one for fake falling blocks :). I use those and holograms quite alot now.
@lecraeman Who told you it was 1.6? O.o
We've been working on a few important things, which is why we haven't released in a while. I'll put up a release before the week is over :).
When will the items be added?
I know it's already in the dev builds, but I want to know when it will be on bukkit.
I heard someone say you're already on version like 1.6 in the dev builds? If that's true why are we on version 1.2 here on bukkit?
Nothing against you guys and the dev builds ;) It's just the plugin has to be fairly stable to be on bukkit, and I don't trust dev builds xD
Found the issue all is resolved now :)
@DSH105 I am using HoloAPI v1.2.0 and craft bukkit 1.7.8 there is one error that is coming up saying there is a expected ":" however I haven't seen any missing throughout
Any comments regarding the unnecessary flame war that was started here have been removed and the issue resolved. If you don't know what I'm referring to, there's nothing to be worried about ;).
@JCPlaysMC What version of HoloAPI are you using? Are there any errors in the console (check your startup log too)?
I recently upgraded to 1.7.8 and none of the holograms show up heres my config file: http://pastebin.com/Q1DZKhBu
@XD_3VIL_M0NKEY We've fixed this and will be uploading within the week (hopefully) ;D.
@DSH105
Java 7, CB 1.7.8, throws this on player join. http://pastebin.com/v2GV9yyV