Enemy Perception

Vision, hearing and detection for Godot 4.7+

Enemy Perception provides reusable perception components for 2D enemies without forcing a specific AI framework, state machine or navigation system.

The addon detects what an enemy can see or hear and exposes the information your own AI needs to react.

Vision

Configure:

• Vision range
• Field of view
• Vision direction
• Reaction time
• Progressive suspicion
• Collision-based line of sight
• Target groups

Physical obstacles can block detection using regular Godot raycasts.

Peripheral Vision

Targets outside the main vision cone can still contribute to suspicion at a reduced rate.

Peripheral angle, relative range and detection strength are fully configurable.

Hearing

Enemies can react to gameplay noise independently from actual audio playback.

Emit noise directly through the API or use AsagoNoiseEmitter2D.

Noise detection considers radius, loudness, distance and optional falloff.

Progressive Detection

Enemy Perception supports four perception states:

Unaware → Suspicious → Detected → Searching

Configure suspicion gain, detection thresholds, decay and search duration to create anything from instant arcade detection to slower stealth gameplay.

Target Memory

When a detected target disappears, the sensor can remember its last known position and remain in a Searching state.

Your own AI can use this information to investigate, search or return to patrol.

Vision & Hearing Together

Combine both sensors to create guards that react differently to visibility, footsteps, distractions and loud gameplay events.

Detection Indicator

An optional AsagoDetectionIndicator2D component can display suspicion and perception state above an enemy.

Use the built-in visual, a custom static sprite or your own animated SpriteFrames.

Scalable Target Discovery

For simple projects, Automatic discovery can periodically scan the configured target group.

For larger scenes, Registered Targets mode allows your own manager, Area2D or chunk system to explicitly provide relevant candidates.

This avoids unnecessary global target scans when many sensors are active.

Optional Audio & VFX

Add feedback for Suspicious, Detected, Searching and Unaware transitions.

Audio and VFX remain optional and are disabled by default.

Reusable Perception Profiles

Optional Godot Resources allow multiple enemies to share perception configurations.

Create profiles for standard guards, elite guards, hearing-focused enemies, horror enemies or any behavior specific to your game.

Clean API

Useful queries include:

is_target_visible()
is_target_detected()
get_suspicion_ratio()
get_last_known_position()

Signals expose target visibility, suspicion, detection, searching and noise events.

No AI Framework Required

Enemy Perception never decides how an enemy should move, patrol, attack or search.

It provides perception data while your own AI remains in control.

Installation

Copy:

addons/enemy_perception/

into your Godot project.

Reload Godot if necessary. No plugin activation is required.

Included

• Complete Enemy Perception addon
• 6 configurable perception presets
• Noise Emitter component
• Detection Indicator component
• Vision and peripheral vision
• Hearing and noise falloff
• Suspicion and detection states
• Target memory and last known position
• Automatic and Registered Target discovery
• Optional Perception Profiles
• Audio and VFX hooks
• Full GDScript source code
• Documentation and integration guides

Compatibility

Godot 4.7+

Developed and validated with Godot 4.7.2 stable.

2D only.

License

Commercial use is allowed in your own games and applications.

Redistribution or resale of the addon itself as a standalone product, template, toolkit or competing asset is not permitted.