Engagement & games

Discord duel bot: turn-based 1v1 battles with a seasonal rating

Duel Arena settles it in the channel. /duel challenge calls out a member, and the two fight turn by turn with buttons: attack, guard or special. Add an optional coin stake held in escrow, climb the seasonal rating and take the top of the standings when the season ends.

  • Works on the Free plan
  • 1 slash command
  • Set up in the web console
arenaDiscord preview

BotGGBOTToday at 20:14

Duel #31
@Theo to move. Turn ends in 40 seconds. Stake: 200.
Theo
██████░░░░ 58 HP
Energy 3 (special needs 3)
Mira
███████░░░ 71 HP
Energy 1 · guarding
Moves
Mira raises a guard
Theo: Attack deals 14
⚔️Attack🛡️Guard✨SpecialForfeit
A duel in progress

What you get

Three moves, real choices

Attack is steady and builds energy. Guard stops most of the next hit and builds more. Special costs energy, hits hard and may miss.

Optional stakes in escrow

Both stakes are held until the end. The winner takes them minus an optional arena fee, and a draw, a decline or an expiry refunds them.

A seasonal rating

Elo rating, starting at 1000 each season. When a season ends the top 3 are stored, the results can be posted and ratings start over.

No stalling

Letting your turn run out forfeits the duel, and a fight has a move limit: after 40 moves the higher HP wins. An outage never costs anyone a stake.

Hard to farm

Only a set number of duels per pair in 24 hours move ratings, and repeat challenges to the same member have a cooldown, so nobody gets pinged over and over.

Optional gear

Off by default. When an admin enables it, Shop gear adds attack, crit chance and crit damage up to your caps, read once when the duel is accepted.

How it works

  1. Turn on Duel Arena

    Open https://console.botgg.app, choose your server and turn on Duel Arena in the Engagement section. Stakes need the Bank.

  2. Set the rules

    Choose the channel, HP, challenge and turn times, stakes and the arena fee, gear, and how long a season lasts.

  3. Challenge someone

    /duel challenge posts a panel with Accept and Decline. Your stake goes into escrow right away, and your opponent’s on accept. A coin toss picks who moves first.

  4. Fight and climb

    Pick a move each turn until someone hits 0 HP. /duel rating and /duel top show where you stand this season.

A fair fight, turn by turn

Attack deals 10 to 18 damage and hits 90% of the time. Guard stops 60% of the next hit and lasts until the opponent’s next move. Special costs 3 energy, deals 22 to 34 damage, hits 70% of the time and goes through most of a guard. Crits deal 150% damage. Every roll comes from the duel’s stored seed, and a duel freezes its rules when issued, so nothing changes mid-fight.

Stakes are virtual Bank coins, and duels without one work the same way. Staked duels can’t be played in servers that sell coins for real money: live ones are cancelled and refunded, while duels without a stake carry on. Forfeits and timeouts are rated, draws don’t change ratings, and a season can end by date or when staff end it. There are no plan limits, each member fights one live duel at a time, and Flows can react to challenges, results and season ends.

  • /duel challenge: call out a member, with or without a stake
  • /duel rating, /duel top: a rating and the season standings
  • /duel forfeit: give up a fight, or withdraw or decline a challenge

Slash commands

Generated from the bot’s real command definitions. Full list on the commands page.

/duelTurn-based 1v1 duels with a seasonal rating4 subcommands
  • /duel challengememberstake?Challenge a member to a duel
  • /duel ratingmember?Show a member’s rating this season
  • /duel topShow this season’s standings
  • /duel forfeitGive up your duel, or withdraw your challenge

Commands

Frequently asked questions

How do I duel someone on Discord?

Turn on Duel Arena in the BotGG console, then run /duel challenge with a member. They press Accept, and you take turns with the attack, guard and special buttons.

Do duels need coins?

No. A stake is optional. Stakes use virtual Bank coins and are held in escrow until the duel ends.

What if my opponent stops playing?

Letting the turn timer run out forfeits the duel, so they lose it and you win. If the bot itself was down, the turn starts over instead.

How does the rating work?

It’s an Elo rating. Everyone starts each season at 1000, wins and losses move it, and draws don’t. Only a set number of duels per pair per day count.

Does Shop gear affect duels?

Only if an admin enables it, and it’s off by default. Gear is read once when a duel is accepted, so items bought mid-duel don’t count. Broken gear is skipped. If an item has a durability set in the Shop, a finished duel (not a cancelled or declined one) wears the units behind each fighter’s bonus by 1, and /repair fixes them.

What happens to stakes if our server sells coins?

Staked duels can’t be issued or accepted while coins are sold for real money, and live ones are cancelled and refunded. Duels without a stake carry on.

Ready to level up your server?

Add BotGG for free, then switch features on in the web console.