Skip to content

Map Goals

jswigart edited this page Apr 15, 2018 · 1 revision

What are Map Goals?

Map goals are locations in the map that represent behavior for the bot to perform. The types of map goals can vary by game mode, but generally speaking, there is a map goal associated with any particular behavior that can be performed by a bot, such as attacking, defending, capturing the flag, etc. They are called map goals because they are defined spatially within the context of each map, usually by whoever creates the waypoints for the map and/or does the scripting for the map.

Render Map Goals

Map Goals can be visualized in the game world with the following command in the game console

bot draw_goals on

This command will enable rendering of all goals. Goals can define their own rendering logic in their scripts, but are generally represented in-game as vertical lines that represent the position, and text and/or other lines that represent other parameters of the goal, such as facing, name, stance, etc.

Print Map Goals

You can also view a list of goals by typing this in the game console

bot show_goals

How do they work?

Map goals are either detected automatically, or are a result of manually adding a goal such as attack or defend. Previous to version 0.8 this was done by adding a flag to a waypoint but this has been rendered obsolete by the introduction of the goals script file.

In most cases, the goal has 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. Consult the documentation for each map goal for an explanation of what functionality and parameters it might support.

User Defined Map Goals

Although there are a set of some map goals that are specific to a game mode, and some that are more general(like attack/defend), it is also possible to create an entirely new map goal via scripting, so that it can be placed and configured like any other, and control bot behavior during execution of it.

Consult the Shared or game specific map goals documentation for information on what map goals are available and how they are configured for the game mode you are playing.

Clone this wiki locally