# GC2 Perception Extensions

<figure><img src="https://2344023127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FDOOqDUv8HwTA4ddRyS2S%2Fuploads%2FvWQ2MWWPOCJ7rW5JFgl0%2F1950.png?alt=media&#x26;token=a2d99e07-e366-444d-bf10-408a8f14e977" alt=""><figcaption></figcaption></figure>

All Visual Scripting nodes added by this package are grouped under:

* `Perception Extensions/...`

### Package Contents <a href="#package-contents" id="package-contents"></a>

This package includes:

* custom `Triggers`
* custom `Conditions`
* custom `Instructions`
* custom `Properties`

Package root:

* `Assets/Plugins/rezus13/GC2_Perception_Extensions`

### Overview <a href="#overview" id="overview"></a>

The package extends the standard `Perception` workflow with additional tools for:

* target loss and reacquisition
* time-based visibility logic
* suspicion and awareness thresholds
* investigation start, completion, and failure
* last known position workflows
* target sharing between nearby agents
* temporary ignore states
* runtime tuning of vision and detection behavior

### Terminology <a href="#terminology" id="terminology"></a>

#### Tracked Target <a href="#tracked-target" id="tracked-target"></a>

Many nodes in this package operate on tracked targets. If a target-based node does not respond, first confirm that the NPC is tracking that object.

#### Awareness <a href="#awareness" id="awareness"></a>

Awareness is the value stored by `Perception` for a tracked target. In gameplay terms it is commonly used for:

* `Suspicious`
* `Alert`
* `Aware`

#### Last Known Position <a href="#last-known-position" id="last-known-position"></a>

The last known position is the most recent world position stored by `SensorSee` for a target. It is commonly used for:

* chase-to-search transitions
* search behaviors
* investigation behaviors
* movement to the last visible location

#### Investigation <a href="#investigation" id="investigation"></a>

Investigation refers to an active point of interest being checked by an NPC. In this package, that point can come from:

* an `Evidence` object
* a temporary runtime point created from a world position


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://9476764.gitbook.io/assets/gc2-perception-extensions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
