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