GSC reference › Built-in
AddToInterestPool()
Built-in (engine)
Server
Add a script event to the sentient's interest pool.
Signature
AddToInterestPool(<value>, <priority>, <lifespan>, <point of interest>, <originator>, [unique])
Parameters
| Name | Required? | Details |
|---|---|---|
| value | Required | Amount the event adds to the pool. (integer) |
| priority | Required | How important is the event. (integer) |
| lifespan | Required | Time the event stays in the pool. (float) |
| point of interest | Required | Position the AI will investigate. (vector3) |
| originator | Required | Entity that caused the event. |
| unique | Optional | Only one of this type can exist in the pool. (integer) |
Example (from Treyarch's docs)
point = self AddToInterestPool( 500, 10, 5, ai.origin, ai )
Real uses in BO3's scripts
Not called anywhere in BO3's shipped scripts, so check it works in your mode before relying on it.
Related built-ins
- GetInterestPoolAwareness()Gets the current interest pool awareness level regardless of actual awareness level.
- GetInterestPoolValue()Gets the sentient's interest pool value.
- GetEventPointOfInterest()Gets the point of interest from the current event.
New to GSC?
Start with the basics, or paste a compile error to get the fix.
Built-in descriptions, parameters and examples come from Treyarch's BO3 mod tools docs. Usage links point at shiversoftdev/t7-source (decompiled BO3 scripts).