Giveaways

Creating One

// Syntax
[prefix]giveaway create [channel]

// Example
;giveaway create #giveaways

Serenity walks you through prize, duration and number of winners, then posts the giveaway with a join button.

Entry Conditions

Conditions decide who may enter at all. Everyone else can still see the giveaway — they're told why they can't join when they press the button.

The Building Blocks

Every condition is one of eight kinds. The numeric ones all mean at least, never exactly.

Each kind has short forms — lvl, vl, vt, msgs, accountage, joinage — and the comparison can be written level >= 10, level 10 or level:10, all meaning the same thing. Durations take s, m, h, d and w: voicetime 90m, account 4w.

And, Or, Not

This is the part worth understanding, because it's the difference between a giveaway three people can enter and one everybody can.

Conditions are stored as groups. Inside a group the conditions are alternatives — any one of them is enough. Between groups they all have to hold.

level 20 or voice 10 and role:@VIP

reads as (text level 20 or voice level 10) and has @VIP — or widens the current group, and opens a new one. Parentheses are accepted for readability but change nothing; the storage model is already an and-of-ors, and anything deeper wouldn't survive a round trip.

Any condition can be inverted with not or !:

not booster
!role:@Muted

Setting Them

// Syntax
[prefix]giveaway requirement set [message] [expression]

// Example
;giveaway requirement set [link] level 20 or voice 10 and role:@VIP

set replaces everything with a one-line expression. To build them up one at a time instead:

// Syntax
[prefix]giveaway requirement add [message] [and|or] [condition]

// Example
;giveaway requirement add [link] and level 10
;giveaway requirement add [link] or booster

and starts a new group with that condition, or adds it to the last group.

;giveaway requirement list [link]     // the current expression, in plain english
;giveaway requirement types           // every kind, with its aliases
;giveaway requirement clear [link]    // back to open entry

On the Dashboard

The same conditions are a form on the dashboard, under the server's giveaway page. Instead of an expression you get a dropdown per condition, a role picker, and an Invert condition toggle for not.

Groups are labelled there rather than punctuated — the first group reads Must match one of, every group after it And one of, which is the same logic written out.

Bonus Entries

Bonus entries don't gate anything — they hand extra tickets to people who qualify:

// Syntax
[prefix]giveaway bonus [type] [message] [entries] [value]

// Example
;giveaway bonus booster [link] 2
;giveaway bonus level [link] 3 25

Available for role, booster, level, voicelevel and voicetime — the things a member simply holds, since there's nothing to reward about not having a role. Between 1 and 50 extra entries each, and they stack: a booster who's also level 25 carries both.

Bonus entries are on the dashboard as well, next to the conditions, with the same dropdowns.

;giveaway bonus list [link]
;giveaway bonus clear [link]