This article's documentation is for anything that uses the Source engine. Click here for more information.

Ai sound: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
No edit summary
 
(41 intermediate revisions by 17 users not shown)
Line 1: Line 1:
{{wrongtitle|title=ai_sound}}
{{Ent not in fgd|nolink=1|smalltext=And might not have a meaningful use in those games.}}
 
{{CD|CAISound|file1=soundent.cpp}}
==Entity Description==
{{this is a|point entity|name=ai_sound|sprite=1}} 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.
'''Entity Name:''' ai_sound
{{clr}}
 
This entity makes sounds or smells that can be sensed by NPCs, but not by the player. This can be used to cause reactions in nearby NPCs.
 
===Sound Types===
 
* Combat: Will cause most NPCs to become alert
* World: Will cause most NPCs to become alert
* Danger: Will cause most NPCs to move away from the position of the sound
* Bullet Impact:
* Carcass:
* Meat:
* Garbage:
* Thumper: causes antlions to run away briefly
* Readiness: (Low, Medium, High) Causes player companions that can hear this sound to change readiness
 
==Keyvalues==
==Keyvalues==
 
{{KV Targetname}}
* [[Targetname]]
{{KV|Volume|intn=volume|int|How far away this sound can be heard. This is a radius.}}
 
{{KV|Duration|intn=duration|float|How long the sound persists each time it plays.}}
* [[Parentname]]
{{KV|Sound Type|intn=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
* '''soundtype'''
! Literal Value || Description
: <choices> The type of sound or smell will determine the reaction of NPCs that sense it.
|-
:*Combat: Will cause most NPCs to become alert  
| 1 || Combat: Will cause most NPCs to become alert  
:*World: Will cause most NPCs to become alert  
|-
:*Danger: Will cause most NPCs to move away from the position of the sound  
| 2 || World: Will cause most NPCs to become alert  
:*Bullet Impact:
|-
:*Carcass:
| 4 || Player: Feign player audible
:*Meat:
|-
:*Garbage:
| 8 || Danger: Will cause most NPCs to move away from the position of the sound  
:*Thumper: causes antlions to run away briefly  
|-
:*Readiness: (Low, Medium, High) Causes player companions that can hear this sound to change readiness
| 16 || Bullet Impact
 
|-
* '''locationproxy'''
| 32 || Carcass
: <target_destination> The name of an entity to use as a proxy to determine the location at which to make the sound. If you specify an entity here, the sound will be made at that entity's location (!player included)
|-
| 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)|intn=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|intn=locationproxy|target_destination|If you specify an entity here, the sound will be made at that entity's location ({{ent|!player}} is an option).}}


==Inputs==
==Inputs==
{{I|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-->
{{I|EmitAISound|Make the Sound.}}


* [[Targetname]]
[[Category:AI]]
 
* [[Parentname]]
 
* '''InsertSound <integer>'''
: Insert a sound in the AI sound list
 
==Outputs==
 
* [[Targetname]]
[[category:AI]]
[[category:Entities]]

Latest revision as of 18:10, 8 May 2025

Icon-NotInFGD.png
This entity is not in the Counter-Strike: SourceDay of Defeat: SourceTeam Fortress 2Left 4 DeadLeft 4 Dead 2Counter-Strike: Global Offensive FGD by default.
And might not have a meaningful use in those games.
C++ Class hierarchy
CAISound
↳CPointEntity
↳CBaseEntity
C++ soundent.cpp
Ai sound.png

ai_sound is a point entity available in all Source Source games. This entity makes abstract sounds or smells that can be sensed by NPCs, but not by the player. This can be used to cause reactions in nearby NPCs. An entity called soundent appears to help with managing AI sounds when the game runs.

Keyvalues

Name (targetname) <string>[ Edit ]
The name that other entities refer to this entity by, via Inputs/Outputs or other keyvalues (e.g. parentname or target).
Also displayed in Hammer's 2D views and Entity Report.
See also:  Generic Keyvalues, Inputs and Outputs available to all entities

Volume (volume) <integer>
How far away this sound can be heard. This is a radius.
Duration (duration) <float>
How long the sound persists each time it plays.
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.
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 Thumper: causes antlions to run away briefly
512 !FGD Bugbait: get nearby antlions' attention
1024 !FGD Physics Danger: Scares off npc_metropolice, npc_combine_s, and npc_antlion
2048 !FGD Sniper Danger: Scares npc_snipers into their hole
4096 Move Away: Pushes away npc_metropolice, npc_citizen, npc_combine_s, npc_alyx, npc_barney, npc_fisherman
8192 !FGD Player Vehicle: Makes NPCs hear the player & makes npc_metropolice turn towards the sound (only used by prop_vehicle_airboat
16384 Player Companion Readiness: Low
32768 Player Companion Readiness: Medium
65536 Player Companion Readiness: High
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.
Literal Value Description
1048576 !FGD Sound is from Sniper
2097152 !FGD Gunfire (use with combat sound type)
4194304 !FGD Mortar (pending explosion)
8388608 Only Combine hear/smell
16777216 !FGD React to source (faces the ai_sound instead of location proxy)
33554432 !FGD Explosion (use with combat sound type)
67108864 Exclude Combine (Combine don't hear/smell)
134217728 !FGD Danger approach (react with danger if you see the ai_sound, just face if otherwise, shouldn't work with location proxy)
268435456 !FGD Only allies (npc_citizen, etc.) hear/smell
Location Proxy (locationproxy) <targetname>
If you specify an entity here, the sound will be made at that entity's location (!player is an option).

Inputs

InsertSound <integerRedirectInput/integer> Obsolete
Deprecated.
Insert a sound in the AI sound list at a specified volume (1-100) which influences detection radius.
EmitAISound
Make the Sound.
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Ai_sound&oldid=475763"