> For the complete documentation index, see [llms.txt](https://black-horizon-studios.gitbook.io/emerald-ai-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://black-horizon-studios.gitbook.io/emerald-ai-wiki/emerald-components-optional/sound-detector-component/understanding-the-sound-detector-settings.md).
# Understanding the Sound Detector Settings
## Understanding the Sound Detector Settings
The Sound Detector Settings can be found under the Sound Detector Settings foldout of the Sound Detector Component.
### Current Threat Amount
The Sound Detector Info section gives real-time information on the AI's Current Threat Level and its Currently Threat Amount.
### Sound Detector Settings
The Sound Detector Settings gives users control over how often sound detection calculations are made, the minimum needed velocity, how quickly noise level will raise, and how quickly the noise level will fall. There's also an option to control how often an AI can detect [Attract Modifiers](/emerald-ai-wiki/emerald-components-optional/sound-detector-component/using-an-attract-modifier.md).
{% hint style="info" %}
**Note:** The higher the Check Increment, the more accurate the sound detector process will be. The Min Velocity Threshold controls the minimum velocity that will be needed to increase an AI's Threat Level and Current Detected Noise Level (CDNL). When this happens, the AI's CDNL will be increased by the Attention Rate. If all detect targets' velocity is below the Min Velocity Threshold, it will decrease the CDNL by the Attention Falloff.
{% endhint %}
### Threat Levels
There are 3 threat levels each being triggered when the [Current Threat Amount](#current-threat-amount) value threshold is met. When a target is within an AI's Detection Radius, it will automatically be added to the AI's Sound Detector so its noise level can be tracked. Multiple player targets can be tracked at once and each target's noise data is stored. All targets will contribute to the AI's Current Threat Amount. When an AI's Threat Level thresholds is met, it will invoke the reaction for that Threat Level.
| Threat Level | Description |
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Unaware | Unaware will only be triggered after an AI has become Suspicious or Aware. This can happen after a target has been lost or is too quite to be detected. This should be used for resetting an AI back to its original settings, given they've been modified with a Reaction Object. |
| Suspicious | Suspicious will only be triggered once and after an AI has reached a Suspicious Threat Level threshold. It will not trigger again until after the AI has engaged with a target or if it has reached the Unaware Threat Level. |
| Aware | Aware will only be triggered once and after an AI has reached an Aware Threat Level threshold. It will not trigger again until after the AI has engaged with a target or if it has reached the Unaware Threat Level. |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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, and the optional `goal` query parameter:
```
GET https://black-horizon-studios.gitbook.io/emerald-ai-wiki/emerald-components-optional/sound-detector-component/understanding-the-sound-detector-settings.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.