Actions
Adding and using Click-Actions in your Holograms
DecentHolograms allows you to add click-actions to individual hologram pages that get executed when the player either left or right-clicks the hologram.
Format¶
Actions themself are in the following formats:
<action_type> <action_type>:<args>
Note that you don't have to include the <>
brackets!
Click Types¶
These click types are used in the addaction
page command to add the action for a specific click type.
LEFT
RIGHT
SHIFT_LEFT
SHIFT_RIGHT
Action Types¶
MESSAGE:<message>
¶
Sends a message to the player who clicked the hologram.
<message>
- The message to send. Supports Placeholders, including PlaceholderAPI.
COMMAND:<command>
¶
Executes a command as the player who clicked the hologram. Should the specified command not start with a
/
will it instead be send as a message by the player.
<command>
- The command to execute as the player. Supports Placeholders, including PlaceholderAPI.
CONSOLE:<command>
¶
Important
Commands only available through a proxy cannot be executed by this Action.
Executes the specified command through the console.
<command>
- The command to execute as the player. Supports Placeholders, including PlaceholderAPI.
CONNECT:<server>
¶
Sends the player who clicked the hologram to the specified Server. This action only works with Servers connected to a BungeeCord/Velocity proxy.
<server>
- Name of the server the player should be connected to.
TELEPORT:<world>:<x>:<y>:<z>
/ TELEPORT:<x>:<y>:<z>
¶
Teleports the player who clicked the hologram to the specified coordinates, and optionally world.
<world>
- Optional world to teleport the player to. Defaults to the World the player is in, if not specified.<x>
- X coordinate to teleport the player to.<y>
- Y coordinate to teleport the player to.<z>
- Z coordinate to teleport the player to.
SOUND:<sound>:<volume>:<pitch>
/ SOUND:<sound>
¶
Plays the specified sound, optionally with a set volume and pitch, to the player who clicked the Hologram.
<sound>
- Name of the sound to play. A list of available sounds is found here<volume>
- Optional volume to set. Default if not set is1.0
.<pitch>
- Optional pitch to set. Default if not set is1.0
.
PERMISSION:<permission>
¶
Checks whether the player who clicked the Hologram has the specified permission. Unlike other actions does this one act differently by stopping any actions after it from executing, should the player not have the permission.
<permission>
- The permission to check.
NEXT_PAGE:<hologram>
/ NEXT_PAGE
¶
Changes the page of the (optionally specified) Hologram to the next one, if one is available.
<hologram>
- Optional Hologram to change the page of. Defaults to the Hologram the player clicked on, if not set.
PREV_PAGE:<hologram>
/ PREV_PAGE
¶
Changes the page of the (optionally specified) Hologram to the previous page, if one is available.
<hologram>
- Optional Hologram to change the page of. Defaults to the Hologram the player clicked on, if not set.
PAGE:<hologram>:<page>
/ PAGE:<page>
¶
Changes to the specified page on the (optionally specified) Hologram, if one is available.
<hologram>
- Optional Hologram to change the page of. Defaults to the Hologram the player clicked on, if not set.<page>
- Page to switch to on the Hologram.