# Camera Shake

{% hint style="success" %}
Have you purchased [WeaponMechanicsCosmetics](https://pluginify.org/resources/13/)? It is required for this Mechanic to work!
{% endhint %}

The camera shake mechanic smoothly oscillates the targeted player's pitch and yaw with a sinusoidal motion that decays over time. This is great for explosions, recoil, earthquake effects, or any "impact" feedback that you want the player to *feel*.

Unlike [Flinch](/mechanics/mechanics/flinch.md) (which is a single hard jolt), `CameraShake{}` is a sustained rolling shake that gradually settles.

| Argument      | Description                                                                                           | Default Value |
| ------------- | ----------------------------------------------------------------------------------------------------- | ------------- |
| `magnitude`   | The starting strength of the shake (in degrees of rotation). Larger values mean a more violent shake. | 1.2           |
| `decay`       | How much `magnitude` is subtracted per tick. Higher values stop the shake sooner.                     | 0.04          |
| `pitchPeriod` | How many ticks one full up/down oscillation takes. Lower values make the vertical wobble faster.      | 3.7           |
| `yawPeriod`   | How many ticks one full left/right oscillation takes. Lower values make the horizontal wobble faster. | 3.0           |
| `maxDuration` | A hard upper bound, in ticks, on how long the shake can last (independent of `decay`).                | 200           |

{% hint style="info" %}
The shake automatically stops once `magnitude` decays to zero, so you usually don't need to tune `maxDuration` unless you're using very low `decay` values.
{% endhint %}

{% hint style="warning" %}
The targeter must be a **player**. Other entities will be ignored. For per-explosion shakes, use `@Target{}` so each nearby player feels the shake from the impact's perspective.
{% endhint %}

{% tabs %}
{% tab title="Example 1" %}

```yaml
Mechanics:
  - "CameraShake{}"
```

A medium shake on the source player. Magnitude starts at 1.2 degrees and decays 0.04 degrees per tick, so the shake fully settles after about 30 ticks (1.5 seconds).
{% endtab %}

{% tab title="Example 2" %}

```yaml
Mechanics:
  - "CameraShake{magnitude=0.4, decay=0.05}"
```

A subtle recoil shake that is quick to start and quick to settle. Good for small caliber weapons.
{% endtab %}

{% tab title="Example 3" %}

```yaml
Mechanics:
  - "CameraShake{magnitude=4.0, decay=0.03, pitchPeriod=2.5, yawPeriod=2.0} @Target{}"
```

A violent, fast-oscillating shake applied to the targeted player. Great for explosion impacts or being hit by a heavy weapon.
{% endtab %}

{% tab title="Example 4" %}
This example comes from the WeaponMechanicsCosmetics `Sky_Torch` orbital laser:

```yaml
Mechanics:
  - "CameraShake{delayBeforePlay=45} @Target{}"
```

Fires one tick after the orbital beam impacts the target, giving nearby players the "earthquake" feeling that pairs with the visual explosion and sonic boom.
{% endtab %}
{% endtabs %}


---

# Agent Instructions: 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:

```
GET https://cjcrafter.gitbook.io/mechanics/mechanics/camera-shake.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.