TheNextLvlTheNextLvl
Manage

Actions

Create and manage character actions.

GitHub Edit on GitHub

You can manage character actions using the /character action command.
/character action [add|cooldown|list|permission|remove] ...

Adding an Action

Actions are triggered by specific click types. To add a new action to a character use command
/character action add <character> <action> <click-type> <action-type> <parameters>.

Existing actions can be overwritten by using the same <action> name.

Click Types

The following click types can be used for the <click-type> argument:

Click TypeDescription
any_clickAny left or right click (with or without shift)
any_left_clickAny left click (normal or shift)
any_right_clickAny right click (normal or shift)
left_clickLeft click only
right_clickRight click only
shift_clickAny shift click (left or right)
shift_left_clickShift + left click only
shift_right_clickShift + right click only

Use these to specify when the action should be triggered.

Action Types & Parameters

Action TypeParameters
connect<server> (BungeeCord/Velocity Server Name)
play-sound<sound> <sound-source> <volume> <pitch>
run-console-command<command>
run-command<command>
send-actionbar<message> (MiniMessage Supported)
send-entity-effect<entity-effect>
send-message<message> (MiniMessage Supported)
teleport<position> [<rotation>] [<world>]
send-title<title> [<subtitle>] [<fade-in>] <stay> <fade-out> (MiniMessage Supported)
transfer<hostname> [<port>]

Using <player> in a parameter will be replaced with the name of the player who triggered the action.

Example

To add a greeting action to a character named "Steve", use the following command:

/character action add Steve greet any_click send-message Hello, <player>!

This action will be triggered on any click and sends Hello, NonSwag! if the player's name is NonSwag.


Cooldowns

Set or view the cooldown for your characters actions.
The cooldown determines how fast an action can be triggered.

Usage: /character action cooldown <character> <action> [<duration>]

  • [<duration>]: Time in ticks (unless specified otherwise).
    Use 0 to remove the cooldown. Omit to view the current cooldown.

Set a Cooldown

To set a cooldown for an action, use the command:
/character action cooldown <character> <action> <duration>

A duration of 0 will remove the cooldown for the action.

Example

/character action cooldown Steve greet 10s

This sets a cooldown of 10 seconds for the greet action of the character Steve.

View Current Cooldown

To view the current cooldown for an action, use the command
/character action cooldown <character> <action>.

Example

/character action cooldown Steve greet

Permissions

Set, remove, or view the required permission for a character's action.
If a permission is set, only players with that permission can trigger the action.

Define a Permission

To define a permission for an action, use the command
/character action permission <character> <action> set <permission>.

Example

/character action permission Steve greet set warm.welcome.permission

Remove a Permission

To remove a permission for an action, use the command
/character action permission <character> <action> remove.

Example

/character action permission Steve greet remove

View Current Permission

To view the current permission for an action, use the command
/character action permission <character> <action>.

Example

/character action permission Steve greet

Removing an Action

To remove a specific action from a character, use the command
/character action remove <character> <action>.

Example

/character action remove Steve greet

List all Actions

List all actions configured for a character using /character action list <character>.

Example

/character action list Steve

Last updated on