Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rbxweb.net/llms.txt

Use this file to discover all available pages before exploring further.

A competition is a timed contest where members submit images in a chosen channel and others vote with a reaction emoji. When the timer ends, the bot selects winners automatically (highest vote count) or hands off to a moderator for a manual pick. Open Dashboard → Competition. Multiple cards cover different parts of the flow: core settings, winner announcement, reminder and status updates, and access / premium options.

Lifecycle

1

Configure settings

Fill in the core settings, winner announcement embed, and optional reminder. Save.
2

Click Start Competition

The bot posts the competition embed in the chosen channel and starts the timer.
3

Members submit and vote

Members upload images to the competition channel. Others react with the configured emoji to vote.
4

Competition ends

When the end time hits, the bot picks winners per the configured mode, posts the winner announcement, optionally runs reminders and random-voter reveals.
Use /competition_control in Discord to stop a running competition, check its status, or force-end early.

Core settings

Competition Title
text (required, 256 chars)
Headline shown in the opening embed.
Theme
text (optional, 256 chars)
Subtitle or guiding theme entries should follow. Shown in the opening embed.
Prizes
list of up to 10 strings
Optional prize description per place. Only the first N prize lines are shown in the announcement, matching the configured number of winners.
Competition Channel
channel picker (required)
Where entries are submitted, votes are cast, and the opening embed is posted.
End Date & Time
date + time (required)
When the competition ends. Interpreted in your local timezone.
Vote Reaction Emoji
standard Discord emoji (required)
The reaction members use to vote. Only one emoji; only standard Discord emoji (not custom server emoji).
Embed Color
color picker
Left-border color of the opening embed.
Start Ping Role
role picker (optional)
A role mentioned in the opening message when the competition starts.
Number of Winners
number, 1 to 10 (required)
How many winners are picked when the competition ends.

Winner selection mode

Winner Selection Mode
select
Automatic — bot picks the top N entries by vote count. Moderator Pick — after voting ends, a mod selects winners from the top entries via a button.

Automatic mode sub-settings

Tiebreak Mode
select
Random — pick randomly among tied entries. Reaction Poll — post a new poll for the tied entries and let voters decide the winner.
Poll Duration (hours)
number, 1 to 48
Only shown when tiebreak is Reaction Poll. How long the tiebreak poll lasts.
Tie-Break Ping Roles
role list (optional)
Roles mentioned when a tiebreak poll starts.

Moderator-pick mode sub-settings

Moderator Ping Role
role picker (optional)
Role mentioned when the mod-pick prompt appears.
Allowed Moderators
role list (optional)
Roles allowed to click the winner-pick button. Leave empty to allow all admins.

Winner announcement

Announcement Title
text (256 chars)
Title of the winner-announcement embed. Supports placeholders including {winner}, {winner_name}, {votes}, {title}, {prize}.
Announcement Message
textarea (optional, 4096 chars)
Body of the announcement embed. Same placeholder set.
Announcement Color
color picker
Left-border color of the announcement embed.
Announcement Channel
channel picker (optional)
Where the announcement is posted. Defaults to the competition channel if left empty.
Add Role to Winner
role list (up to 4)
Roles assigned to each winner when the competition ends. Useful for giving winners a badge or access role.

Pre-end reminder and status updates

A reminder is a single embed posted N hours before the end. Status updates are periodic standings posted at a regular interval while the competition runs.

Reminder

Enable reminder
toggle
Master switch for the reminder embed.
Reminder Title / Message
embed fields
Title and body of the reminder embed. Placeholders include {hours}, {ends_at}, {title}, {channel}.
Hours Before End
number, 1 to 48
How many hours before the competition ends to post the reminder.
Reminder Channel
channel picker (optional)
Where the reminder is posted. Defaults to the competition channel.
Ping Role
role picker (optional)
Role mentioned when the reminder fires.
Reminder Image
URL or library picker
Large image shown in the reminder embed.
Reminder Embed Color
color picker
Left-border color of the reminder embed.

Periodic status updates

Enable periodic updates
toggle
Master switch for status updates.
Interval (hours)
number, 1 to 72
How often standings are posted during the competition.
Updates Channel
channel picker (optional)
Where standings are posted. Defaults to the competition channel.

Other settings

Allowed Participant Roles
role list (optional)
Only members with at least one of these roles can submit entries or vote. Leave empty to allow everyone.
Banned Roles
role list
Members with any of these roles are blocked from entering or voting. Admins are exempt.
Image Only During Competition
toggle
While the competition is running, non-image messages are deleted from the competition channel.
Bypass Code
text (optional)
A code like $novote that mods can include in a message to bypass the image-only filter. Only works for moderators and above.
Lock channel on End
toggle
After the competition ends, the channel is locked so members can no longer post.
Lock Bypass Roles
role list (optional)
Roles that can still post after the channel is locked. Admins are always exempt.
Minimum Server Age Gate
toggle + number
Require members to have been in the server for at least N days before voting or entering. Useful against raid accounts.
Votes Log
toggle + channel picker
When on, every vote cast or removed is logged to the chosen channel. Useful for auditing fairness.
Random Voter Selection
toggle
After the winner is announced, the bot picks a random voter from the winning entry’s reactions and reveals their identity in a 3-step animated sequence. Good for a second prize.

Private threads

Create private thread for the winner
toggle + sub-settings
When a competition ends, the bot creates a private thread for the winner(s) inside a chosen parent channel.Sub-settings:
  • Thread parent channel — where the thread is created.
  • Thread archive duration — 1 hour, 1 day, or 3 days.
  • Thread layout — single shared thread for all winners, or one thread per winner.
  • Extra users to invite — paste user IDs of staff who should also have access (the server owner is added automatically).
Private thread for random voter
toggle + sub-settings
Same pattern as the winner thread, but for the random voter chosen by Random Voter Selection. Requires Random Voter Selection to also be enabled at runtime.
Threads inherit permissions from the parent channel. Make sure the parent channel is visible to the winner(s) / voter and allows them to send messages, or they won’t see the thread.

Presets

If your plan includes preset quota, the Load Preset and Save as Preset cards appear at the top and bottom of the page. Save a fully-configured competition once, then fill the entire form with a single click the next time. Presets are per-server.

Control from Discord

/competition_control has sub-commands for:
  • status — show time remaining, entry count, top entries.
  • stop — end the competition immediately (picks winners as if time had expired).
  • cancel — stop and discard without picking winners.