Reward event

Triggered by templates with events.reward-event: true. Players type a configured word in chat; the first N receive the reward commands. A bossbar + actionbar countdown keeps the event visible.

Configuration

config.yml

reward-event:
  words:
    - "gg"

  players-write-word: 30
  ignore-case: true

  cooldown:
    enabled: true
    time: 10

  bossbar:
    enabled: true
    text: "&#FFE264Type 'gg' to get rewarded &7(%write_now%/%write_total%)"
    color: GREEN
    style: SOLID

  actionbar:
    enabled: true
    text: "&aWrite GG in chat! &7(%write_now%/%write_total%)"

  null-players: "&cNo players participated"

  players-rewards-commands:
    - "give %player% minecraft:diamond 1"

  final-message:
    enabled: true
    message:
      - "<empty>"
      - "<center>&#1BFF7E&lREWARD EVENT 🎉</center>"
      - "<center>&#FFE264👑 &f%players_reward_claimed%</center>"
      - "<empty>"

Fields

Key	Description
words	Accepted words. One per entry.
players-write-word	Max unique players rewarded. Event ends on hit.
ignore-case	Treat gg / GG / Gg as the same word.
cooldown.time	Seconds before the event auto-ends.
bossbar / actionbar	Live progress UI. Same field set as templates.
null-players	Broadcast when nobody participated.
players-rewards-commands	Console commands run per participant. %player% is the name.
final-message	Broadcast at the end. Supports <center> and <empty>.

Placeholders

Placeholder	Value
%write_now%	Players who wrote so far.
%write_total%	Configured players-write-word.
%players_reward_claimed%	Comma-separated list of rewarded players.

Tip

For big public events lower players-write-word and shorten cooldown.time so the event feels snappy. For small servers, raise both so everyone online has a real chance.

Danger

players-rewards-commands runs from console for every participant. A typo like op %player% will hand out OP to the entire chat. Test on a staging server before going live.

Reward ideas

Pair the event with whatever your economy plugin exposes — these all run as console commands:

players-rewards-commands:
  - "give %player% minecraft:diamond 1"          # vanilla
  - "eco give %player% 500"                      # EssentialsX
  - "lp user %player% permission settemp vip 1h" # LuckPerms timed perk
  - "crate give %player% common 1"               # ExcellentCrates