Click Actions

Click actions define what happens when a player interacts with a hologram line. You can add multiple actions to a single line, each with its own click type, and manage them with chances, cooldowns, costs, and permissions.

Click Types

Each action requires a click type that determines how the player must interact:

Click Type	Description
`any-click`	Any click type
`any-left-click`	Any left click (normal or shift)
`any-right-click`	Any right click (normal or shift)
`left-click`	Normal left click
`right-click`	Normal right click
`shift-click`	Any click while sneaking
`shift-left-click`	Left click while sneaking
`shift-right-click`	Right click while sneaking

Adding Actions

All action commands follow the pattern:
/hologram line action add <hologram> <line> <action> <click-types> <type> <args>

The <action> parameter is a unique name you choose for the action (e.g., greet, next, teleport-spawn).

Connect to Server

Connects the player to another server in your proxy network.
Usage: /hologram line action add <hologram> <line> <action> <click-types> connect <server>

Examples:

# Connect to lobby on any click
/hologram line action add my-hologram 1 lobby-connect any-click connect lobby

# Connect to survival on right click
/hologram line action add my-hologram 1 survival-connect right-click connect survival

Cycle Page

Cycles the page of a paged line by the specified amount.
Optionally target a different hologram and line.
Usage: /hologram line action add <hologram> <line> <action> <click-types> cycle-page [<target> <target-line>] [<amount>]

Examples:

# Cycle forward one page on right click
/hologram line action add my-hologram 1 next right-click cycle-page 1

# Cycle backward one page on left click
/hologram line action add my-hologram 1 previous left-click cycle-page -1

# Cycle the page of a different hologram's line on right click
/hologram line action add my-hologram 1 next-other right-click cycle-page other-hologram 2 1

Play Sound

Plays a sound to the player.
Usage: /hologram line action add <hologram> <line> <action> <click-types> play-sound <sound>

Examples:

# Play a click sound on any click
/hologram line action add my-hologram 1 click-sound any-click play-sound minecraft:ui.button.click

# Play a level up sound on right click
/hologram line action add my-hologram 1 levelup-sound right-click play-sound minecraft:entity.player.levelup

Run Command

Executes a command as the player.
Usage: /hologram line action add <hologram> <line> <action> <click-types> run-command <command>

Examples:

# Run a command as the player on right click
/hologram line action add my-hologram 1 go-spawn right-click run-command spawn

# Open a menu on any click
/hologram line action add my-hologram 1 open-shop any-click run-command menu open shop

Run Console Command

Executes a command from the console.
Usage: /hologram line action add <hologram> <line> <action> <click-types> run-console-command <command>

Examples:

# Give player an item from console on right click
/hologram line action add my-hologram 1 give-diamond right-click run-console-command give <player> diamond 1

# Broadcast a message on any click
/hologram line action add my-hologram 1 broadcast any-click run-console-command broadcast <player> clicked!

Use <player> as a placeholder for the player's name.

Send Actionbar

Sends an actionbar message to the player.
Usage: /hologram line action add <hologram> <line> <action> <click-types> send-actionbar <message>

Examples:

# Send an actionbar message on any click
/hologram line action add my-hologram 1 welcome any-click send-actionbar Welcome to the shop!

Send Message

Sends a chat message to the player.
Usage: /hologram line action add <hologram> <line> <action> <click-types> send-message <message>

Examples:

# Send a message on right click
/hologram line action add my-hologram 1 greet right-click send-message You clicked the hologram!

Send Title

Sends a title and subtitle to the player.
Usage: /hologram line action add <hologram> <line> <action> <click-types> send-title <title> <subtitle>

Examples:

# Send a title on any click
/hologram line action add my-hologram 1 welcome-title any-click send-title Welcome to the server!

Set Page

Sets the page of a paged line to a specific page number.
Optionally target a different hologram and line.
Usage: /hologram line action add <hologram> <line> <action> <click-types> set-page [<target> <target-line>] [<target-page>]

Examples:

# Set page to 1 on left click
/hologram line action add my-hologram 1 go-first left-click set-page 1

# Set page to 3 on right click
/hologram line action add my-hologram 1 go-third right-click set-page 3

# Set the page of a different hologram's line on right click
/hologram line action add my-hologram 1 set-other right-click set-page other-hologram 2 1

Teleport

Teleports the player to a specific location.
Usage: /hologram line action add <hologram> <line> <action> <click-types> teleport <position> [<world>]

Examples:

# Teleport to coordinates on right click
/hologram line action add my-hologram 1 to-spawn right-click teleport 0 64 0

# Teleport to another world on any click
/hologram line action add my-hologram 1 to-nether any-click teleport 100 64 100 minecraft:the_nether

Transfer

Transfers the player to an external server.
Usage: /hologram line action add <hologram> <line> <action> <click-types> transfer <hostname> [<port>]

Examples:

# Transfer to external server on right click
/hologram line action add my-hologram 1 transfer-main right-click transfer play.example.com

# Transfer to server with custom port on any click
/hologram line action add my-hologram 1 transfer-test any-click transfer localhost 25566

The remote server must be configured to accept transfers.

Managing Actions

Set Action Chance

Sets the probability of an action triggering.
Usage: /hologram line action chance <hologram> <line> <action> <chance>

Examples:

# Set action to trigger 50% of the time
/hologram line action chance my-hologram 1 go-spawn 50

# Set action to always trigger
/hologram line action chance my-hologram 1 greet 100

Set Action Cooldown

Sets a cooldown period between action triggers for each player.
Usage: /hologram line action cooldown <hologram> <line> <action> <cooldown>

Examples:

# Set a 30 second cooldown
/hologram line action cooldown my-hologram 1 go-spawn 30s

# Set a 5 minute cooldown
/hologram line action cooldown my-hologram 1 give-diamond 5m

Set Action Cost

Sets an entry fee that players must pay to trigger the action.
Usage: /hologram line action cost <hologram> <line> <action> <cost>

Examples:

# Set action to cost 100
/hologram line action cost my-hologram 1 go-spawn 100

# Set action to cost 500
/hologram line action cost my-hologram 1 give-diamond 500

Action costs require Vault or ServiceIO along with a compatible economy plugin to be installed.

Set Action Permission

Sets a permission requirement for an action.
Usage: /hologram line action permission <hologram> <line> <action> [<permission> | remove]

Examples:

# Require VIP permission for an action
/hologram line action permission my-hologram 1 go-spawn server.vip

# Remove permission from an action
/hologram line action permission my-hologram 1 go-spawn remove

# View current permission for an action
/hologram line action permission my-hologram 1 go-spawn

List Actions

Lists all actions on a hologram line.
Usage: /hologram line action list <hologram> <line>

Examples:

# List all actions on line 1
/hologram line action list my-hologram 1

Remove an Action

Removes an action from a hologram line.
Usage: /hologram line action remove <hologram> <line> <action>

Examples:

# Remove an action from line 1
/hologram line action remove my-hologram 1 go-spawn

# Remove an action from line 2
/hologram line action remove my-hologram 2 greet

Click Actions

On this page