Struct AgentBakedSettings Extends IComponentData

GraphMask graphMask

Graphs that this agent can use.

This field determines which graphs will be considered when searching for the start and end nodes of a path. It is useful in numerous situations, for example if you want to make one graph for small units and one graph for large units, or one graph for people and one graph for ships.

This is a bitmask so if you for example want to make the agent only use graph index 3 then you can set this to: settings.graphMask = GraphMask.FromGraphIndex(3);


Note that this field only stores which graph indices that are allowed. This means that if the graphs change their ordering then this mask may no longer be correct.

If you know the name of the graph you can use the Pathfinding.GraphMask.FromGraphName method: GraphMask mask1 = GraphMask.FromGraphName("My Grid Graph");
GraphMask mask2 = GraphMask.FromGraphName("My Other Grid Graph");

NearestNodeConstraint nn = NearestNodeConstraint.Walkable;

nn.graphMask = mask1 | mask2;

// Find the node closest to somePoint which is either in 'My Grid Graph' OR in 'My Other Grid Graph'
var info = AstarPath.active.GetNearest(somePoint, nn);


int traversableTags

The tags which this agent can traverse.

This is a bitmask. Each bit indicates that the agent can traverse nodes with the corresponding tag. If a bit is not set, the agent will treat it as if it is not traversable.

The default value is -1, which sets all bits, and indicates that the agent can traverse all tags.