UltimateRewards Wiki
  • Getting started
    • Support
  • Addons
  • Configs
    • Player Levels
    • Referrals
    • Loginstreak
  • USAGE
    • Installation
    • Commands
  • configuration
    • Rewards
      • Creating Reward
      • Reward Types
        • Afk Reward
          • World Afk Reward
          • Area Afk Reward
          • Region Afk Reward
        • Advent Calendar
        • Pickable Reward
        • Time Reward
        • Time Fixed Reward
        • Streak Reward
        • Streak Fixed Reward
        • Vote Reward
        • Renewable Vote Reward
        • Per Vote Reward
        • Streak Vote Reward
        • Play Time Reward
        • Renewable Play Time Reward
        • Referral Reward
        • Renewable Referral Reward
        • Purchasable Reward
        • Re-Purchasable Reward
        • One Time Reward
        • Time Limited Reward
        • Custom Reward
        • Multiple Custom Reward
        • Coupon Reward
        • Discord Reward
      • Reward Settings
      • Reward Actions
      • Reward Features
        • Auto Claim
        • Notifications
        • Reward NPC
        • Discord Support
        • Reward Requirements
        • Reward Variants
        • Selectable Rewards
        • Randomization
          • Execution Chances
          • Random Placeholders
        • AFK Checkers
        • Leaderboards
    • Menus
      • Basics
      • Example of GUIs
      • Setting Menu
    • Schedules & Timers
  • Colors & Models
  • Placeholders
  • API
    • Events
    • Examples
    • Setting up own playtime calculator
  • Policies
    • TOS
Powered by GitBook
On this page
  1. configuration
  2. Rewards

Reward Actions

Action types of rewards

PreviousReward SettingsNextReward Features

Last updated 9 months ago

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, 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

random placeholders