Omni-bot Map Goals
From Omni-bot Wiki
| Main Page | Omni-bot Map Goals |
|
What are map goals?
Map goals are locations in the map that represent something for the bot to do. Capturing the flag is a map goal, an attack point is a map goal, a defend point is a map goal. They are called map goals because they are specific locations specific to the map. They may be generated from specific flags placed on waypoints, or they may be generated automatically by being detected by the bot during initialization.
Regardless of where they come from, they will all end up as map goals, and their availability will be dependent on how they are detected.
You can see a list of map goals by executing 'bot show_goals' command in the game console. This will display all the goals and their availability status.
How do they work?
Map goals are either detected automatically, or are a result of flagging certain waypoints with flags. Flagging a waypoint with the 'attack' flag for example will result in an attack map goal being created. This allows the waypointer to influence bot behavior by setting up some objectives manually. Alternately, many goal types are detected automatically whenever possible, depending on the game. Examples of this include the constructables, mg42s, and checkpoints in Enemy Territory, and flags and capture points in most supported games.
In most cases, the goal have all the information it needs without further input, and can operate correctly. Some goals have additional options that can be set that are specific to that goal type. For map goals that originate from waypoints, that means additional named properties being placed on the waypoints. For goals automatically detected, these properties must be set via script.
The lists below will outline each map goal and detail any additional properties that can be set on them.
Common Map Goals
Attack
Attack goals allow a bot to move to a position and attempt to camp it for a brief period of time before moving on.
- Properties
- Stance - "Stand", "Crouch", or "Prone"
- MinCampTime - minimum time, in seconds, to camp here - default 2 seconds
- MaxCampTime - maximum time, in seconds, to camp here - default 5 seconds
Defend
Defend goals allow a bot to move to a position and attempt to camp it for an extended period of time before moving on.
- Properties
- Stance - "Stand", "Crouch", or "Prone"
- MinCampTime - minimum time, in seconds, to camp here - default 5 seconds
- MaxCampTime - maximum time, in seconds, to camp here - default 10 seconds
CaptureTheFlag
The CaptureTheFlag goal handles various aspects of going to pick up an enemy flag if available, and take it to a capture or hold point.
- No Properties
ReturnTheFlag
This goal is generally dynamically generated when a flag is dropped if the owning team is capable of touching the flag to return it.
- No Properties
Snipe
- Properties
- Stance - "Stand", "Crouch", or "Prone"
- MinCampTime - minimum time, in seconds, to camp here - default 6 seconds
- MaxCampTime - maximum time, in seconds, to camp here - default 10 seconds
Enemy Territory Map Goals
BuildConstruction
This goal handles the bot constructing various map features using the engineer pliers.
- Properties
- Crouch - crouch while building, default false
- Prone - prone while building, default false
- IgnoreTargets - ignore targets while building, default false
MountMg42
This goal allows the bot to mount a stationary Mg42 emplacement and fire on enemies.
- Properties
- IgnoreTargets - ignore target to mount, default false
- MinCampTime - minimum time, in seconds, to camp here - default 20 seconds
- MaxCampTime - maximum time, in seconds, to camp here - default 30 seconds
RepairMg42
This goal allows engineer bots to repair broken Mg42 emplacements.
- Properties
- IgnoreTargets - ignore targets while repairing, default false
PlantExplosive
This goal handles both setting dynamite for engineers and setting satchel charges for covert ops on various targets around the map.
- Properties
- IgnoreTargets - ignore targets while planting, default false
TakeCheckpoint
This goal allows a bot to move to a checkpoint to attempt to capture it for their team.
- No Properties
ReviveTeammate
This goal allows a medic to revive a fallen teammate on the battlefield.
- No Properties
MobileMg42
- Properties
- MinCampTime - minimum time, in seconds, to camp here - default 20 seconds
- MaxCampTime - maximum time, in seconds, to camp here - default 30 seconds
MobileMortar
This goal represents a position on a map to set up a mobile mortar, and to fire mortar rounds randomly along up to 12 pre-defined aim vectors. Useful for setting up a mortar barrage on an unseen area of the map.
- Properties
- MortarAim0 - aim vector for a shot of the mortar
- MortarAim1 - aim vector for a shot of the mortar
- MortarAim2 - aim vector for a shot of the mortar
- MortarAim3 - aim vector for a shot of the mortar
- MortarAim4 - aim vector for a shot of the mortar
- MortarAim5 - aim vector for a shot of the mortar
- MortarAim6 - aim vector for a shot of the mortar
- MortarAim7 - aim vector for a shot of the mortar
- MortarAim8 - aim vector for a shot of the mortar
- MortarAim9 - aim vector for a shot of the mortar
- MortarAim10 - aim vector for a shot of the mortar
- MortarAim11 - aim vector for a shot of the mortar
Only 1 aim vector is required, though up to 12 is supported. That means that however many that are available, the mortar goal will choose a random aim vector for each shot.
setup: the easiest way to set these up is to grab a mortar and deploy it at the waypoint
- then aim the mortar and type /bot waypoint_setproperty mortartaim0 <facing>
- this should automatically get your current facing and set the property
- for the second facing, use mortaraim1 and the third would be mortaraim2, and so on up to mortaraim11
note: if there are valid mortar goals available for a team, soldier bots should automatically switch to using the mortar.
note2: be sure to set the waypoint facing as well otherwise the bot will either be facing the wrong way or possibly stand at the waypoint without setting the mobile mortar
PlantLandmine
This goal allows landmines to be built at certain areas of the map.
- No Properties
CallArtillery
This goal represents a position to wait at in order to call in an artillery strike. Artillery strikes can be called on static artillery target goals, or dynamic ones. Dynamic artillery targets are areas the bot will watch for enemy activity before calling it. Static targets are called in immediately.
- Properties
- MinCampTime - minimum time, in seconds, to camp here - default 1 seconds
- MaxCampTime - maximum time, in seconds, to camp here - default 2 seconds
Flamethrower
Specialized version of an attack goal, only allows the user to approach with the flamethrower equipped. This goal will likely be deprecated in the future in favor of additional weapon properties on the Attack and Defend goals.
- Properties
- MinCampTime - minimum time, in seconds, to camp here - default 2 seconds
- MaxCampTime - maximum time, in seconds, to camp here - default 8 seconds
Panzer
Specialized version of an attack goal, only allows the user to approach with the panzerfaust equipped. This goal will likely be deprecated in the future in favor of additional weapon properties on the Attack and Defend goals.
- Properties
- MinCampTime - minimum time, in seconds, to camp here - default 2 seconds
- MaxCampTime - maximum time, in seconds, to camp here - default 8 seconds