For the complete documentation index, see llms.txt. This page is also available as Markdown.

Reward Actions

Action types of rewards

Each reward has its own set of actions that are executed upon claiming the reward. The following pattern is valid for use: [<action>] <statement> These actions are listed here:

  • CONSOLE - entered statement will be executed from console

  • PLAYER - the statement will be executed as player command execution

  • MESSAGE - messages the player with specified text

  • BROADCAST - sends message to all online players

  • ACTIONBAR - shows the text in actionbar for the player (only usable in 1.12+ versions)

  • BOSSBAR - shows the text in bossbar for the player (only usable in 1.12+ versions)

  • TITLE - sends primary title with entered text

  • SUBTITLE - sends secondary title with entered text

  • SOUND - plays specified sound for the player

  • FIREWORK - launches a firework with stated properties above the player

You can use the placeholder %player% which will be replaced by the player's name, %type% will be replaced by reward type, random placeholders and PlaceholderAPI placeholders

The following example is a demonstration of how to use actions in real .yml file of reward:

actions:
    - '[console] give %player% diamond 1' # console will execute the give command for 1 diamond
    - '[console] give %player% iron_ingot %exampleRandom%' # console will execute the give command for random amount of iron ingots
    - '[console] give %player% gold_ingot 3' # console will execute give command for 3 gold ingots
    - '[console] say %player% claimed his %type% reward!' # console will execute say command with speciefied message
    - '[actionbar] &aSuccessfully claimed!' # '&aSuccessfully claimed' message will be shown in player's action bar
    - '[title] &aClaimed' # '&aClaimed' message will be print in a title for the player
    - '[subtitle] &aReward %type%' # '&aReward %type%' message will be print in a subtitle for the player
    - '[sound] BLOCK_CHEST_OPEN' # The sound of the chest opening will be played for the player
    - '[bossbar] &aClaimed %type% reward' # Stated text will appear in boss bar for the claimer
    - '[firework] colors:{FF0000;00FF00;0000FF},type:BALL_LARGE,power:2' # Launches firework with stated colors, type & power above the player

Last updated