Actions

Actions are configurable operations that can be attached to certain modules. When triggered, the plugin executes the configured actions in the order they are defined. Actions can perform various tasks such as sending messages, playing sounds, applying effects, executing commands, modifying player data, and more.

---

Messaging

[MESSAGE]

Sends a chat message to the player.

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

[BROADCAST]

Sends a message to all online players. (Not visible in the console)

actions:
- "[BROADCAST] &6A special event has started!"

[PRINT]

Sends a global message. (Visible in the console)

actions:
- "[PRINT] <gray>Just a global message."

---

Debug

[DEBUG]

Writes a message to the console log. You can specify the log level.

actions:
- "[DEBUG] INFO Player joined the server"
- "[DEBUG] WARN Invalid configuration detected"
- "[DEBUG] WARNING Invalid configuration detected"
- "[DEBUG] SEVERE Database connection failed"
- "[DEBUG] ERROR Database connection failed"
- "[DEBUG] FINE Processing message from player %player_name%"
- "[DEBUG] DEBUG Processing message from player %player_name%"

---

Visual

[TITLE]

Displays a title and optional subtitle on the player's screen.

Format: title;subtitle

actions:
- "[TITLE] &aWelcome!;&7Enjoy your stay."

[ACTION_BAR]

Displays a message in the player's action bar.

actions:
- "[ACTION_BAR] &eYou are in a safe zone."

---

Commands

[PLAYER_COMMAND]

Executes a command as the player.

actions:
- "[PLAYER_COMMAND] spawn"
- "[PLAYER_COMMAND] kit starter"

[CONSOLE_COMMAND]

Executes a command from the server console.

actions:
- "[CONSOLE_COMMAND] give %player_name% diamond 1"

---

World

[SOUND]

Plays a Minecraft sound for the player.

actions:
- "[SOUND] entity_player_levelup"

[PARTICLE]

Spawns particles at the player's location.

actions:
- "[PARTICLE] flame"

[TELEPORT]

Teleports the player to a specific location.

Format: world;x;y;z

actions:
- "[TELEPORT] world;100;64;200"

---

Inventory

[INVENTORY]

Modifies the player's inventory.

• ADD

  • Adds items to the player's inventory.

• REMOVE

  • Removes items from the player's inventory.

• CHANGE

  • Removes one item and gives another.

actions:
- "[INVENTORY] ADD DIAMOND 5"
- "[INVENTORY] REMOVE DIAMOND 5"
- "[INVENTORY] CHANGE COAL 10 DIAMOND 1"

---

Potion Effects

[POTION_EFFECT]

Adds or removes potion effects.

Format: TYPE:duration:amplifier

• ADD

  • Applies a potion effect.

• REMOVE

  • Removes a potion effect.

actions:
- "[POTION_EFFECT] ADD SPEED:1200:1"
- "[POTION_EFFECT] ADD REGENERATION:200:2"
- "[POTION_EFFECT] REMOVE SPEED"