Skip to Content

Events

A purchase can start a minigame or a reward for everyone online. Events live in events.yml and are picked from a weighted pool.

events.yml
events: enabled: false

Triggers

events.yml
triggers: on-purchase: enabled: true chance: 25 if: "price_raw >= 1" scheduled: enabled: false every-minutes: 120 chance: 100 min-players: 5 command: enabled: true
TriggerFires when
on-purchaseA template with random-event: true runs. chance is a percentage
scheduledEvery every-minutes, if min-players are online
command/aquatebex event run

if is a condition on the purchase. price_raw >= 10 only rolls on purchases of ten or more.

Roll rules

events.yml
roll: no-repeat: 3 global-cooldown-seconds: 300 min-players: 1
KeyWhat it does
no-repeatHow many rolls an event waits before it can repeat
global-cooldown-secondsMinimum gap between any two events
min-playersPlayers needed for any event to start

Event types

Each entry under pool has a type, a weight and its own settings.

TypeWhat happens
chat-wordFirst players to type a word win
triviaA question, first correct answers win
unscrambleA scrambled word to solve
mathA generated sum to answer
reactionType a random code as fast as possible
raffleRandom winners among online players
everyoneReward for everyone, no competition
rouletteSpins a weighted prize table
effectsPotion effects for everyone
fireworksFireworks around players
worldChanges weather and time
commandsRuns commands at start and end, for timed boosts
tebex-couponCreates a real discount coupon in your store
tebex-giftcardCreates a real gift card

weight is relative: an event with 30 is three times more likely than one with 10.

Settings per type

Only settings changes between types. Everything else is in Shared keys.

events.yml
trivia: type: trivia settings: max-winners: 3 seconds: 25 questions: - question: "How many blocks wide is a chunk?" answers: - "16" unscramble: type: unscramble settings: words: [diamond, emerald, netherite] max-winners: 3 seconds: 25 quick-math: type: math settings: max-number: 25 operations: ["+", "-", "*"] max-winners: 1 seconds: 20 reaction: type: reaction settings: code-length: 5 max-winners: 1 seconds: 20 raffle: type: raffle settings: winners: 1 roulette: type: roulette settings: target: buyer prizes: - name: "&7Common" weight: 60 commands: - "give %player% minecraft:iron_ingot 16" - name: "&6Legendary" weight: 10 commands: - "give %player% minecraft:netherite_ingot 1" party-effects: type: effects settings: effects: - type: SPEED seconds: 300 amplifier: 1 fireworks: type: fireworks settings: count: 8 storm: type: world settings: weather: thunder seconds: 180 time: night double-drops: type: commands settings: duration-seconds: 900 start: - "broadcast &aDouble drops for 15 minutes!" end: - "broadcast &7Double drops are over."

everyone has no settings: its rewards.commands run once for each online player. Roulette target is buyer or random, and its prize commands use %player%.

Shared keys

events.yml
gg-race: type: chat-word weight: 30 cooldown-minutes: 10 min-players: 3 settings: words: [gg, ggs] max-winners: 20 seconds: 15 ignore-case: true hide-attempts: false bossbar: enabled: true text: "&#FFE264Type &fGG &7({joined}/{needed}) &8- &f{time_left}s" color: YELLOW style: SEGMENTED_10 actionbar: enabled: false text: "&e{joined}/{needed}" announce: start: - "<center>&#1BFF7E&lEVENT &7- &fType &#FFE264GG</center>" end: - "<center>&#1BFF7E&lWINNERS &7({winner_count})</center>" - "<center>&f{winners}</center>" none: - "<center>&cNobody joined</center>" rewards: commands: - "give {winner} minecraft:diamond 1" message: "&aYou won!"
KeyWhat it does
cooldown-minutesPer event cooldown
min-playersPlayers needed for this one
ifCondition on the purchase, same syntax as the trigger
secondsHow long it stays open
max-winnersHow many players can win
hide-attemptsHides wrong answers from chat
announce.startPrinted when it opens
announce.endPrinted when it closes with winners
announce.nonePrinted when nobody won
rewards.commandsRun once per winner
rewards.messageSent to each winner

Placeholders

PlaceholderAvailable in
{winner}rewards.commands, run once per winner
{winners}announce.end, the full list
{winner_count}announce.end
{answer}trivia, unscramble, math
{prompt}The question, scrambled word or code
{joined} / {needed}Progress in a bossbar or actionbar
{time_left}Seconds remaining
{prize}roulette
{player}The buyer who triggered it
events.yml
bossbar: text: "&fQuestion &7({joined}/{needed}) &8- &f{time_left}s" announce: start: - "<center>&f{prompt}</center>" end: - "<center>&aWinners: &f{winners} &7({winner_count})</center>" - "<center>&7The answer was &f{answer}</center>" rewards: commands: - "give {winner} minecraft:emerald 3"

Tebex coupons and gift cards

These two create real objects in your store through the API.

events.yml
flash-coupon: type: tebex-coupon weight: 8 cooldown-minutes: 180 if: "price_raw >= 10" settings: code: "FLASH-{random:6}" discount-type: percentage amount: 15 effective-on: cart expires-hours: 6 redeem-limit: 10 minimum: 0 basket-type: both announce: end: - "<center>&#FFD41B&lDISCOUNT COUPON</center>" - "<center>&#FFE264{coupon_code}</center>" discord-end: coupon
KeyWhat it does
codeCoupon code. {random:6} inserts six random characters
discount-typepercentage or value
effective-oncart or package
redeem-limitHow many players can use it
basket-typesingle, subscription or both

Coupon placeholders: {coupon_code}, {coupon_amount}, {coupon_uses}, {coupon_hours}. Gift card placeholders: {giftcard_code}, {giftcard_amount}, {giftcard_expires}.

These cost real money. A tebex-giftcard with amount: 5 creates a five unit gift card in your store every time the event rolls. Keep weight low and cooldown-minutes high.

discord-end names a template in discord.yml, so an event can post its own embed instead of the purchase one.

Testing

/aquatebex event list /aquatebex event run gg-race /aquatebex event run random /aquatebex event stop
Last updated: October 27, 2026 bySenkexinff53f17