> For the complete documentation index, see [llms.txt](https://cjcrafter.gitbook.io/mechanics/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cjcrafter.gitbook.io/mechanics/mechanics/blinding.md).

# Blinding

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

The blinding mechanic wraps a colored "panel" around the targeted player's head, simulating a flashbang or blinding flash. The panel fades in, holds, and then fades out over a configurable number of ticks. Only the targeted player sees the effect.

| Argument       | Description                                                                                                 | Default Value                              |
| -------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| `color`        | The [Core](https://cjcrafter.gitbook.io/core/) of the blinding effect. Common choices are `WHITE` or `RED`. | <mark style="color:red;">\*</mark>Required |
| `fadeInTicks`  | How many ticks the blinding effect takes to fade *in* to full opacity.                                      | 3                                          |
| `holdTicks`    | How many ticks the blinding effect stays at full opacity.                                                   | 20                                         |
| `fadeOutTicks` | How many ticks the blinding effect takes to fade *out* to invisible.                                        | 10                                         |

{% hint style="info" %}
This mechanic uses display entities, so it only works on Minecraft 1.19.4+ servers.
{% endhint %}

{% hint style="warning" %}
The targeter must be a **player**. Non-player entities cannot see the blinding panel.
{% endhint %}

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

```yaml
Mechanics:
  - "Blinding{color=WHITE} @Target{}"
```

Hits the target player with a quick white flashbang effect (3 tick fade in, 20 tick hold, 10 tick fade out, about 1.65 seconds total).
{% endtab %}

{% tab title="Example 2" %}

```yaml
Mechanics:
  - "Blinding{color=ff0000, fadeInTicks=0, holdTicks=40, fadeOutTicks=20} @Target{}"
```

Instantly snaps a red overlay onto the target, holds it for 2 seconds, then fades out over 1 second. Good for taking critical damage or being on fire.
{% endtab %}

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

```yaml
Mechanics:
  - "Blinding{delayBeforePlay=44} @Target{}"
```

Triggered the moment the orbital beam impacts the target. Players standing near the impact get blinded as part of the combined `SkyBeam`, `Blinding`, `Shockwave`, `ExplosionCloud`, and `CameraShake` impact sequence.
{% endtab %}
{% endtabs %}