Skip to content
StreamElements Docs

Raffle Module

The Raffle module is an interactive chat game that allows streamers to engage their audience. Moderators can initiate a raffle, and viewers can join for a chance to win. This feature is great for giveaways, selecting participants for games, or simply adding fun interaction to your stream.

How It Works

Section titled “How It Works”
  1. A moderator starts the raffle using !raffle (multiple winners) or !sraffle (single winner).
  2. Viewers join the raffle by typing !join in chat. Joining is free — the points are the prize, not an entry fee.
  3. After a set time, the raffle ends, and winner(s) are randomly selected.
  4. The winner(s) are announced in chat and awarded the prize points.

Examples

Section titled “Examples”

Single-winner raffle:

Example chat
moderator badgeModUser:!sraffle
partner badgemoderator badgeStreamElements:A raffle has started! Type !join to enter.
Viewer1:!join
Viewer2:!join
partner badgemoderator badgeStreamElements:The raffle has ended. The winner is Viewer2!

Multi-winner raffle:

Example chat
moderator badgeModUser:!raffle
partner badgemoderator badgeStreamElements:A multi-winner raffle has started! Type !join to enter.
Multiple viewers join the raffle.
partner badgemoderator badgeStreamElements:The raffle has ended. The winners are Viewer3, Viewer7, and Viewer12!

Parameters

Section titled “Parameters”
  • !raffle [points] [duration]: Start a multi-winner raffle. The points are the prize pot (default: 5000), which is split evenly among the winners.
  • !sraffle [points] [duration]: Start a single-winner raffle. The winner receives the full prize (default: 1000 points).

For both commands, the optional duration is given in seconds. If omitted, the duration configured in the dashboard is used; the minimum duration is 5 seconds. The prize is capped at the maximum amount configured in the dashboard, and can never exceed 1,000,000 points.

Configuration

Section titled “Configuration”

The raffle messages can be customized in the StreamElements dashboard. The start and running messages support the {points} and {time} placeholders, and the end message supports {winner} (the winner names) and {points} (the amount awarded to each winner).

Section titled “Related Commands”
  • !raffle: Starts a multi-winner raffle.
  • !sraffle: Starts a single-winner raffle.
  • !join: Used by viewers to enter an ongoing raffle for free.
  • !cancelraffle: Cancels the current raffle (moderators only).

FAQ

Section titled “FAQ”

Q: How are winners determined in multi-winner raffles? A: The number of winners scales based on the number of participants:

  • Over 200 participants: 1 winner per 20 entrants
  • 51-200 participants: 1 winner per 8 entrants
  • 21-50 participants: 1 winner per 5 entrants
  • 11-20 participants: 1 winner per 4 entrants
  • 2-10 participants: Half the participants win (rounded down)
  • 1 participant: That participant wins

Q: Does it cost points to enter a raffle? A: No. Entering with !join is completely free, and each viewer can enter once. The points are awarded to the winner(s) when the raffle ends.

Q: Can I customize the raffle duration? A: Yes, you can specify the duration in seconds when starting a raffle, e.g., !raffle 5000 120 for a 5000 point raffle that runs for 2 minutes.

Q: How do I prevent the same person from winning multiple times? A: The Raffle module automatically ensures that each participant can only win once per raffle.