Skip to content

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 is 1.0.
  • <pitch> - Optional pitch to set. Default if not set is 1.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.