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
@rangewonk I'll have to implement something that shows players the hologram when they change worlds, as currently that only happens when players join.
@JebananyPL Awesome. I'll put in on the official wiki page ;).
Good plugin although I am having a few problems with it. I do /holo create, then i type out my lines and do Done. It works. Most people can see it but not everyone can. On a server restart it disapears and no one can see it not even ops. When i type /holo reload it comes back but only the people can see it if they are on that world at the time of the reload.
How can i make it so everyone can see the holos at all time?
( im just using text no images )
Hi! I shot a video about your plugin in polish language. If you want you can post the video in the description:
https://www.youtube.com/watch?v=9FhRD54s164
@DSH105
compiled with maven :)
Just spent a lot of time documenting and writing up info on how to use the API, which can be found over on the Wiki page. Please note that things currently on that page are only reflected by the latest snapshot builds, and the methods may be different in early versions of HoloAPI.
Pull requests are welcome :).
@LeTruent What build from GitHub? ;o
@Stevensaurus I'm working on optimising and improving holograms ;).
Sometimes a holo disapears from the text and if you look closely, you can see the missing holo falling down in the void some blocks behind the actual text. There are no errors in the console. Please fix this.
It works, but after a while the displays become black, and sometimes the last line disappears.
I still need to log in the right world to see the right holograms : if I teleport from another world to the one with the holograms, those don't load. (using build from github). edit : only animations holograms seem to work properly.
<mod edit: linking to unapproved file>
If you all want to try the new build! :)
How can I prevent to unloading of holograms with chunks? they don't come back unless i manually do /holo reload. It seems hit or miss too on which one or all of them unload. I can't go more then a few chunks from town before the holograms are never seen again :/
@LeTruent For now, holograms can't be teleported between worlds. I'll add mulitiworld support :).
teleporting between worlds makes the holograms disappear (using dev builds, multiverse and spigot)
@johandre Make sure the hologram is placed in the sun ;).
@rangewonk The video was from the original creator. It is on this page simply to showcase the holograms. A video of this plugin will hopefully be up there soon.
@Stevensaurus Try the Dev builds (if you haven't already) or v1.0.3 which was just uploaded.
@modzmarvin The size value in the config only determines how many lines the hologram will have in game. The size of the image shouldn't matter too much. Also remember to try out the requiresBorder option. What problems are you experiencing?
What is the best image size? im trying to get some text from a logo on a image and its not to easy lol
tried 64 64 but its just not having it. now its turned into just a line so after about 5 hours of playing i still cant get it right. cant find anything on the wiki that would say what the best size is.
awesome plugin. most powerful one released so far!
@rangewonk
This is a plugin now. The video is of the original creator who made a filter of this.
@johandre
Alright thanks man, I'll do that.
@Stevensaurus
Yeah it is but then you need to edit on the config cordinates.
@johandre
Yup, I figured it out. But is there a way to put the hologram in the middle of the block instead of to the side?