Step 1 - Host a battleground

Hosting a battleground in your server is as easy as executing the /battleground host command in Discord.

Hosted battleground arena with default settings

You can only create one battleground per channel.

Battleground options

When hosting a battleground arena in your server there are a couple of settings you can tweak:

countdown
number

Countdown duration in minutes before the arena starts. If omitted, the /battleground start command has to be called to start the arena.

min-players
number
default:5

Minimum number of players required for the arena.

start-on-min-players
boolean
default:false

Whether to start the arena automatically when the minimum number of players is reached.

automated
boolean
default:false

Whether a new, identical arena should be created automatically after the previous one has ended.

ping-role
role

Role to ping when arena is created.

required-role
role

Role required to join the arena.

template
string

Template to use for the arena. It’s used to customize emojis, phrases and events in your arena. See customization for details.

Recipes

Below are some of the most common ways to utilize battlegrounds in your server.

Repeating battles

For example, to create an automated battle that repeats every hour and requires at least 10 players to start:

  • countdown: 60
  • min-players: 10

Giga battle

A battle that starts only once in a while, when a large number of players join:

  • min-players: 100
  • start-on-min-players: True

Premium battles

Battles only specific members from your server can join:

  • required-role: @Premium

Step 2 - Set permissions

By default, only admins can host and manage battlegrounds in your server. If you wish to also allow your server mods to create the battlegrounds, you can do so via control panel in Discord.

Simply go to ⚙️ settings > ⚔️ battleground > 🔐 permissions until you are here:

Battleground permission settings in the control panel

What’s next?

Learn how to add rewards to your battlegrounds, customize them, and add bounties.