Rewards Configuration

Overview

PlumDelivery has two types of rewards:

Goal Rewards — Given immediately when a player reaches a milestone
Placement Rewards — Given to top-ranked players when an event ends

Goal Rewards

Goal rewards are configured within each category's goals section:

categories:
  farm:
    goals:
      daily:
        '25':
          commands:
            - "give %player% diamond 2"
            - "say %player% reached 25 points!"

These commands execute immediately when the player reaches the point threshold.

Placement Rewards

Placement rewards are configured in the top-level rewards section:

rewards:
  farm:                              # Category key
    daily:                           # Delivery type
      top-1:                         # Placement (1st place)
        - "give %player% diamond 5"
      top-2:                         # 2nd place
        - "give %player% diamond 3"
      top-3:                         # 3rd place
        - "give %player% diamond 1"
    weekly:
      top-1:
        - "give %player% diamond 32"
    monthly:
      top-1:
        - "give %player% diamond 64"

Command Format

Commands are executed as console commands
Use %player% as the player name placeholder
Commands run without the leading /

Examples

commands:
  - "give %player% diamond 10"           # Give items
  - "eco give %player% 1000"             # Economy (Vault)
  - "lp user %player% permission set vip" # LuckPerms
  - "say %player% won first place!"      # Broadcast
  - "title %player% title {\"text\":\"Winner!\"}" # Title

Placement Keys

Key	Description
`top-1`	1st place
`top-2`	2nd place
`top-3`	3rd place
`top-N`	Nth place

You can add as many placement tiers as you want.

Placement rewards work for offline players too. When an event ends, commands are executed via console using the player's name from their UUID. No player needs to be online to receive their rewards.

Tips

Make sure your reward commands work with offline player names. Most Bukkit commands like give handle this correctly.