Env shake: Difference between revisions
Jump to navigation
Jump to search
Tip:To get a continuous shake, one can fire the
Note:This can greatly hinder the accuracy of shots fired when the shaking is continuous.
Note:In code, a comment says that UTIL_ScreenShake does not work on airborne players. This is false.
ChiroDronl (talk | contribs) No edit summary |
Le Glaconus (talk | contribs) (START_SHAKE_NORUMBLE seems to be broken in src 13 +, maybe even on older branches) |
||
| (35 intermediate revisions by 24 users not shown) | |||
| Line 1: | Line 1: | ||
{{LanguageBar}} | |||
{{TabsBar|main=gs|base=env_shake}} | |||
{{Underlinked|date=January 2024}} | |||
{{CD|CEnvShake|file1=EnvShake.cpp}} | |||
{{This is a|point entity|name=env_shake|sprite=1}} When it receives the input <code>StartShake</code>, it shakes the screens of [[player]]s for some duration. Objects can be jostled as well. | |||
{{tip|To get a continuous shake, one can fire the <code>StartShake</code> input at regular intervals, for example using a [[logic_timer]]. The continuous shake can then be stopped by disabling the timer.}} | |||
{{note|This can greatly hinder the accuracy of shots fired when the shaking is continuous.}} | |||
{{ | |||
{{note|In code, a comment says that {{ent|UTIL_ScreenShake}} does not work on airborne players. This is false.}} | |||
== Flags == | __NOTOC__ | ||
==Flags== | |||
{{fl|1|GlobalShake|Ignore radius, EVERYTHING shakes.}} | |||
{{fl|4|In Air|Shake players even if they are in mid-air. Normally, if <code>StartShake</code> is fired while a player is in mid-air, they don't get any shaking at all even if they land before the shaking would end.}} | |||
{{fl|8|Physics|Shake physics objects, not just the camera.}} | |||
{{fl|16|Ropes|Shake ropes. This works independently from '''Physics'''.}} | |||
{{fl|32|DON'T shake view (for shaking ropes or physics only)}} | |||
{{fl|64|DON'T Rumble Controller|Do not shake the controller for players using an Xbox controller, etc.{{bug*|This flag disables the shake entirely.}}}} | |||
== | ==Keyvalues== | ||
{{KV Targetname}} | |||
{{KV|Amplitude (0-16)|intn=amplitude|float|How far away from the normal position the camera will wobble and objects move. For camera, should be a range between 0 and 16. For objects, can be set much higher. {{note|With high amplitudes, the player might be able to briefly look through walls that they touch.}}}} | |||
{{KV|Effect Radius|intn=radius|float|The radius around this entity in which to affect players. {{note|Players within the effect radius will be affected by the shaking for the set duration, regardless of whether they remain within the radius after the shaking begins. Also, <code>StopShake</code> will only stop any shaking for players within the radius.}}}} | |||
{{KV|Duration (seconds)|intn=duration|float|The length of time in which to shake the player's screens.}} | |||
{{KV|Frequency|intn=frequency|float|How many times per second to change the direction of the camera wobble. 40 is generally enough; values higher are hardly distinguishable.}} | |||
[[Category:Entities | ==Inputs== | ||
{{I|Amplitude|param=int|Sets '''Amplitude'''.}} | |||
{{I|Frequency|param=int|Sets '''Frequency'''.}} | |||
{{I|StartShake|Start the shake. If a radius is used, it affects only players inside it and the shake amplitude for a player depends on their distance to the shake entity. Multiple shake starts at once do add up.}} | |||
{{I|StopShake|Stop the shake. If a radius is used, it affects only players inside it.}} | |||
[[Category:GUI Entities]] | |||
Latest revision as of 21:22, 5 September 2025
This article needs more 
links to other articles to help integrate it into the encyclopedia. Please help improve this article by adding links that are relevant to the context within the existing text.
January 2024
links to other articles to help integrate it into the encyclopedia. Please help improve this article by adding links that are relevant to the context within the existing text.January 2024
 Class hierarchy
|
|---|
| CEnvShake |
| EnvShake.cpp
|
env_shake is a point entity available in all 
Source games. When it receives the input StartShake, it shakes the screens of players for some duration. Objects can be jostled as well.
Tip:To get a continuous shake, one can fire the StartShake input at regular intervals, for example using a logic_timer. The continuous shake can then be stopped by disabling the timer.Note:This can greatly hinder the accuracy of shots fired when the shaking is continuous.Note:In code, a comment says that UTIL_ScreenShake does not work on airborne players. This is false.
Flags
- GlobalShake : [1]
- Ignore radius, EVERYTHING shakes.
- In Air : [4]
- Shake players even if they are in mid-air. Normally, if
StartShakeis fired while a player is in mid-air, they don't get any shaking at all even if they land before the shaking would end.
- Physics : [8]
- Shake physics objects, not just the camera.
- Ropes : [16]
- Shake ropes. This works independently from Physics.
- DON'T shake view (for shaking ropes or physics only) : [32]
- DON'T Rumble Controller : [64]
- Do not shake the controller for players using an Xbox controller, etc.
Bug*:This flag disables the shake entirely.
Keyvalues
- Name (targetname) <string>[ Edit ]
- The name that other entities refer to this entity by, via Inputs/Outputs or other keyvalues (e.g.
parentnameortarget).
Also displayed in Hammer's 2D views and Entity Report.See also: Generic Keyvalues, Inputs and Outputs available to all entities
- Amplitude (0-16) (amplitude) <float>
- How far away from the normal position the camera will wobble and objects move. For camera, should be a range between 0 and 16. For objects, can be set much higher. Note:With high amplitudes, the player might be able to briefly look through walls that they touch.
- Effect Radius (radius) <float>
- The radius around this entity in which to affect players. Note:Players within the effect radius will be affected by the shaking for the set duration, regardless of whether they remain within the radius after the shaking begins. Also,
StopShakewill only stop any shaking for players within the radius.
- Duration (seconds) (duration) <float>
- The length of time in which to shake the player's screens.
- Frequency (frequency) <float>
- How many times per second to change the direction of the camera wobble. 40 is generally enough; values higher are hardly distinguishable.
Inputs
- Amplitude <integer>
- Sets Amplitude.
- Frequency <integer>
- Sets Frequency.
- StartShake
- Start the shake. If a radius is used, it affects only players inside it and the shake amplitude for a player depends on their distance to the shake entity. Multiple shake starts at once do add up.
- StopShake
- Stop the shake. If a radius is used, it affects only players inside it.