Giveaways

A giveaway is a message with a Join button. Arclo counts the entries, checks the requirements when somebody enters and their roles again at the draw, picks the winners and announces them, on time, without anybody remembering.

1Creating one

1. 1

   Switch it on

   Server Management → Giveaways.

2. 2

   Use Quick Setup, or the full builder

   Quick Setup is four steps: the prize and how many win, how long it runs (or first come, first served) and who can enter, the message, and the channel. Start giveaway posts it. Extra entries, message, level and invite requirements, winner roles, threads, repeats and scheduling are in the full builder.

3. 3

   Create Giveaway

   Set the prize, the number of winners, the channel and when it ends: after a duration (a number of minutes, hours or days) or at a time you pick, in your own time zone. In /giveaway create a duration is written the normal way: 2d, 12h.

4. 4

   Add requirements, if you want any

   Under Entry requirements: roles, server boosters only, account age, time in the server, level, invite count, and messages sent today, this week, this month or in total.

5. 5

   Design the message

   The requirements block is generated and appended automatically from what you set: roles, boosters only, account age, time in the server, level, invites, message counts, CAPTCHA, bypass and blacklisted roles, and extra entries. A level or invite requirement is listed (and checked) only while Levels or Invite Tracking is switched on.

6. 6

   Publish

   Or Save draft and publish later. To have a giveaway start on its own later, use Schedule Giveaway on the Scheduled tab instead.

#giveaways

ArcloBOTToday at 12:00 PM

Steam Deck OLED

Press the button below to enter! Ends: in 2 days (Sunday at 6:00 PM)Entries: 42Winners: 1Required roles: @RegularAccount age: 30+ days

42Participants

Requirements and bonus entries

Required roles

A member needs at least one of them. Requirement bypass roles skip every requirement; Blacklisted roles can never enter, bypass or not.

Require server boost

Only members boosting the server right now can enter.

Minimum account age / time in server

In days. Keeps a giveaway from being farmed by accounts made this morning.

Required level and invites

Read from Levels and Invite Tracking, counted the way its leaderboard counts. Each is ignored, and left off the message, while its system is switched off.

Message requirements

Messages sent today, this week (Monday to Sunday, UTC), this month or in total. Arclo counts them only while Giveaways or Achievements is switched on, and never counts bots.

Extra entries

Up to 10 rules, each giving the roles you pick +1 to +250 entries. A member gets the highest matching bonus, or all of them added up with Stack entries. A +2 role means three entries, and three times the chance of somebody with one.

Require CAPTCHA completion

An image challenge before the entry counts, for prizes big enough to attract scripts. The code expires after five minutes.

Kinds of giveaway

• Timed: the normal one. Ends after a duration (1 minute to 365 days) or at a moment you set.
• Drop: ends the moment as many members have entered as there are winners, and those first entrants win. First come, first served; an end time becomes optional.
• Scheduled: made on the Scheduled tab with Schedule Giveaway. It starts at a set time or after a delay, once or on a repeat counted from each start, and can be paused from its card. Up to 5 per server.
• Repeating: Repeat this giveaway starts the next run a set time after this one ends (5 minutes to 100 days). It waits on the Scheduled tab, marked Auto-repeat.

Running one

• Editing: change a running giveaway in the builder and press Publish, or use /giveaway edit. The message updates in place, and a new duration still counts from the original start.
• The Participants button opens a private list, ten to a page with the most entries first, with Go To Page and a switch between mentions and names. While it runs, giveaway managers and the giveaway's creator can Remove A Participant (more roles can be allowed in the builder), and the giveaway log records it.
• End now on the giveaway's card, or /giveaway end, ends it immediately and draws the winners.
• Reroll a winner draws one new winner at any time after the draw, leaving out everybody who already won and re-checking roles as the draw does. /giveaway reroll can draw several at once.
• A winner role goes to every winner, and can be taken back after 15 minutes to 365 days. A winner thread, public or private, pulls in the winners and the creator, and can close itself after 5 minutes to 100 days.
• An ended giveaway opens to its results: entries, extra entries, how fast half of them came in, entries over time and the winners, with Duplicate and Reroll a Winner.

Messages

Every message a giveaway sends is designed in its builder, 16 in all: the Giveaway message with its Join and Participants buttons, the Giveaway Ended Message it turns into, the Participants panel, and under Bot messages the winner announcement (which can be switched off), the no-winners notice, the reroll, the winner DM and the winner thread message, plus the private replies for an entry confirmed, already entered (with its Leave Giveaway button), denied, removed, the CAPTCHA prompt and a wrong code, a giveaway already over, and nobody entered yet. Posts in the channel follow the giveaway message's choice of embed or Components V2; the private replies and the winner DM are always embeds.

Placeholders: {prize}, {winners}, {winner_count}, {entries}, {host}, {creator}, {server}, {channel}, {ends_at}, {ends_in}, {started_at}, {ended_at} and {message_link}, plus {your_entries} in the entry replies and {reason} in the refusal.

Templates

Up to 3 per server, on the Giveaways tab under your giveaways. Save as template in the builder keeps the whole configuration: message, options and bot messages. A template marked Default template pre-fills every new giveaway, and Create giveaway on a template's card starts one from it.

Who may run them

Two role lists on the Settings tab, up to 5 roles each, decide who may use /giveaway in Discord: Giveaway creator roles may start giveaways and edit, end, reroll and delete their own; Giveaway manager roles may do all of that to anybody's. Administrators always count as managers. Who may open this page on the dashboard is set by dashboard access instead. Templates and schedules are made on the dashboard, and /giveaway create can start from a template.

The same tab holds the giveaway log, off by default: created, edited, started, ended, rerolled and deleted giveaways, removed participants, template and schedule changes, and scheduled runs that were skipped, with the reason.

Limits

Commands