Difference between revisions of "Tournaments"

From Gladiabots Wiki
Jump to: navigation, search
(→‎Special rules)
(15 intermediate revisions by the same user not shown)
Line 5: Line 5:
 
== 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] and login to your Toornament account.
+
== Enable automatic synchronisation ==
  
 +
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 ====
 +
 
 +
Overrides the default bot team sizes.
 +
 
 +
Key: TeamSize.
  
 +
Supported values: any integer value between 1 and 20.
  
−
At this point, the tournament will not appear anywhere until you publish it.
+
Default value: none (= game mode default team size).
  
−
=== Publish ===
+
==== Match games creation method ====
  
−
Once you're happy with your tournament setup, you can publish it.
+
Sets if match games should all be created at once.
  
−
[[File:Create tournament4.jpg||1000px]]
+
Key: CreateAllMatchGamesAtOnce.
  
−
# Select the "Status" button.
+
Supported values: 0/1.
  
 +
Default value: 0 (= wait for previous game to be resolved before creating the next one).
  
−
[[File:Create tournament5.jpg||1000px]]
+
==== Rules example ====
  
−
# Enter a start date (today).
+
Here's an example of rules:
−
# Click the "Publish" button.
+
  
 +
<code>#AutoDeployTimeout=3600</code>
  
−
Your tournament should now appear in game in the "Career" screen under the "Tournaments" tab.
+
<code>#GameMode=Elimination</code>
  
−
=== Manage registrations ===
+
<code>#My First Stage:AutoDeployTimeout=600</code>
  
−
You can manage the player registrations in the "Registrations" section.
+
<code>#My First Stage:GameMode=Domination</code>
  
−
=== Choose a structure ===
+
<code>#My Second Stage:GameMode=Collection</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. You can find informations 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. The most commonly used format is "Best of 3".
+
* 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"