Skip to content
StreamElements Docs

!duel

Twitch
Access
Everyone
Requires
Duel module

The !duel command allows users to challenge another user in chat to a duel, optionally wagering their loyalty points. The challenged user then has 2 minutes to respond using !accept or !deny. If the duel is accepted, the winner is decided by a 50/50 coin flip — the winner gains the wagered points and the loser loses them.

Usage

Section titled “Usage”

To initiate a duel challenge, use the following syntax:

!duel <username> [points]

Examples

Section titled “Examples”
Example chat
Challenger:!duel TargetUser 100
partner badgemoderator badgeStreamElements:@TargetUser, @Challenger wants to duel you for 100 points, you can !accept or !deny within 2 minutes
Example chat
ViewerName:!duel SelfUser 50
partner badgemoderator badgeStreamElements:@SelfUser, you cannot duel yourself Kappa
Example chat
ViewerName:!duel AnotherUser 10000
partner badgemoderator badgeStreamElements:@User, you do not have enough points to duel for 10000.

Parameters

Section titled “Parameters”
  • <username> (Required): The exact username of the user you want to challenge.
  • [points] (Optional): The number of loyalty points you want to wager. There is no minimum and no default — if you leave it out, the duel is played for 0 points. Shorthand values are supported: k for thousands (5k), m for millions (1m), a percentage of your balance (50%), or all. The wager cannot exceed either participant’s current balance, and wagers above the module’s Maximum amount setting are automatically capped to that maximum.

Configuration

Section titled “Configuration”

Within the Duel module settings, you can customize:

  • Maximum amount: The highest number of points users can wager in a single duel.
  • User cooldown: How long (in seconds) an individual user must wait before initiating another duel after participating in one.
  • Global cooldown: How long (in seconds) everyone must wait after a duel finishes before anyone can start a new one.
  • Win message: The chat message displayed when a user wins the duel.
    • Available variables: {winner}, {loser}
  • Points won message: The chat message displayed when points are awarded after a duel.
    • Available variables: {winner}, {loser}, {points}, {pointsname}
Section titled “Related Commands”
  • !accept: Used by the challenged user to accept a duel.
  • !deny: Used by the challenged user to decline a duel.
  • !cancelduel: Used by the challenger to cancel their outgoing duel request.
  • !points: Check your current loyalty points balance.