Actions

This wiki provides documentation on the available actions that can be configured in the TravelingMerchant plugin for purposes such as sending messages, playing sounds, executing commands, and more.

📦 Example Configuration

Example

actions:
 - broadcast:
   - '&fPlayer &a%player% &fperformed action'
 - message:
   - '&a&nCongratulations you performed an action'

With Conditions

Now let's take a look at what all actions this plugin offerswht a offers

📢 broadcast

Sends a message to all players on the server. Support Color

Syntax

- broadcast:
   - '<message>'

Example:

💬 message

Sends a private message to the player who triggered the action. Support Color

Syntax

- message:
   - '<message>'

Example

📊 action-bar

Displays a short action bar message above the hotbar for the player. Support Color

Syntax

- action-bar: '<message>'

Example

🖥️ title

Displays a title and optional subtitle in the center of the player's screen. Support Color

Syntax

- title: 
    title: '<title>'
    subtitle: '<subtitle>'
    fade-in: fedeIn
    stay: stay
    fade-out: fadeOut

Example

Parameters:

• fadeIn, stay, and fadeOut are measured in ticks (20 ticks = 1 second).

🔊 sound

Plays a sound effect to a player. Only works on Spigot/Bukkit

Syntax

- sound: '<sound_name>;<volume>;<pitch>'

Example

💻 console-cmd

Runs a command as the server console. Support Color

Syntax

- console-cmd:
    - '<command>'

Example

👤 player-cmd

Runs a command as the player. Support Color

Syntax

- player-cmd:
    - '<command>'

Example

🌐 discord

Sends a message or embed to Discord via plugin-integrated webhooks or bots.

Syntax

- discord:
    json: '<JSON embed>'

Example

🧪 potion

Applies a potion effect to the player. Only available for spigot

Syntax

- potion: '<effect_type>;<duration>;<amplifier>'

Example

🚫 remove-potion

Removes a specific potion effect from the player. Only available for spigot

Syntax

- remove-potion: '<effect_type>'

Example

💰 add-money

Adds money to the player’s balance (requires an economy plugin like Vault). Only available for spigot

Syntax

- add-money: <amount>

Example

💸 remove-money

Removes money from the player’s balance. Only available for spigot

Syntax

- remove-money: <amount>

Example

🕊️ fly

Enables or disables fly mode for the player. Only available for spigot

First Tab

- fly: <true|false>

Example

🎮 gamemode

Changes the player’s game mode. Only available for spigot

Syntax

Mode: CREATIVE, SURVIVAL, SPECTATOR, ADVENTURE

- gamemode: '<mode>' 

Example

📋open-menu

You open the menu you have in the menu folder

Syntax

- open-menu: '<menu>' # without .yml 

Example