✓ HoloGUI [1.8.x - 1.11.2] v2.4.1

Tested Minecraft Versions:

• 1.8
• 1.9
• 1.10
• 1.11

Like my stuff and want to donate? Thanks!!

I am no longer doing development on HoloGUI and will no longer be providing support. Please take this into consideration before purchasing.


HoloGUI is a plugin that displays Graphical User Interfaces (GUIs) to players in a whole new, innovative way. HoloGUI allows server owners to create and config entire custom GUI pages to display to their players. Massive configurability means massive possibilities.


demo.antarescraft.com is running v1.10



Design an awesome GUI?
Post screen shots, links to the config files on pastebin.com, and other requirements in the discussion section. Your work may get featured on the plugin page!

BungeeCord compatible!
/server <server_name> does work, making HoloGUI great for designing your server's own custom server selection GUI!

Please don't hesitate to reach out for support! I am very responsive towards any issues that might arise!
Requires:

• Spigot v1.9.*
• For 1.8.*: ProtocolLib v3.6.5, For 1.9.* Protocol Lib v4.01
• PlaceholderAPI

Want your GUI on this list? Post pix of your GUIs in the plugin discussion!
User Created GUIs:

By: @ilturco

For a list of valid PlaceholderAPI placeholders click here.

PlaceholderAPI Setup Tutuorial:
PLEASE READ: If these steps aren't followed the placeholders in the provided examples won't get evaluated!
PlaceholderAPI placeholders are kept as separate extensions and need to be downloaded. Here's how to download and install them:

First run command:
/papi enablecloud

These are the placeholders you need to download in order for the provided example config files to work (You also need Towny, Vault, and McMMO installed in order for the towny, valut, and mcmmo placeholder to get evaluated!):

/papi ecloud download Server
/papi ecloud download Player
/papi ecloud download Towny
/papi ecloud download McMMO
/papi ecloud download Vault

You can browse the list of available placeholders with:
/papi ecloud list all <page>

If you see an extension you like you can download it the same way you did above with: /papi ecloud download <extension_name>

After you've downloaded all of the extensions you want, run:
/papi reload

All placeholders should now evaluate to their correct values


A list of all MVdW Placeholders can be found here
MVdW Placeholders Setup Tutorial

1. Download and install MVdWPlaceholderAPI
2. Have one of MVdW's placeholder plugins installed (FeatherBoard, DynamicSigns, etc.)
3. run command /papi ecloud download mvdw
4. run command /papi reload
5. Insert the mvdw placeholders with the format %mvdw_<mvdw-placeholder>%

Example: "Server TPS: %mvdw_tps_rounded%"

Pl3xIcons Tutorial:


*requires no permission:
/hg - Author, Version, Website
/hg help - Displays all HoloGUI commands

*requires permission: hg.admin
/hg reloadconfig - Reloads the config file values
/hg guipagelist [page] Displays a list of defined GUI pages

*requires permission: hg.see
/hg open <gui-page-id> - Opens the specified GUI page for the player
/hg close - Closes the GUI page the player is currently looking at
/hg back - Closes the current GUI page the player is looking at and opens the previous GUI page the player was looking at
/hg staticguidisplaylist [page] Displays a list of defined static GUI displays

*requires permission: hg.static
/hg newstaticgui <static-gui-display-id> <gui-container-id> Creates a new static GUI display with the given <static-gui-display-id> at the location the player is standing and displays GUI page <gui-page-id>
/hg deletestaticgui <static-gui-display-id> Deletes the specified static gui display

*requires permission: hg.teleport
/hg tpstaticgui <static-gui-display-id> Teleports the player to the specified static GUI display's location

Configuration files for HoloGUI are located in folder:
plugins/HoloGUI/gui configuration files

Example config files have been supplied in the gui configuration files folder.
You can also access these example config files on pastebin:

• main-page.yml
• towny-page.yml
• server-list-page.yml
• mcmmo-page.yml

QUICK REFERENCE: For Minecraft v1.9-v1.10:

• Sounds
• Material Types
• Entity Types

QUICK REFERENCE: For Minecraft v1.8:

• Sounds
• Material Types
• Entity Types

• Each different GUI page is broken up into different configuration .yml files in the gui configuration files folder.
• GUI pages act as containers that hold all the different GUI components that will exist on that page.

Code (Text):

example-page: #This is the id of your gui page. This id must be distinct among all of your gui-pages.
open-with-item-id: DIAMOND_SWORD #Opens this GUI page if the player left clicks while holding the specified item. Make sure to choose a valid Material Type for your Minecraft version. Valid Material Types for Minecraft v1.8 and 1.9 are listed above
open-with-item-name: "Example Menu" #Opens this GUI page if the player left clicks with an item with material <open-with-item-id> and the item has the specified name (Default: none)
open-on-login: true #Opens this GUI page when the player logs into the server (Default: false)
show-permission: "example.permission" #The permission that the player must have in order to view this gui page (Default: none)
hide-permission: "example.permission2" #If this player has the specified permission, then they cannot view this gui page (Default: none)
components: #The components property holds the list of contained GUI components

#These are just example label components just to show how components fit into the 'components' property of the gui page. (A full explanation on gui components is coming up)
example-component-1:
type: label
text:
- "This is an example"
position:
x: 0
y: 0

example-component-2:
type: label
text:
- "This is an example 2"
position:
x: 0
y: -0.1

• Each GUI Component has to be given a position in order for the plugin to know where to display that component.
• The 'position' property is shared by all GUI Components. It contains an 'x' and 'y' value.
• x and y are values between -1 and 1

Below is a visualization of the HoloGUI coordinate system:
*(0,0) is right in the middle of the player's field of view

• GUI Components are the actual elements that get displayed on the GUI page
• There are several different types of GUI Components, each with their own unique properties that can be configured

• The Label Component is a text only component
• Label Components accept PlaceholderAPI placeholders and Minecraft formatting codes

Code (Text):

example-label-component: #This is the id of the GUI Component. It must be distinct among all the other GUI Components in the containing GUI page
type: label #Specify the 'type' property as 'label' to create a label
label-distance: 6 #How many blocks away the label for this component will be. Default(Button: 15, Item: 6, Entity: 8, Label: 10. Min: 5, Max: 20)
text: #The list text to be displayed by this label component
- "Welcome %player_name% to %server_name%" #You can use PlaceholderAPI placeholders to display customized messages
- "%scroll%This is an example of scrolling text" #Add %scroll% to the beginning of your text to make that line of text scroll
- "&6&lYou can also use Minecraft text formatting codes to format your text!"
position: #Take a look at the Coordinate System section for more information on position. (Default: x: 0, y:0)
x: 0
y: 0.2

• The button component is a clickable image

Code (Text):

example-btn: #id of the button component. It must be distinct among all the other GUI Components in the containing GUI page.
type: button #Specify the 'type' property as 'button' to create a button
label: Example Button #Text label shown above the button
label-distance: 6 #How many blocks away the label for this component will be. Default(Button: 15, Item: 6, Entity: 8, Label: 10. Min: 5, Max: 20)
label-zoom-distance: 4 #When a button is hovered over, how far the label of the button zooms in (Min: 0, Max: 6, Default: 4)
always-show-label: false #Specify whether to always show the button label or only when the player hovers over it (Default: false)
icon: example.png #Icons are located in plugins/HoloGUI/images. You can drop your own images in this folder to be displayed on the button.Accepts .jpg, .png, and .gif image formats.
mini: false #Button components come in two sizes: regular size (18x18px) and mini (9x9px) (Default: false)
onclick: "say %player_name% You clicked this button!" #This is the command to run when the player clicks the button. You can insert PlaceholderAPI placeholders into the command
execute-command-as-console: true #By default HoloGUI runs the onclick command as if it were coming from the player. If 'execute-command-as-console' is true, then the command will run as if the console executed the command (Default: false)
onclick-sound: UI_BUTTON_CLICK #The sound to play when the button is clicked. Make sure to choose the correct sound for your Minecraft version. SoundTypes for v1.8 and v1.9 are listed above (Default: none)
onclick-sound-volume: 0.7 #The volume of the onlclick-sound. Values range from 0-1. 0 Being quiet, 1 being loud (Default: 0.5)
symmetrical: false #Whether or not the image is symmetrical. This is used to get rid of spacing around the image. (Default: false)
click-pemission: "example.permission" #The permission the player must have to click this button (Default: none)
no-permission-message: "&4Sorry! You don't have permission!" #The message to display to the player if they don't have the click-permission
position: #Take a look at the Coordinate System section for more information on position. (Default: x: 0, y:0)
x: -0.3
y: -0.1

• The Image Component is a non-clickable image
• Width and Height of the image can be specified (unlike the Button Component)

Code (Text):

example-image: #id of the image component. It must be distinct among all the other GUI Components in the containing GUI page.
type: image #Specify the 'type' property as 'image' to create an image
label: Example Image #Text label shown above the image
always-show-label: true #Specify whether to always show the image label
image-src: image.png #Images are located in plugins/HoloGUI/images. You can drop your own images in this folder to be displayed on the image. Accepts .jpg, .png, and .gif image formats.
width: 20 #Width of the image (Default: 18)
height: 20 #Height of the image (Default: 18)
symmetrical: false #Whether or not the image is symmetrical. This is used to get rid of spacing around the image. (Default: false)
position: #Take a look at the Coordinate System section for more information on position. (Default: x: 0, y:0)
x: -0.3
y: -0.1

• The Item Component displays an item at the specified position
• It can be either clickable or non-clickable depending on the value of the 'clickable' property.
• Item Components have an extra property called 'rotation', in which the rotation of the item about the x, y, and z axis can be specified

Code (Text):

example-item: #id of the item component. It must be distinct among all the other GUI Components in the containing GUI page.
type: item #Specify the 'type' property as 'item' to create an item
item-id: DIAMOND_SWORD:0 #The MaterialType of the item. If you want to specify a data value, add ':<data-value'> to the end of the item-id. Make sure to choose a valid Material Type for your Minecraft version. Valid Material Types for Minecraft v1.8 and 1.9 are listed above
label: Example Item #Text label shown above the item
label-distance: 6 #How many blocks away the label for this component will be. Default(Button: 15, Item: 6, Entity: 8, Label: 10. Min: 5, Max: 20)
label-zoom-distance: 4 #When a button is hovered over, how far the label of the button zooms in (Min: 0, Max: 6, Default: 4)
always-show-label: true #Specify whether to always show the item label (Default: false)
clickable: true #Specify if this item component is clickable or not (default: false)
onclick: "say %player_name% You clicked this item!" #When the 'onclick' property is specified, the item becomes clickable. This is the command to run when the player clicks the item. You can insert PlaceholderAPI placeholders into the command
execute-command-as-console: true #By default HoloGUI runs the onclick command as if it were coming from the player. If 'execute-command-as-console' is true, then the command will run as if the console executed the command (Default: false)
onclick-sound: UI_BUTTON_CLICK #The sound to play when the button is clicked. Make sure to choose the correct sound for your Minecraft version. SoundTypes for v1.8 and v1.9 are listed above (Default: none)
onclick-sound-volume: 0.7 #The volume of the onlclick-sound. Values range from 0-1. 0 Being quiet, 1 being loud (Default: 0.5)
click-pemission: "example.permission" #The permission the player must have to click this button (Default: none)
no-permission-message: "&4Sorry! You don't have permission!"#The message to display to the player if they don't have the click-permission
rotation: #The rotation of the item around the x, y, and z axis in degrees. Values range from -360 to 360. (Default: x:0, y:0, z:0)
x: 0
y: 90
z: 0
position: #Take a look at the Coordinate System section for more information on position. (Default: x: 0, y:0)
x: -0.3
y: -0.1

• The Entity Component spawns the specified entity at the given position
• It can be either clickable or non-clickable depending on the value of the 'clickable' property.
• Entity Components have an extra property called 'yaw' which specifies the entity's yaw (rotation around the y-axis)

Code (Text):

example-entity: #id of the entity component. It must be distinct among all the other GUI Components in the containing GUI page.
type: entity #Specify the 'type' property as 'entity' to create an entity
entity-type: VILLAGER #The EntityType of the component. Make sure to choose a valid Entity Type for your Minecraft version. Valid Entity Types for Minecraft versions 1.8 and 1.9 are listed above
label: Example Entity #Text label shown above the entity
label-distance: 6 #How many blocks away the label for this component will be. Default(Button: 15, Item: 6, Entity: 8, Label: 10. Min: 5, Max: 20)
label-zoom-distance: 4 #When a button is hovered over, how far the label of the button zooms in (Min: 0, Max: 6, Default: 4)
always-show-label: true #Specify whether to always show the entity label (Default: false)
clickable: true #Specify if this entity component is clickable or not (default: false)
onclick: "say %player_name% You clicked this entity!" #When the 'onclick' property is specified, the entity becomes clickable. This is the command to run when the player clicks the entity. You can insert PlaceholderAPI placeholders into the command
execute-command-as-console: true #By default HoloGUI runs the onclick command as if it were coming from the player. If 'execute-command-as-console' is true, then the command will run as if the console executed the command (Default: false)
onclick-sound: UI_BUTTON_CLICK #The sound to play when the button is clicked. Make sure to choose the correct sound for your Minecraft version. SoundTypes for v1.8 and v1.9 are listed above (Default: none)
onclick-sound-volume: 0.7 #The volume of the onlclick-sound. Values range from 0-1. 0 Being quiet, 1 being loud (Default: 0.5)
click-pemission: "example.permission" #The permission the player must have to click this button (Default: none)
no-permission-message: "&4Sorry! You don't have permission!" #The message to display to the player if they don't have the click-permission
yaw: 0 #The yaw of the entity in degrees. Values range from -360 to 360 (Default: 0)
position: #Take a look at the Coordinate System section for more information on position. (Default: x: 0, y:0)
x: -0.3
y: -0.1

• The Toggle Switch Component creates a component that can have two states: true and false
• Clicking the toggle switch causes it to swap states
• Toggle switches can have a value. The value can be accessed with the placeholder: %<toggle-switch-id>_value%.

Code (Text):

example-toggle-btn: #Id of the toggle switch
type: toggle-switch #Set type to 'toggle-switch' to create a new toggle switch component
label: "&lGamemode: &4&l%example-toggle-btn_value%" #Label of the toggle switch
always-show-label: true #Specify whether to always show the entity label (Default: false)
value: false #Specify true|false to set the default value the toggle switch starts with
icon-on: default-toggle-on.png #The image to use when the toggle switch is in the 'on' state
on-value: Creative #Assign a value that this toggle switch will have when in the 'on' state. The current value of the toggleswitch can be accessed with placeholder %component-id_value%
onclick-on: gamemode 1 %player_name% #Command to run when the toggle button gets toggled to 'true'
execute-onclick-on-as-console: true #Execute the on-command as console or not (true|false)
icon-off: default-toggle-off.png #The image to use when the toggle switch is in the 'off' state
off-value: Survival #Assign a value that this toggle switch will have when in the 'off' state. The current value of the toggleswitch can be accessed with placeholder %component-id_value%
onclick-off: gamemode 0 %player_name% #Command to run when the toggle button gets toggled to 'false'
execute-onclick-off-as-console: true #Execute the off-command as console or not (true|false)
onclick-sound: UI_BUTTON_CLICK #The sound to play when the button is clicked. Make sure to choose the correct sound for your Minecraft version. SoundTypes for v1.8 and v1.9 are listed above (Default: none)
click-pemission: "example.permission" #The permission the player must have to click this button (Default: none)
no-permission-message: "&4Sorry! You don't have permission!" #The message to display to the player if they don't have the click-permission
position: #Take a look at the Coordinate System section for more information on position. (Default: x: 0, y:0)
x: 0
y: -0.25

• The text box component is directly editable in game
• Click the text box once to edit the text box
• Click the text box again to cancel editing the text box
• Type the text you want to appear in the textbox in chat after you have began editing
• After typing the text into chat and pressing 'Enter' the textbox will update.

The textbox's value can be accessed with placeholder:
%<text-box-id>_value%
Code (Text):
text-box-example:
type: text-box #Id of the text box
always-show-label: true #Specify whether to always show the entity label (Default: false)
label: "&lText Box Value: %text-box-example_value%" #Label of the text box
default-text: "Insert a command..." #Default text to appear in the textbox
onclick-sound: UI_BUTTON_CLICK #The sound to play when the textbox is clicked. Make sure to choose the correct sound for your Minecraft version. SoundTypes for v1.8 and v1.9 are listed above
click-pemission: "example.permission" #The permission the player must have to click this button (Default: none)
no-permission-message: "&4Sorry! You don't have permission!" #The message to display to the player if they don't have the click-permission
position: #Take a look at the Coordinate System section for more information on position. (Default: x: 0, y:0)
x: 0
y: 0.3



The Value Scroller Component is a component that allows the user to use the mouse wheel to scroll between a range of different values. Great if you want the user to pick from a predefined range of numbers.

The value of this value scroller can be accessed with placeholder:
%<value-scroller-id>_value%

Value Scroller Config:
Code (Text):
value-scroller-example: #Id of the value scroller
type: value-scroller #Specify the type as 'value-scroller' to create a Value Scroller Component
always-show-label: true #Specify whether to always show the label (Default: false)
label: "&lScroller Value: %value-scroller-exmaple_value%" #Label of the value scroller
default-value: 10 #Default value this value scroller will have
min-value: 0 #Minimum value this value scroller can have
max-value: 20 #Maximum value this value scroller can have
decimal-format: "#.##" #The decimal format of the number displayed in the value scroller
step: 1 #The value that will be add/subtracted from the current value as the player scrolls
onscroll-sound: "BLOCK_LAVA_POP" #The sound the plays when the user scrolls
onscroll-sound-volume: 0.1 #The volume of the onscroll sound (0 being softest, 1 being loudest)
onclick-sound: UI_BUTTON_CLICK #The sound to play when the value scroller is clicked. Make sure to choose the correct sound for your Minecraft version. SoundTypes for v1.8 and v1.9 are listed above
click-pemission: "example.permission" #The permission the player must have to click this button (Default: none)
no-permission-message: "&4Sorry! You don't have permission!"#The message to display to the player if they don't have the click-permission
position: #Take a look at the Coordinate System section for more information on position. (Default: x: 0, y:0)
x: 0
y: 0.3

hg.* - Access to all HoloGUI commands and features (Default: op)
hg.admin - Access to all HoloGUI admin commands (Default: op)
hg.see - Gives the player the ability to see GUI pages (Default: true)
hg.static - Gives the player the ability to create static GUI displays (Default: op)
hg.teleport - Allows the player to teleport to a static display (Default: op)