Comment on page
AgentBehaviour

The AgentBehaviour is a crucial component that must be attached to every agent leveraging the GOAP system to decide its subsequent actions. It links an agent to a specific GoapSet, which encompasses the configuration of all potential Goals and Actions the agent can undertake.
Overview
Current Goal: The objective the agent is currently trying to achieve.
Active Action: The action the agent is currently executing to meet its goal.
WorldData: Represents the game's current state, which the planner uses to decide the best action for the agent.
Movement
Actions often have associated targets, indicating a position the agent should reach before executing the action. Since movement mechanics can vary based on the game's design, this package doesn't prescribe a specific movement implementation. However, it provides events to help developers determine when an agent should move.
MoveMode
Some actions might need the agent to perform tasks while moving. The MoveMode in the ActionConfig allows for such configurations.
Distance Multiplier
The primary objective of actions is to achieve goals swiftly. If the action's cost equates to its completion time, then the heuristic's distance value should be divided by the agent's movement speed. Using SetDistanceMultiplierSpeed(float speed) sets the agent's (max/average) speed, enabling the planner to more precisely ascertain the optimal action.
Custom Distance Calculation
By default, the agent calculates distance using Vector3.Distance. However, for more complex scenarios, like using a nav mesh, you can override this by assigning your custom IAgentDistanceObserver to the agent.DistanceObserver.
Example
NavMeshDistanceObserver.cs
1
using CrashKonijn.Goap.Behaviours;
2
using CrashKonijn.Goap.Interfaces;
3
using UnityEngine;
4
using UnityEngine.AI;
5
​
6
public class NavMeshDistanceObserver : MonoBehaviour, IAgentDistanceObserver
7
{
8
    private NavMeshAgent navMeshAgent;
9
    
10
    private void Awake()
11
    {
12
        this.navMeshAgent = this.GetComponent<NavMeshAgent>();
13
        this.GetComponent<AgentBehaviour>.DistanceObserver = this;
14
    }
15
    
16
    public float GetDistance(IMonoAgent agent, ITarget target, IComponentReference reference)
17
    {
18
        var distance = this.navMeshAgent.remainingDistance;
19
        
20
        // No path
21
        if (float.IsInfinite(distance))
22
            return 0f;
23
        
24
        return distance;
25
    }
26
}
Methods
SetGoal
This method allows for the modification of the agent's current goal. The endAction parameter decides if the ongoing action should terminate before setting the new goal.
1
public void SetGoal<TGoal>(bool endAction) where TGoal : IGoalBase;
2
public void SetGoal(IGoalBase goal, bool endAction);
Determining the Goal
Choosing the best Goal is game-specific, and this package doesn't dictate a method. However, an example is provided below to illustrate how one might determine a goal based on an agent's hunger level.
Example
This is an example of how to determine the best goal. In this example the agent will wander around until it's hunger is above 80. When it's hunger is above 80 it will try to fix it's hunger. When it's hunger is below 20 it will wander around again.
AgentBrain.cs
1
using System;
2
using CrashKonijn.Goap.Behaviours;
3
using Demos.Goals;
4
using UnityEngine;
5
​
6
namespace Demos.Behaviours
7
{
8
    public class AgentBrain : MonoBehaviour
9
    {
10
        private AgentBehaviour agent;
11
        private HungerBehaviour hunger;
12
​
13
        private void Awake()
14
        {
15
            this.agent = this.GetComponent<AgentBehaviour>();
16
            this.hunger = this.GetComponent<HungerBehaviour>();
17
        }
18
​
19
        private void Start()
20
        {
21
            this.agent.SetGoal<WanderGoal>(false);
22
        }
23
​
24
        private void FixedUpdate()
25
        {
26
            if (this.hunger.hunger > 80)
27
                this.agent.SetGoal<FixHungerGoal>(false);
28
            
29
            if (this.hunger.hunger < 20)
30
                this.agent.SetGoal<WanderGoal>(true);
31
        }
32
    }
33
}
Events
AgentBehaviour offers several events that notify developers when the agent alters its goal or action. These events can be instrumental in managing agent behaviors and responses.
Example
EventExample.cs
1
using CrashKonijn.Goap.Behaviours;
2
using CrashKonijn.Goap.Interfaces;
3
using UnityEngine;
4
​
5
namespace Demos.Complex.Behaviours
6
{
7
    public class EventExample : MonoBehaviour
8
    {
9
        private AgentBehaviour agent;
10
​
11
        private void Awake()
12
        {
13
            this.agent = this.GetComponent<AgentBehaviour>();
14
        }
15
​
16
        private void OnEnable()
17
        {
18
            this.agent.Events.OnActionStart += this.OnActionStart;
19
            this.agent.Events.OnActionStop += this.OnActionStop;
20
            this.agent.Events.OnGoalStart += this.OnGoalStart;
21
            this.agent.Events.OnNoActionFound += this.OnNoActionFound;
22
            this.agent.Events.OnGoalCompleted += this.OnGoalCompleted;
23
        }
24
​
25
        private void OnDisable()
26
        {
27
            this.agent.Events.OnActionStart -= this.OnActionStart;
28
            this.agent.Events.OnActionStop -= this.OnActionStop;
29
            this.agent.Events.OnGoalStart -= this.OnGoalStart;
30
            this.agent.Events.OnNoActionFound -= this.OnNoActionFound;
31
            this.agent.Events.OnGoalCompleted -= this.OnGoalCompleted;
32
        }
33
​
34
        private void OnActionStart(IActionBase action)
35
        {
36
            // Gets called when an action is started
37
        }
38
​
39
        private void OnActionStop(IActionBase action)
40
        {
41
            // Gets called when an action is stopped
42
            // This can be used to check for a new goal
43
        }
44
​
45
        private void OnGoalStart(IGoalBase goal)
46
        {
47
            // Gets called when a goal is started
48
        }
49
​
50
        private void OnGoalCompleted(IGoalBase goal)
51
        {
52
            // Gets called when a goal is completed
53
        }
54
​
55
        private void OnNoActionFound(IGoalBase goal)
56
        {
57
            // Gets called when no action is found for a goal
58
            // This can be used to add a backup goal for example
59
        }
60
    }
61
}
AgentMoveBehaviour.cs
1
using CrashKonijn.Goap.Behaviours;
2
using CrashKonijn.Goap.Interfaces;
3
using UnityEngine;
4
​
5
public class AgentMoveBehaviour : MonoBehaviour
6
{
7
    private AgentBehaviour agent;
8
    private ITarget currentTarget;
9
    private bool shouldMove;
10
​
11
    private void Awake()
12
    {
13
        this.agent = this.GetComponent<AgentBehaviour>();
14
    }
15
​
16
    private void OnEnable()
17
    {
18
        this.agent.Events.OnTargetInRange += this.OnTargetInRange;
19
        this.agent.Events.OnTargetChanged += this.OnTargetChanged;
20
        this.agent.Events.OnTargetOutOfRange += this.OnTargetOutOfRange;
21
    }
22
​
23
    private void OnDisable()
24
    {
25
        this.agent.Events.OnTargetInRange -= this.OnTargetInRange;
26
        this.agent.Events.OnTargetChanged -= this.OnTargetChanged;
27
        this.agent.Events.OnTargetOutOfRange -= this.OnTargetOutOfRange;
28
    }
29
​
30
    private void OnTargetInRange(ITarget target)
31
    {
32
        this.shouldMove = false;
33
    }
34
​
35
    private void OnTargetChanged(ITarget target, bool inRange)
36
    {
37
        this.currentTarget = target;
38
        this.shouldMove = !inRange;
39
    }
40
​
41
    private void OnTargetOutOfRange(ITarget target)
42
    {
43
        this.shouldMove = true;
44
    }
45
​
46
    public void Update()
47
    {
48
        if (!this.shouldMove)
49
            return;
50
        
51
        if (this.currentTarget == null)
52
            return;
53
        
54
        this.transform.position = Vector3.MoveTowards(this.transform.position, new Vector3(this.currentTarget.Position.x, this.transform.position.y, this.currentTarget.Position.z), Time.deltaTime);
55
    }
56
}
Actions
GoapSet
Last modified 1mo ago