Actions

Actions are the way in which you will tell the format what to execute when the player joins or leaves. To declare them, you use this syntax:

<action_name>;<params>

At this moment, the plugin contains 15 possible actions you can use to boost your server join experience. In future updates new actions will be added, also you can suggest your own ideas in the github, in the plugin page or Discord.

List of actions:

Action
Description
Syntax
Actual example
Extras

Message

Sends a message to the player.

message;<message>

message;<green>Welcome to the server!

Nothing.

Centered Message

Sends a centered message to the player.

centered_message;<message>

centered_message;<green>Welcome to the server!

There is no guarantee that it is going to be exactly in the center, also there are known issues with Bedrock edition.

Title

Sends a screen title to the player.

title;<title>;<subtitle>;<fadeIn>;<stay>;<fadeOut>

title;<yellow><b>WELCOME;<gold>%player_name%;20;10;20.

You can set the title or subtitle to "none" if you don't want to show one of them.

Actionbar

Sends an actionbar to the player.

actionbar;<message>

actionbar;<gray>Welcome to the server!

Nothing.

Sound

Sends a sound to the player.

sound;<sound>;<volume>;<pitch>

sound;ENTITY_PLAYER_LEVELUP;1;1

Volume and pitch are required.

Player

Makes the player chat or execute a command

player;<command/message>

player;Hello! player;/guide

Nothing.

Console command

Makes the console to execute a command.

console_command;<command>

console_command;say %player_name% joined the server!

PlaceholderAPI is available to parse placeholders for the player that joined.

Teleport

Teleport the player to a specific location in a specific world.

teleport;<world>;<x>;<y>;<z>;[yaw];[pitch]

teleport;myworld;100.0;0.0;230.0;180.0;0.0

Yaw and pitch values are optional.

Broadcast Message

Sends a message to the whole server.

broadcast;<message>

broadcast;<gold>A new player spawned on the server! Welcome to <yellow>%player_name%</yellow>.

Nothing.

Broadcast Centered Message

Sends a centered message to the whole server.

broadcast_centered;<message>

broadcast_centered;<yellow><b>❖ A VIP USER JUST JOINED! ❖

Nothing.

Broadcast Actionbar

Sends a actionbar to the whole server.

broadcast_actionbar;<message>

broadcast_actionbar;<gray>A new user joined the server!

Nothing.

Broadcast Title

Sends a title to the whole server.

broadcast_title;<title>;<subtitle>;<fadeIn>;<stay>;<fadeOut>

broadcast_title;<purple>THE OWNER JOINED!;none;20;10;20

You can set the title or subtitle to "none" if you don't want to show one of them.

Broadcast Sound

Sends a sound to the whole server

broadcast_sound;<sound>;<volume>;<pitch>

broadcast_sound;UI_TOAST_CHALLENGE_COMPLETE;1;1>

Volume and pitch are required.

Condition

Creates a conditional action.

condition;<statement>;<action>;<parameters>

conditional;%player_has_played_before%=no;broadcast;<color:#27B3D9><b>MYSERVER</b></color> <gray>•</gray> <white>Say hello to <color:#5BCF68>%player_name%</color>!

More information in this page.

Prelogin

Creates an action that will be executed before the login of a player.

prelogin;<action>;<parameters>

prelogin;message;<color:#27B3D9><b>MYSERVER</b></color> <gray>•</gray> <white>You're not logged!

It will only work if a hook is activated in the configuration, otherwise the action will be simply ignored and won't execute. You can use both prelogin and conditionals in the same action line, BUT it is important to write the "prelogin" keyword before the conditional. Just like this: prelogin;conditional;<stuff>

Last updated