Pages and Actions

Pages and Actions

Every display holds one or more pages, each with its own lines and click actions. Every player browses pages independently — two players can read different pages of the same display at the same time.

Clicking requires a hitbox (click-width / click-height > 0). One is set automatically when you add your first action; tune it with /td clickbox <name> <width> <height>.

Click types

LEFT · RIGHT · SHIFT_LEFT · SHIFT_RIGHT

Each click type runs its own action chain, top to bottom.

Action types — TYPE:data

Action	Does
MESSAGE:<text>	Chat message (colors + placeholders)
COMMAND:<cmd>	Runs as the player
CONSOLE:<cmd>	Runs from console (use %player_name%)
SOUND:<name>[:vol:pitch]	Plays a sound
TELEPORT:[world:]<x>:<y>:<z>[:yaw:pitch]	Teleports the player
CONNECT:<server>	Sends to a BungeeCord / Velocity server
PERMISSION:<node>	Gate — stops the remaining actions if the player lacks the node
NEXT_PAGE[:<display>] · PREV_PAGE[:<display>]	Flip pages (for this player)
PAGE:[<display>:]<page>	Jump to a specific page

Put PERMISSION gates before the actions they guard. Placeholders work inside action data too.

Example — a 2-page info board

/td page add info                                  # page 2
/td page addaction info 1 RIGHT SOUND:UI_BUTTON_CLICK
/td page addaction info 1 RIGHT NEXT_PAGE
/td page addaction info 2 RIGHT PAGE:1             # back to start
/td page addaction info 2 SHIFT_RIGHT PERMISSION:vip.club
/td page addaction info 2 SHIFT_RIGHT CONNECT:lobby

A per-player click cooldown (default 500 ms, see Configuration) prevents click spam across all actions.

In YAML

pages:
- lines:
  - content: '&b&lInfo &8(1/2)'
  actions:
    RIGHT:
    - 'SOUND:UI_BUTTON_CLICK'
    - 'NEXT_PAGE'
- lines:
  - content: '&b&lInfo &8(2/2)'
  actions:
    RIGHT:
    - 'PAGE:1'
    SHIFT_RIGHT:
    - 'PERMISSION:vip.club'
    - 'CONNECT:lobby'