Difference between revisions of "Tournaments"

From Gladiabots Wiki
Jump to: navigation, search
(Created page with "== List of tournaments == You can see the list of the previous and current tournaments on the [https://tournaments.gladiabots.com tournaments website]. == Create your tourna...")
 
(Special rules)
(16 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
== List of tournaments ==
 
== List of tournaments ==
  
You can see the list of the previous and current tournaments on the [https://tournaments.gladiabots.com tournaments website].
+
You can see the list of the previous and current tournaments on the [https://tournaments.gladiabots.com tournaments website]. To play or create a tournament one needs to register to the [https://www.toornament.com/ Toornament] website.
  
 
== Create your tournament ==
 
== Create your tournament ==
  
=== Create ===
+
<b><span style="color:#F00">
 +
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.
 +
</span></b>
  
First, let's create a new tournament
+
Follow [https://help.toornament.com/starter/your-first-tournament Toornament's instructions] to create a new tournament.
  
Go to the [https://organizer.toornament.com/tournaments/create#/discipline tournament creation page].
+
== Enable automatic synchronisation ==
Login or register to the Toornament website.
+
  
 +
The following steps are required if you want the matches creation and results synchronisation to be handle automatically by the game.
  
[[File:Create tournament1.jpg||1000px]]
+
=== Permissions ===
  
# Search for the "Gladiabots" discipline.
+
Add the following permissions to allow the game to create and sync matches.
# Click the "Gladiabots" discipline button.
+
# Add the "PC" and "Mobile" platforms.
+
# Enter the anticipated number of participants.
+
# Select the "Players" type of participants.
+
# Click the "NEXT" button.
+
  
 +
# In the left menu, click the "Settings" button
 +
# Click the "Permissions" section
 +
# Click the "Add" button
 +
# Enter dubois.sebastien@gmail.com in the "User's email" field
 +
# Check all the options
 +
# Click the "Update" button
  
[[File:Create tournament2.jpg||1000px]]
+
[[File:permissions.jpg||1000px]]
  
# Set your tournament name.
+
=== Match settings ===
# Choose your timezone.
+
# Set your player name.
+
# Click the "NEXT" button.
+
  
 +
# In the left menu, click the "Settings" button
 +
# Click the "Match" section
 +
# Check the "No" option for "Enable Participants Reporting"
 +
# Choose your match format (recommended option: "Best-of 3")
 +
# Check the "Yes" option for "Automatically end the match when a winner is known?"
 +
# Choose the "Result-based" calculation method
 +
# Click the "Update" button
  
[[File:Create tournament3.jpg||1000px]]
+
[[File:match_settings.jpg||1000px]]
  
# Check "Use Toornament to manage registrations" option.
+
=== Special rules ===
# Click the "CREATE" button.
+
  
 +
You can specify special rules for the whole tournament or by stage.
 +
Use the "Rules"
  
[[File:Create tournament6.jpg||1000px]]
+
# In the left menu, click the "Settings" button
 +
# Click the "General" section
 +
# Click the "Details" tab
 +
# Fill the "Rules" field with custom your text and end with the formatted rules (see details below)
  
# Click the "Settings" section
+
[[File:rules.jpg||1000px]]
# Click the "Permissions" sub-section
+
 
# Click the "Add" button
+
Here's a list of the supported rules:
# Enter dubois.sebastien@gmail.com in the "User's email" field
+
 
# Check the "Administrate tournament" option
+
==== Auto-deploy timeout ====
# Click the "Update" button
+
 
 +
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:
 +
# the latest team deployed in the tournament or...
 +
# the latest team deployed in a ranked match or...
 +
# the latest team deployed in a unranked or private match or...
 +
# 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: 0 (instant deploy), 600 (10 minutes), 3600 (1 hour), 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.
 +
 
 +
==== Map generation seed ====
 +
 
 +
If specified, all matches will use this seed to generate the same map.
 +
 
 +
Key: MapGenerationSeed.
 +
 
 +
Supported values: any numerical value between 1 and 2147483647.
 +
 
 +
Default value: none (= random 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).
 +
 
 +
==== 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).
 +
 
 +
==== AI max size ====
 +
 
 +
Overrides the default 500 nodes per bot max size.
 +
 
 +
Key: MaxAISize.
 +
 
 +
Supported values: any positive integer value.
 +
 
 +
Default value: none (= 500 nodes).
 +
 
 +
==== 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).
 +
 
 +
==== Authorized bot classes ====
 +
 
 +
Overrides the default team composition rules.
 +
 
 +
Key: AuthorizedBotClasses.
 +
 
 +
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).
 +
 
 +
==== Team size ====
  
At this point, the tournament will not appear anywhere until you publish it.
+
Overrides the default bot team sizes.
  
 +
Key: TeamSize.
  
=== Publish ===
+
Supported values: any integer value between 1 and 20.
  
Once you're happy with your tournament setup, you can publish it.
+
Default value: none (= game mode default team size).
  
[[File:Create tournament4.jpg||1000px]]
+
==== Match games creation method ====
  
Select the "Status" button.
+
Sets if match games should all be created at once.
  
 +
Key: CreateAllMatchGamesAtOnce.
  
[[File:Create tournament5.jpg||1000px]]
+
Supported values: 0/1.
  
# Enter a start date (today).
+
Default value: 0 (= wait for previous game to be resolved before creating the next one).
# Click the "Publish" button.
+
  
Your tournament should now appear in game in the "Career" screen under the "Tournaments" tab.
+
==== Rules example ====
  
 +
Here's an example of rules:
  
=== Manage registrations ===
+
<code>#AutoDeployTimeout=3600</code>
  
You can manage the player registrations in the "Registrations" section.
+
<code>#GameMode=Elimination</code>
  
 +
<code>#My First Stage:AutoDeployTimeout=600</code>
  
=== Choose a structure ===
+
<code>#My First Stage:GameMode=Domination</code>
  
Once enough players registered, go to the "Structure" section, click the "Create new Stage" button and choose the type of stage your want to use.
+
<code>#My Second Stage:GameMode=Collection</code>
  
You can find infos about the different types of stages on [https://help.toornament.com/structures/which-format-for-my-tournament this page].
+
These rules will have the following effects
  
Don't forget to set the "Match format" in the "Advanced" tab.
+
* by default, matches will have a 1 hour auto deploy timeout
The most commonly used format is "Best of 3".
+
* 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
  
# Then go to the "Placement" section, select the stage you just created.
+
Note: matches in the "My Seconde Stage" stage will have a 1 hour auto deploy timeout (tournament default value).
# Add the registered participants.
+
# Shuffle placements or sort them manually.
+
# Click the "Save" button.
+
  
Everything from now on will be automatically handled by the Gladiabots server.
+
== FAQ ==
  
If you need additional help about a specific section of the Toornament website, please check their [https://help.toornament.com/ help center].
+
===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.

Revision as of 18:02, 14 January 2020

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.

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 "Yes" 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

Special 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: 0 (instant deploy), 600 (10 minutes), 3600 (1 hour), 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.

Map generation seed

If specified, all matches will use this seed to generate the same map.

Key: MapGenerationSeed.

Supported values: any numerical value between 1 and 2147483647.

Default value: none (= random 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).

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).

AI max size

Overrides the default 500 nodes per bot max size.

Key: MaxAISize.

Supported values: any positive integer value.

Default value: none (= 500 nodes).

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).

Authorized bot classes

Overrides the default team composition rules.

Key: AuthorizedBotClasses.

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).

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).

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).

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.