Skip to main content
Player actions control player state, execute commands, send messages, and manage inventory.

​
PLAYER

Execute a command as if the player typed it in chat.
​
command
string
required
The command to execute. Leading slash is optional.

​
Examples

actions:
  - "[PLAYER] spawn"

​
Real-World Usage

From items.yml - Shop item: 
shop:
  name: "&aShop"
  material: EMERALD_BLOCK
  lore:
    - "&7Opens the shop"
  actions:
    - "[PLAYER] buy"
The command executes with the player’s permissions. For admin commands, use CONSOLE instead.

​
CONSOLE

Execute a command from the console with full permissions.
​
command
string
required
The command to execute from console. The %player_name% placeholder is automatically available.

​
Placeholders

  • %player_name% - The player’s username
  • Any PlaceholderAPI placeholders

​
Examples

actions:
  - "[CONSOLE] give %player_name% diamond 64"
Console commands bypass all permission checks. Use carefully and validate user input.

​
GAMEMODE

Change the player’s gamemode.
​
gamemode
enum
required
The gamemode to set. Must be one of: SURVIVAL, CREATIVE, ADVENTURE, SPECTATOR

​
Examples

actions:
  - "[GAMEMODE] CREATIVE"
Gamemode names are case-insensitive but must be valid Bukkit GameMode values.

​
MESSAGE

Send a message to the player.
​
message
string
required
The message to send. Supports color codes and PlaceholderAPI.

​
Examples

actions:
  - "[MESSAGE] &aWelcome to the server!"

​
Color Support

  • Legacy color codes: &a, &c, &l, etc.
  • Hex colors: <#RRGGBB>
  • PlaceholderAPI placeholders

​
BROADCAST

Broadcast a message to all online players.
​
message
string
required
The message to broadcast. Supports color codes including hex colors.

​
Examples

actions:
  - "[BROADCAST] &c&lSERVER RESTART IN 5 MINUTES"

​
CLEAR

Clear the player’s inventory completely.
​
parameters
none
This action takes no parameters.

​
Examples

actions:
  - "[CLEAR]"
This action immediately clears the entire inventory with no confirmation. Use with caution.

​
Common Use Cases

# In a join event or lobby warp
actions:
  - "[CLEAR]"
  - "[ITEM] compass"
  - "[ITEM] socials"

actions:
  - "[CLEAR]"
  - "[GAMEMODE] ADVENTURE"
  - "[CONSOLE] give %player_name% diamond_sword 1"

​
ITEM

Give a custom item from items.yml to the player.
​
item_name
string
required
The ID of the item from items.yml
​
slot
integer
Optional. The inventory slot to place the item (1-9 for hotbar)

​
Syntax

[ITEM] item_name
[ITEM] item_name;slot

​
Examples

actions:
  - "[ITEM] compass"

​
Implementation Details

The ITEM action internally uses the console command: 
hubbly give <player> <item> [amount] [slot]
The item must be defined in items.yml. If the item doesn’t exist, the action will fail silently.

​
Complete Examples

# Give player lobby items on join
actions:
  - "[CLEAR]"
  - "[GAMEMODE] ADVENTURE"
  - "[ITEM] compass;1"
  - "[ITEM] movement;2"
  - "[ITEM] socials;8"
  - "[ITEM] shop;9"
  - "[MESSAGE] &aWelcome to the lobby!"

# Purchase confirmation and rank assignment
actions:
  - "[CONSOLE] eco take %player_name% 5000"
  - "[CONSOLE] lp user %player_name% parent set vip"
  - "[BROADCAST] <#FFD700>%player_name% purchased VIP rank!"
  - "[MESSAGE] &aThank you for supporting the server!"
  - "[TITLE] &6&lVIP RANK;&aActivated;10;70;20"
  - "[SOUND] UI_TOAST_CHALLENGE_COMPLETE"

# From items.yml - admin compass
admin_compass:
  name: "&cAdmin Tools"
  material: RECOVERY_COMPASS
  actions:
    - "[PLAYER] tp %target_player%"
    - "[MESSAGE] &7Teleported to target"
    - "[SOUND] ENTITY_ENDERMAN_TELEPORT"

Build docs developers (and LLMs) love

Get started for freeTalk to us