Skip to main content

Overview

A preset gives certain roles extra entries (and optionally extra claim time) automatically when a giveaway uses it, no manual weighting needed each time. It can also ask for a level to enter and give extra entries by level, using the leveling system.
kira starts a Nitro giveaway with the boosters preset; the card lists +3 entries and 10 minutes to claim for Server Booster, +1 for Veteran, message level 5 needed and extra entries from level 10 and voice level 20

In Discord: a giveaway started with the boosters preset lists what the preset gives and asks for.

Commands

kira types !giveawaypreset create boosters and Petto answers that the preset was created and how to add roles

In Discord: a preset made.

kira types !giveawaypreset view boosters: Server Booster +3 entries and 10 minutes to claim, Veteran +1, level 10 +2, voice level 20 +3, and message level 5 needed

In Discord: what a preset gives and asks.

kira types !giveawaypreset remove regulars and Petto answers Preset removed

In Discord: a preset deleted.

kira types !giveawaypreset add-role boosters @Server Booster 10m 3 --entries_stack true and Petto answers that Server Booster now grants 3 entries and 10 minutes of claim time

In Discord: a role with extra entries and claim time.

kira types !giveawaypreset remove-role boosters @Veteran and Petto confirms it

In Discord: a role taken out of a preset.

kira types !giveawaypreset add-level boosters 10 2 and Petto answers that from level 10 members get 2 extra entries

In Discord: extra entries from a message level.

kira types !giveawaypreset add-level boosters 20 3 --type voice and Petto answers that from voice level 20 members get 3 extra entries

In Discord: extra entries from a voice level.

kira types !giveawaypreset require-level boosters 5 and Petto answers that boosters asks for message level 5 to enter

In Discord: the level needed to enter.

kira types !giveawaypresetconfig: 2 presets, boosters and regulars, and the preset commands

In Discord: the card of the presets.

Stacking

Each role’s bonus can optionally stack with other matching roles a member has, configurable independently:
  • entries_stack: a member with two bonus roles gets both entry bonuses added together.
  • claim_time_stack: their extended claim window stacks too.
Without stacking (the default for both), only the single best-matching role’s bonus applies.

Levels

Levels come from the leveling system, so it has to be on for members to have a level.
  • require-level <name> [level] [voice_level]: the level a member needs to enter. 0 asks for nothing. A member who is below it is told which level they need, and a reaction entry is taken away.
  • add-level <name> <level> <entries> [type]: from that level, the member gets extra entries. type is messages (the default) or voice, written as --type voice. With 0 entries the step is removed. Up to 25 steps.
  • For each kind of level only the best step a member has reached counts, and the message and voice steps are added. So with steps at level 10 (+1) and 50 (+4), a member at level 60 gets +4, not +5.
  • The extra entries add up with the ones of the roles, and the giveaway message lists what the preset gives and asks for.
Under the giveaway card of the boosters preset Petto answers only to the member that message level 5 is needed and they are level 3

In Discord: a member below the level presses Enter Giveaway.

The dashboard has all of this in each preset, under Levels.
The boosters preset with its two roles, the message level needed 5, voice level 0, the steps Level 10+ +2 and Voice level 20+ +3, and the forms to add a level and a role

Dashboard → Community → Giveaway Presets: the Levels part of a preset.

The Bonus-entry presets page with three presets, boosters, regulars and voice-night, 3 of 15

Dashboard → Community → Giveaway Presets: each preset with its roles, the levels it needs and its extra entries by level.

Use a preset when starting a giveaway, it’s the preset argument on !giveaway start (see Giveaways).

Limits

A Free server can have 15 giveaway presets and a Premium server 30. !giveawaypreset create and the dashboard both stop at that number. See Premium.
kira types !giveawaypreset create summer and Petto answers that the server already has 15 giveaway presets, the most a free server can have, and Premium raises it to 30

In Discord: a free server with 15 presets tries to make one more.