Difference between revisions of "Tournaments"

From Gladiabots Wiki
Jump to: navigation, search
(Special rules)
(Permissions)
 
(18 intermediate revisions by the same user not shown)
Line 14: Line 14:
  
 
The following steps are required if you want the matches creation and results synchronisation to be handle automatically by the game.
 
The following steps are required if you want the matches creation and results synchronisation to be handle automatically by the game.
 +
 +
=== Project/Tournament Association ===
 +
 +
Join the #tournaments channel on discord(http://discord.gladiabots.com) and ask the tournament organizers to associate your tournament with the Gladiabots project.
  
 
=== Permissions ===
 
=== Permissions ===
Line 34: Line 38:
 
# Check the "No" option for "Enable Participants Reporting"
 
# Check the "No" option for "Enable Participants Reporting"
 
# Choose your match format (recommended option: "Best-of 3")
 
# Choose your match format (recommended option: "Best-of 3")
# Check the "Yes" option for "Automatically end the match when a winner is known?"
+
# Check the "No" option for "Automatically end the match when a winner is known?"
 
# Choose the "Result-based" calculation method
 
# Choose the "Result-based" calculation method
 
# Click the "Update" button
 
# Click the "Update" button
Line 40: Line 44:
 
[[File:match_settings.jpg||1000px]]
 
[[File:match_settings.jpg||1000px]]
  
=== Special rules ===
+
=== Advanced organizer tools ===
 +
 
 +
To enable the advanced organizer tools, you'll have to install this script: https://openuserjs.org/scripts/GFX47/Gladiabots_tournament_organizer_tools (Tampermonkey extension required -> https://www.tampermonkey.net/).
 +
 
 +
Also, be sure to check for updates on this script before using it.
 +
 
 +
=== Scheduling matches ===
 +
 
 +
First install the advanced organizer tools like described here: https://wiki.gladiabots.com/index.php?title=Tournaments#Advanced_organizer_tools.
 +
 
 +
Then go to your stage settings page. It should add a "Schedule matches" button:
 +
 
 +
[[File:stage_settings.png||1000px]]
 +
 
 +
You'll be asked for the round start time and delay between rounds (usually 1 day).
 +
 
 +
<span style="color:#F00"><b>Use this tool BEFORE placing participants in the stage!</b></span>
 +
 
 +
=== Adding team top players ===
 +
 
 +
First install the advanced organizer tools like described here: https://wiki.gladiabots.com/index.php?title=Tournaments#Advanced_organizer_tools.
 +
 
 +
Then go to the participant list page. It should add a "Add team top players" button:
 +
 
 +
[[File:participant_list.png||1000px]]
 +
 
 +
You'll be asked for the number of players per team.
 +
 
 +
=== Custom rules ===
  
 
You can specify special rules for the whole tournament or by stage.
 
You can specify special rules for the whole tournament or by stage.
Line 68: Line 100:
 
Default value: no auto deploy.
 
Default value: no auto deploy.
  
Examples: 0 (instant deploy), 600 (10 minutes), 3600 (1 hour), 86400 (24 hours).
+
Examples:
 +
 
 +
<code>#AutoDeployTimeout=0</code> (instant deploy)
 +
 
 +
<code>#AutoDeployTimeout=3600</code> (1 hour)
 +
 
 +
<code>#AutoDeployTimeout=86400</code> (24 hours).
  
 
==== Game mode ====
 
==== Game mode ====
Line 79: Line 117:
  
 
Default value: All.
 
Default value: All.
 +
 +
Examples:
 +
 +
<code>#GameMode=Domination</code>
 +
 +
<code>#GameMode=Elimination</code>
  
 
==== Map generation seed ====
 
==== Map generation seed ====
  
If specified, all matches will use this seed to generate the same map.
+
If specified, all matches will use this seed to generate the same map. Several seeds can be set, separated by commas, in this case, one of the seeds will be picked randomly for every match.
  
 
Key: MapGenerationSeed.
 
Key: MapGenerationSeed.
  
Supported values: any numerical value between 1 and 2147483647.
+
Supported values: any numerical value between 1 and 2147483647, or a list of numerical values separated by commas.
  
 
Default value: none (= random map).
 
Default value: none (= random map).
 +
 +
Examples:
 +
 +
<code>#MapGenerationSeed=123456</code> (will always generate the same map)
 +
 +
<code>#MapGenerationSeed=4654321,64654321,1123555</code> (will pick one seed randomly and use it to generate the map)
  
 
==== Mission timeout ====
 
==== Mission timeout ====
Line 99: Line 149:
  
 
Default value: none (= 300 seconds or 5 minutes).
 
Default value: none (= 300 seconds or 5 minutes).
 +
 +
Examples:
 +
 +
<code>#MissionTimeout=60</code> (1 minute)
 +
 +
<code>#MissionTimeout=600</code> (10 minutes)
  
 
==== Respawn availability/delay ====
 
==== Respawn availability/delay ====
Line 110: Line 166:
 
Default value: none (= game mode default respawn availability/delay).
 
Default value: none (= game mode default respawn availability/delay).
  
==== AI max size ====
+
Examples:
 +
 
 +
<code>#RespawnDelay=10</code> (10 seconds)
 +
 
 +
<code>#RespawnDelay=60</code> (1 minute)
 +
 
 +
==== Max AI size ====
  
Overrides the default 500 nodes per bot max size.
+
Overrides the default max AI size per bot (500 nodes).
  
 
Key: MaxAISize.
 
Key: MaxAISize.
Line 119: Line 181:
  
 
Default value: none (= 500 nodes).
 
Default value: none (= 500 nodes).
 +
 +
Examples:
 +
 +
<code>#MaxAISize=10</code>
 +
 +
<code>#MaxAISize=1000</code>
 +
 +
==== Team max AI size ====
 +
 +
Sets the maximum AI size for the whole team (sum of the AI size of each bot).
 +
 +
Key: MaxTeamAISize.
 +
 +
Supported values: any positive integer value.
 +
 +
Default value: none (= no limit).
 +
 +
Examples:
 +
 +
<code>#MaxTeamAISize=10</code>
 +
 +
<code>#MaxTeamAISize=1000</code>
  
 
==== Max bot AI cout ====
 
==== Max bot AI cout ====
Line 129: Line 213:
  
 
Default value: none (= no limit).
 
Default value: none (= no limit).
 +
 +
Examples:
 +
 +
<code>#MaxBotAICount=1</code> (player can only use one common AI for their whole team)
  
 
==== Authorized bot classes ====
 
==== Authorized bot classes ====
Line 137: Line 225:
  
 
Supported values: <class name in camel case>/<max team composition percentage>, ...
 
Supported values: <class name in camel case>/<max team composition percentage>, ...
 
Example: "Assault/100, MachineGun/50". In this case, Assaults and Machine Guns are the only classes accepted, Assaults can represent the whole team, Machine Guns can only represent half of the team.
 
  
 
Default value: none (= default team composition rules).
 
Default value: none (= default team composition rules).
 +
 +
Examples:
 +
 +
<code>#AuthorizedBotClasses=Assault/100,MachineGun/50</code> (Assaults and Machine Guns are the only classes accepted, Assaults can represent the whole team, Machine Guns can only represent half of the team)
 +
 +
<code>#AuthorizedBotClasses=Assault/100,MachineGun/100,Shotgun/100,Sniper/100</code> (no limit)
  
 
==== Team size ====
 
==== Team size ====
Line 151: Line 243:
  
 
Default value: none (= game mode default team size).
 
Default value: none (= game mode default team size).
 +
 +
Examples:
 +
 +
<code>#TeamSize=3</code>
 +
 +
<code>#TeamSize=10</code>
 +
 +
==== Match games creation method ====
 +
 +
Sets if match games should all be created at once.
 +
 +
Key: CreateAllMatchGamesAtOnce.
 +
 +
Supported values: 0/1.
 +
 +
Default value: 0 (= wait for previous game to be resolved before creating the next one).
 +
 +
Examples:
 +
 +
<code>#CreateAllMatchGamesAtOnce=0</code> (wait for previous game to be resolved before creating the next one)
 +
<code>#CreateAllMatchGamesAtOnce=1</code> (creates all games at once)
 +
 +
==== Allow draws ====
 +
 +
Sets if draw matches have to be reported to the Toornament system. This cannot be used in simple or double bracket structures where a winner has to be determined. It can be used in structures like leagues.
 +
 +
Key: AllowDraws.
 +
 +
Supported values: 0/1.
 +
 +
Default value: 0 (= don't report draws and create a new match to determine a winner).
 +
 +
Examples:
 +
 +
<code>#AllowDraws=0</code> (create a new match in case of a draw)
 +
<code>#AllowDraws=1</code> (report draws and don't create a new match)
  
 
==== Rules example ====
 
==== Rules example ====

Latest revision as of 22:38, 11 April 2022

List of tournaments

You can see the list of the previous and current tournaments on the tournaments website. To play or create a tournament one needs to register to the Toornament website.

Create your tournament

Please don't create "test" tournaments. If you create a tournament, you should commit yourself to organizing it until the end. It takes time and rigor to do it properly, you will often deal with inactive participants, fake registrations, etc. Please make the rules as clear as possible before accepting registrations. In any case, please join the #tournaments channel on Discord (http://discord.gladiabots.com) to get help from other organizers and recruit participants.

Follow Toornament's instructions to create a new tournament.

Enable automatic synchronisation

The following steps are required if you want the matches creation and results synchronisation to be handle automatically by the game.

Project/Tournament Association

Join the #tournaments channel on discord(http://discord.gladiabots.com) and ask the tournament organizers to associate your tournament with the Gladiabots project.

Permissions

Add the following permissions to allow the game to create and sync matches.

  1. In the left menu, click the "Settings" button
  2. Click the "Permissions" section
  3. Click the "Add" button
  4. Enter dubois.sebastien@gmail.com in the "User's email" field
  5. Check all the options
  6. Click the "Update" button

Permissions.jpg

Match settings

  1. In the left menu, click the "Settings" button
  2. Click the "Match" section
  3. Check the "No" option for "Enable Participants Reporting"
  4. Choose your match format (recommended option: "Best-of 3")
  5. Check the "No" option for "Automatically end the match when a winner is known?"
  6. Choose the "Result-based" calculation method
  7. Click the "Update" button

Match settings.jpg

Advanced organizer tools

To enable the advanced organizer tools, you'll have to install this script: https://openuserjs.org/scripts/GFX47/Gladiabots_tournament_organizer_tools (Tampermonkey extension required -> https://www.tampermonkey.net/).

Also, be sure to check for updates on this script before using it.

Scheduling matches

First install the advanced organizer tools like described here: https://wiki.gladiabots.com/index.php?title=Tournaments#Advanced_organizer_tools.

Then go to your stage settings page. It should add a "Schedule matches" button:

Stage settings.png

You'll be asked for the round start time and delay between rounds (usually 1 day).

Use this tool BEFORE placing participants in the stage!

Adding team top players

First install the advanced organizer tools like described here: https://wiki.gladiabots.com/index.php?title=Tournaments#Advanced_organizer_tools.

Then go to the participant list page. It should add a "Add team top players" button:

Participant list.png

You'll be asked for the number of players per team.

Custom rules

You can specify special rules for the whole tournament or by stage. Use the "Rules"

  1. In the left menu, click the "Settings" button
  2. Click the "General" section
  3. Click the "Details" tab
  4. Fill the "Rules" field with custom your text and end with the formatted rules (see details below)

Rules.jpg

Here's a list of the supported rules:

Auto-deploy timeout

If specified, the game will try to automatically deploy a team matching the other tournament rules (game mode, etc) for each player when the timeout is reached:

  1. the latest team deployed in the tournament or...
  2. the latest team deployed in a ranked match or...
  3. the latest team deployed in a unranked or private match or...
  4. a 100% assault team with empty AIs

Key: AutoDeployTimeout.

Supported values: numerical value representing the number of seconds before auto-deploy.

Default value: no auto deploy.

Examples:

#AutoDeployTimeout=0 (instant deploy)

#AutoDeployTimeout=3600 (1 hour)

#AutoDeployTimeout=86400 (24 hours).

Game mode

If specified, matches will use this game mode instead of Collection.

Key: GameMode.

Supported values: Elimination, Domination, Collection, All (will cycle through the modes on each match).

Default value: All.

Examples:

#GameMode=Domination

#GameMode=Elimination

Map generation seed

If specified, all matches will use this seed to generate the same map. Several seeds can be set, separated by commas, in this case, one of the seeds will be picked randomly for every match.

Key: MapGenerationSeed.

Supported values: any numerical value between 1 and 2147483647, or a list of numerical values separated by commas.

Default value: none (= random map).

Examples:

#MapGenerationSeed=123456 (will always generate the same map)

#MapGenerationSeed=4654321,64654321,1123555 (will pick one seed randomly and use it to generate the map)

Mission timeout

Overrides the default 5 minutes timeout.

Key: MissionTimeout.

Supported values: any positive integer value (expressed in seconds).

Default value: none (= 300 seconds or 5 minutes).

Examples:

#MissionTimeout=60 (1 minute)

#MissionTimeout=600 (10 minutes)

Respawn availability/delay

Overrides the default respawn availability and delay.

Key: RespawnDelay.

Supported values: 0 = no respawn, positive integer value (expressed in seconds).

Default value: none (= game mode default respawn availability/delay).

Examples:

#RespawnDelay=10 (10 seconds)

#RespawnDelay=60 (1 minute)

Max AI size

Overrides the default max AI size per bot (500 nodes).

Key: MaxAISize.

Supported values: any positive integer value.

Default value: none (= 500 nodes).

Examples:

#MaxAISize=10

#MaxAISize=1000

Team max AI size

Sets the maximum AI size for the whole team (sum of the AI size of each bot).

Key: MaxTeamAISize.

Supported values: any positive integer value.

Default value: none (= no limit).

Examples:

#MaxTeamAISize=10

#MaxTeamAISize=1000

Max bot AI cout

Defines the maximum amount of different bot AIs.

Key: MaxBotAICount.

Supported values: any positive integer value.

Default value: none (= no limit).

Examples:

#MaxBotAICount=1 (player can only use one common AI for their whole team)

Authorized bot classes

Overrides the default team composition rules.

Key: AuthorizedBotClasses.

Supported values: <class name in camel case>/<max team composition percentage>, ...

Default value: none (= default team composition rules).

Examples:

#AuthorizedBotClasses=Assault/100,MachineGun/50 (Assaults and Machine Guns are the only classes accepted, Assaults can represent the whole team, Machine Guns can only represent half of the team)

#AuthorizedBotClasses=Assault/100,MachineGun/100,Shotgun/100,Sniper/100 (no limit)

Team size

Overrides the default bot team sizes.

Key: TeamSize.

Supported values: any integer value between 1 and 20.

Default value: none (= game mode default team size).

Examples:

#TeamSize=3

#TeamSize=10

Match games creation method

Sets if match games should all be created at once.

Key: CreateAllMatchGamesAtOnce.

Supported values: 0/1.

Default value: 0 (= wait for previous game to be resolved before creating the next one).

Examples:

#CreateAllMatchGamesAtOnce=0 (wait for previous game to be resolved before creating the next one) #CreateAllMatchGamesAtOnce=1 (creates all games at once)

Allow draws

Sets if draw matches have to be reported to the Toornament system. This cannot be used in simple or double bracket structures where a winner has to be determined. It can be used in structures like leagues.

Key: AllowDraws.

Supported values: 0/1.

Default value: 0 (= don't report draws and create a new match to determine a winner).

Examples:

#AllowDraws=0 (create a new match in case of a draw) #AllowDraws=1 (report draws and don't create a new match)

Rules example

Here's an example of rules:

#AutoDeployTimeout=3600

#GameMode=Elimination

#My First Stage:AutoDeployTimeout=600

#My First Stage:GameMode=Domination

#My Second Stage:GameMode=Collection

These rules will have the following effects

  • by default, matches will have a 1 hour auto deploy timeout
  • by default, matches will be played in Elimination mode
  • in the "My First Stage" stage, matches will have a 10 minutes auto deploy timeout
  • in the "My First Stage" stage, matches will be played in Domination mode
  • in the "My Second Stage" stage, matches will be played in Collection mode

Note: matches in the "My Seconde Stage" stage will have a 1 hour auto deploy timeout (tournament default value).

FAQ

Why can't I see my tournament in the game's tournament list (https://www.toornament.com/fr/games/gladiabots)?

For a running tournament to appear in the "Ongoing" tab, it needs to have an end date set in the future.