RaindropCentral — Server monitoring for Minecraft operators

Rewards Config ReferenceUser-focused guide for adding, editing, and removing reward entries in supported config paths.

Scope

This page includes config usage guidance. API implementation details are excluded.

Map-Based Reward TypesThese reward types are supported by default map config parsing.

ITEMRequired: type, item.materialOptional: item.amount

type: ITEM
item:
  material: DIAMOND
  amount: 16

CURRENCYRequired: typeOptional: currencyId, amount

type: CURRENCY
currencyId: vault
amount: 2500

EXPERIENCERequired: typeOptional: amount, experienceType (POINTS|LEVELS)

type: EXPERIENCE
amount: 30
experienceType: LEVELS

COMMANDRequired: type, commandOptional: executeAsPlayer, delayTicks

type: COMMAND
command: "give {player} minecraft:golden_apple 3"
executeAsPlayer: false
delayTicks: 20

COMPOSITERequired: type, rewardsOptional: continueOnError

type: COMPOSITE
continueOnError: true
rewards:
  - type: CURRENCY
    currencyId: vault
    amount: 1000
  - type: EXPERIENCE
    amount: 500
    experienceType: POINTS

CHOICERequired: type, choicesOptional: minimumRequired, maximumRequired, allowMultipleSelections

type: CHOICE
minimumRequired: 1
maximumRequired: 1
allowMultipleSelections: false
choices:
  - type: ITEM
    item:
      material: EMERALD
      amount: 32
  - type: CURRENCY
    currencyId: vault
    amount: 5000

PERMISSIONRequired: type, permissionsOptional: temporary, durationSeconds

type: PERMISSION
permissions:
  - raindrop.rank.veteran
  - raindrop.chat.color
durationSeconds: 86400
temporary: true

Types Not Map-Based by Default

Do not expect these to work in standard map config unless your runtime adds explicit converter support.

SOUNDPARTICLETELEPORTVANISHING_CHEST

Module-Specific Config Notes

RDQ

RDQ config adapter supports ITEM, CURRENCY, EXPERIENCE, COMMAND, COMPOSITE, CHOICE, PERMISSION, and PERK reward sections.

Bounty distribution strategies currently process item rewards only in distribution paths.

If you use CHOICE rewards, selection handling must be present in the route where rewards are granted.

RDR

Current module source does not implement RPlatform rewards integration.

RDS

Current module source does not implement RPlatform rewards integration.

Known Config Caveats

Default map converters do not include SOUND, PARTICLE, TELEPORT, or VANISHING_CHEST.

SOUND may be registered as a core type but is not available in default polymorphic subtype parsing.

CHOICE reward entries require selection flow to grant; defining a CHOICE block alone does not auto-grant one option.

Combined Example

rewards:
  item_reward:
    type: ITEM
    item:
      material: DIAMOND
      amount: 16

  currency_reward:
    type: CURRENCY
    currencyId: vault
    amount: 5000

  experience_reward:
    type: EXPERIENCE
    amount: 15
    experienceType: LEVELS

  command_reward:
    type: COMMAND
    command: "say {player} just claimed a reward!"
    executeAsPlayer: false
    delayTicks: 0

  composite_reward:
    type: COMPOSITE
    continueOnError: true
    rewards:
      - type: ITEM
        item:
          material: EMERALD
          amount: 8
      - type: CURRENCY
        currencyId: vault
        amount: 1000

  choice_reward:
    type: CHOICE
    minimumRequired: 1
    maximumRequired: 1
    allowMultipleSelections: false
    choices:
      - type: ITEM
        item:
          material: GOLDEN_APPLE
          amount: 4
      - type: EXPERIENCE
        amount: 200
        experienceType: POINTS

  permission_reward:
    type: PERMISSION
    permissions:
      - raindrop.cosmetic.sparkles
    durationSeconds: 3600
    temporary: true

Next Steps

Review requirement config typesOpen key plugin file locationsApply changes in RDQ setup files

ON THIS PAGE

Map-Based Reward Types ITEM CURRENCY EXPERIENCE COMMAND COMPOSITE CHOICE PERMISSION Types Not Map-Based by Default Module-Specific Config Notes Known Config Caveats Combined Example Next Steps

type: CHOICE minimumRequired: 1 maximumRequired: 1 allowMultipleSelections: false choices: - type: ITEM item: material: EMERALD amount: 32 - type: CURRENCY currencyId: vault amount: 5000

rewards: item_reward: type: ITEM item: material: DIAMOND amount: 16 currency_reward: type: CURRENCY currencyId: vault amount: 5000 experience_reward: type: EXPERIENCE amount: 15 experienceType: LEVELS command_reward: type: COMMAND command: "say {player} just claimed a reward!" executeAsPlayer: false delayTicks: 0 composite_reward: type: COMPOSITE continueOnError: true rewards: - type: ITEM item: material: EMERALD amount: 8 - type: CURRENCY currencyId: vault amount: 1000 choice_reward: type: CHOICE minimumRequired: 1 maximumRequired: 1 allowMultipleSelections: false choices: - type: ITEM item: material: GOLDEN_APPLE amount: 4 - type: EXPERIENCE amount: 200 experienceType: POINTS permission_reward: type: PERMISSION permissions: - raindrop.cosmetic.sparkles durationSeconds: 3600 temporary: true