View source for Ai sound

{{lang|Ai sound}}
[[File:ai_sound.png|left]]{{base point|ai_sound}} This entity makes abstract sounds or smells that can be sensed by [[NPC]]s, but not by the player. This can be used to cause reactions in nearby NPCs. An entity called {{ent|soundent}} appears to help with managing AI sounds when the game runs.

{{code class|CAISound|soundent.cpp}}

==Keyvalues==
{{KV|Volume (volume)|int|How far away this sound can be heard. This is a radius.}}
{{KV|Duration (duration)|float|How long the sound persists each time it plays.}}
{{KV|Sound Type (soundtype)|choices|The type of sound or smell will determine the reaction of NPCs that sense it. Some of these are not in the FGD, so their associated number must be typed manually.}}
:{| class=standard-table
! Literal Value || Description
|-
| 1 || Combat: Will cause most NPCs to become alert 
|-
| 2 || World: Will cause most NPCs to become alert 
|-
| 4 || Player: Feign player audible
|-
| 8 || Danger: Will cause most NPCs to move away from the position of the sound 
|-
| 16 || Bullet Impact
|-
| 32 || Carcass
|-
| 64 || Meat
|-
| 128 || Garbage
|-
| 256 || [[prop_thumper|Thumper]]: causes antlions to run away briefly
|-
| 512 || {{not in FGD}} [[weapon_bugbait|Bugbait]]: get nearby antlions' attention
|-
| 1024 || {{not in FGD}} Physics Danger: Scares off {{ent|npc_metropolice}}, {{ent|npc_combine_s}}, and {{ent|npc_antlion}}
|-
| 2048 || {{not in FGD}} Sniper Danger: Scares {{ent|npc_sniper}}s into their hole
|-
| 4096 || Move Away: Pushes away <code>npc_metropolice</code>, {{ent|npc_citizen}}, <code>npc_combine_s</code>, {{ent|npc_alyx}}, {{ent|npc_barney}}, {{ent|npc_fisherman}}
|-
| 8192 || {{not in FGD}} Player Vehicle: Makes NPCs hear the player & makes <code>npc_metropolice</code> turn towards the sound (only used by {{ent|prop_vehicle_airboat}}
|-
| 16384 || Player Companion Readiness: Low
|-
| 32768 || Player Companion Readiness: Medium
|-
| 65536 || Player Companion Readiness: High
|}
{{KV|Additional sound context (optional) (soundcontext)|choices|Optional settings specifying such things as who can or cannot hear the sound. Many of these are not in the FGD and some of them have not been fully tested.}}
:{| class=standard-table
! Literal Value || Description
|-
| 1048576 || {{not in FGD}} Sound is from Sniper
|-
| 2097152 || {{not in FGD}} Gunfire (use with combat sound type)
|-
| 4194304 || {{not in FGD}} Mortar (pending explosion)
|-
| 8388608 || Only [[Combine]] hear/smell
|-
| 16777216 || {{not in FGD}} React to source (faces the ai_sound instead of location proxy)
|-
| 33554432 || {{not in FGD}} Explosion (use with combat sound type)
|-
| 67108864 || Exclude Combine (Combine don't hear/smell)
|-
| 134217728 || {{not in FGD}} Danger approach (react with danger if you see the ai_sound, just face if otherwise, shouldn't work with location proxy)
|-
| 268435456 || {{not in FGD}} Only allies (npc_citizen, etc.) hear/smell
|-
|}
{{KV|Location Proxy (locationproxy)|target_destination|If you specify an entity here, the sound will be made at that entity's location ({{ent|!player}} is an option).}}
{{KV BaseEntity|base=1|css=1}}

==Inputs==
{{IO|InsertSound|param=int|deprecated=1|Insert a sound in the AI sound list at a specified volume (1-100) which influences detection radius.}}<!--Check CAISound::InputInsertSound. I'm not sure why exactly this is deemed obsolete but it is. -Pinsplash-->
{{IO|EmitAISound|Make the Sound.}}
{{I BaseEntity|base=1|prel4d=1}}

==Outputs==
{{O BaseEntity}}

[[Category:AI]]