# Game mechanics

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

## Basics

Gladiabots is a game between two players the blue and the red team. Both players assign bot classes and programs to each bot starting position of their team. Once they deploy their settings for a match it all depends on their robots and the programs to win the match by destroying enemy bots or by capturing resources.

## Maps

Best score map: Set your priorities

Each map contains one or more bot starting positions for each team. Optionally maps can contain team bases and resources. Normally the same amount of bot starting positions and team bases are used for each team and the map objects have usually reflectional or rotational symmetry. Two starting positions or team bases that are symmetric belong to different teams. There exists an instantiation order for the bot starting positions rarely used in the game.

Each map has a size of 50x50 meters. If a bot touches the borders of a map, it will explode.

Only a subset of all maps is used for each league and for unranked games in career as well as for sandbox mode.

## Game modes

### Elimination

The objective is to destroy more bots than the other team within the time limit. Bots can be destroyed by shooting them until they lost their shield and health or by pushing them to the map borders. A game is evaluated as a draw if no team could destroy more bots than the other team after the time limit. The shield or health state of bots is not relevant to this objective.

### Best score

The objective is to gather more resources than the other team within the time limit. Resources can be gathered by picking them up and moving them to an allied base. A game is evaluated as a draw if no team could gather more resources than the other team after the time limit. Neither the shield or health state of bots nor the count of remaining bots is relevant to this objective.

## Bot actions

During each second, there are 4 cycles (or ticks) where the bot decides its next action. Once the bot has decided its action, it will execute this action for the entire duration of the tick. In every tick the bot can decide whether or not to:

• attack an enemy
• move towards an object
• flee from an object
• catch a resource (or pick up a resource)
• drop a resource
• secure a resource (or score a resource) to an ally base
• tag or team tag an object
• untag or team untag an object
• or even decide to do nothing

### Detecting bot actions and edge cases

Outside of a few edge cases, a bot can detect and use the action another bot or itself was doing in the previous tick to make its decision. However, there are some edge cases that doesn't follow the conventional logic of the actions: (whether it is detecting actions or executing them)

• In the very first tick of the game all bots are detected as idling.
• If a bot is moving to an object that it can reach within the current tick, it will move there and idle for the rest of the tick. This action will still be detected as moving, even if the unit has already started the tick at the destination and does not move at all.
• The closest 2 bots can get to each other is restricted by the collision model. The collision model of a bot is a circle with a radius of 0.3 meters for Assault, Shotgun and Sniper and 0.4 meters for Machinegun.
• If one bot moves to another bot and touches it, it will not push the other bot. It will be detected as idle by other bots.
• If one bot tries to pass another bot at a very small distance, the two bots will collide and get pushed away from each other.
• If a bot is catching a resource, it will move to that resource until it is within the range where it then picks up the resource and goes into idle. While moving to the resource, it will be detected as moving to the resource. However, on the tick that it picks up the resource, it will be detected as idle unless it picks up the resource at the very end of a tick.
• Securing a resource follows similar rules to catching a resource, with the difference being that it moves to the base instead of a resource. Also, a bot will refuse to secure a resource if it doesn't have a resource picked up already.
• Both catching and securing a resource can be done 0.5 meters away from the resource or base.
• If bots from different teams are close enough to pick up the same resource and try to do so, neither one will do so, and they will idle instead.
• If several bots from the same team try to pick up the same resource the instantiation order defines who takes it. If a bot cannot pick up the resource it idles instead.
• The actions dropping a resource or tagging an object don't have their own action to detect, and simply are detected as idle.
• Both aiming and attacking are detected as attacking. There is no way to detect the difference.

## Shooting process

When shooting a bot is able to hit another bot up to a distance of 15 meters. This distance is divided in short range (up to 3 meters), medium range (3 to 8 meters) and long range (8 to 15 meters). Although the bot classes have very different shooting behavior, they all share the same shooting process:

1. The bot will start aiming for the time of their aiming duration.
2. They will fire a bullet or group of bullets according to the bullet configuration.
• Each bullet will either hit with the attack power or miss completely according to the precision.
• The bots precision counter will increment by its precision value. The precision value is determined by what range the target is in at the moment the bullet is fired. There is no difference in the precision value if the target is in the close or further away area of a range. For example targets with a distance of 3.5 and 7.5 meters are both evaluated as mid range. If the target is out of range, the precision value is 0.
• If the precision counter is greater or equal to 100 the bullet will hit and the precision counter will be decremented by 100. Otherwise the bullet will miss.
• If bullets are shot exactly at the beginning of a tick, then the AI evaluation is postponed until the bullets are fired.
• If they have another shot to take during the attack cycle, they will then wait for the time between shots and repeat step 2. The total time spent shooting all bullets is the attack duration.
3. continue with 1.

At the start of a match the precision counter for every bot is 0. There is no reset of the precision counter if there is a target switch or if the shooting process is interrupted.

Bullets travel through the air with a speed of 40 meters per second.

### Sniper misses

Tick and bullet timing

The bot class Sniper has an accuracy of 100% for short, mid and long range. Bullet accuracy is computed at the moment it is shot so movement of the target after the shot is fired won't change the result. But it can still happen, that a Sniper never shooting out of range misses it's target. The reason is that bots check the AI only at the beginning of the ticks. However bullets can be fired at the mid or end of a tick.

Example:

• Sniper attacks (or aims at) a Shotgun for 11 ticks.
• At the beginning of tick 12 the Shotgun is at a range of 14.8 meters.
• Sniper checks it's AI: As the target is still in long range the Sniper continues the attack.
• At the end of tick 12 the Shotgun moved out of range to 15.3 meters.
• The Sniper shoots, but as the target is out of range he misses.

This also affects other bot classes but is most noticeable for the Sniper.

## Health, shield and regeneration

Based on the bot class all bots have a certain amount of health and shield. The shield absorbs damage before you take any damage to your health, and can regenerate after the bot isn't damaged for over 3 seconds. Any damage taken to your health is permanent. A fully destroyed shield regenerates in 3 seconds for any bot.