Difference between revisions of "Tournaments"

From Gladiabots Wiki
Jump to: navigation, search
(→‎Create your tournament)
(→‎Special rules)
(12 intermediate revisions by the same user not shown)
Line 4: Line 4:
  
 
== Create your tournament ==
 
== Create your tournament ==
−
 
−
=== PLEASE READ THIS BEFORE CREATING A TOURNAMENT ===
 
  
 
<b><span style="color:#F00">
 
<b><span style="color:#F00">
Line 11: Line 9:
 
</span></b>
 
</span></b>
  
−
=== Create ===
+
Follow [https://help.toornament.com/starter/your-first-tournament Toornament's instructions] to create a new tournament.
  
−
First, let's create a new tournament
+
== Enable automatic synchronisation ==
  
−
Go to the [https://organizer.toornament.com/tournaments/create#/discipline tournament creation page] and login to your Toornament account.
+
The following steps are required if you want the matches creation and results synchronisation to be handle automatically by the game.
  
 +
=== Permissions ===
  
−
[[File:Create tournament1.jpg||1000px]]
+
Add the following permissions to allow the game to create and sync matches.
  
−
# Search for the "Gladiabots" discipline.
+
# In the left menu, click the "Settings" button
−
# Click the "Gladiabots" discipline button.
+
# Click the "Permissions" section
−
# Add the "PC" and "Mobile" platforms.
+
# Click the "Add" button
−
# Enter the anticipated number of participants.
+
# Enter dubois.sebastien@gmail.com in the "User's email" field
−
# Select the "Players" type of participants.
+
# Check all the options
−
# Click the "NEXT" button.
+
# Click the "Update" button
  
 +
[[File:permissions.jpg||1000px]]
  
−
[[File:Create tournament2.jpg||1000px]]
+
=== Match settings ===
  
−
# Set your tournament name.
+
# In the left menu, click the "Settings" button
−
# Choose your timezone.
+
# Click the "Match" section
−
# Set your player name.
+
# Check the "No" option for "Enable Participants Reporting"
−
# Click the "NEXT" button.
+
# 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:match_settings.jpg||1000px]]
  
−
[[File:Create tournament3.jpg||1000px]]
+
=== Special rules ===
  
−
# Check "Use Toornament to manage registrations" option.
+
You can specify special rules for the whole tournament or by stage.
−
# Click the "CREATE" button.
+
Use the "Rules"
  
 +
# 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)
  
−
[[File:Create tournament6.jpg||1000px]]
+
[[File:rules.jpg||1000px]]
  
−
# Click the "Settings" section
+
Here's a list of the supported rules:
−
# Click the "Permissions" sub-section
+
 
−
# Click the "Add" button
+
==== Auto-deploy timeout ====
−
# Enter dubois.sebastien@gmail.com in the "User's email" field
+
 
−
# Check all the options
+
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:
−
# Click the "Update" button
+
# 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 ====
 +
 
 +
Overrides the default bot team sizes.
  
 +
Key: TeamSize.
  
−
At this point, the tournament will not appear anywhere until you publish it.
+
Supported values: any integer value between 1 and 20.
  
−
=== Publish ===
+
Default value: none (= game mode default team size).
  
−
Once you're happy with your tournament setup, you can publish it.
+
==== Match games creation method ====
  
−
[[File:Create tournament4.jpg||1000px]]
+
Sets if match games should all be created at once.
  
−
# Select the "Status" button.
+
Key: CreateAllMatchGamesAtOnce.
  
 +
Supported values: 0/1.
  
−
[[File:Create tournament5.jpg||1000px]]
+
Default value: 0 (= wait for previous game to be resolved before creating the next one).
  
−
# Enter a start date (today).
+
==== Rules example ====
−
# Click the "Publish" button.
+
  
 +
Here's an example of rules:
  
−
Your tournament should now appear in game in the "Career" screen under the "Tournaments" tab.
+
<code>#AutoDeployTimeout=3600</code>
  
−
=== Manage registrations ===
+
<code>#GameMode=Elimination</code>
  
−
You can manage the player registrations in the "Registrations" section.
+
<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 you want to use.
+
<code>#My Second Stage:GameMode=Collection</code>
−
See the [https://help.toornament.com/structures/which-format-for-my-tournament available structures Toornament help page] for more info.
+
  
−
Don't forget to set the match "Format" in the "Match Settings" tab.
+
These rules will have the following effects
−
The most commonly used formats are "Single game" (only one game per match) or "Best of 3" (3 games created, the first one winning 2 games wins the match).
+
−
See the [https://help.toornament.com/match/define-your-match-format match format Toornament help page] for more info.
+
  
−
'''Also very important: set the Calculation option to "Result based"!'''
+
* 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
  
−
# 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.

Retrieved from "https://wiki.gladiabots.com/index.php?title=Tournaments&oldid=4783"