# 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 %}


---

# 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/blinding.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.