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

# Advanced Knockout

Realistic knockouts, armor physics, concussions and cinematic dream sequences.

**Advanced Knockout** (`ace_knockout`) knocks players unconscious instead of going straight to death or nothing. Melee hits, falls, high-speed crashes, blood loss, exhaustion and drowning each have their own configurable chance. Knocked-out players see an **unconscious screen** with a heartbeat and recovery timer. They may also drift into a fullscreen **dream sequence video** before waking up concussed.

|                   |                                                                               |
| ----------------- | ----------------------------------------------------------------------------- |
| **Resource name** | `ace_knockout`                                                                |
| **Version**       | 1.0.1                                                                         |
| **Frameworks**    | QBCore, Qbox, ESX, Standalone (auto-detected)                                 |
| **Dependencies**  | `ox_lib`                                                                      |
| **Notifications** | ox\_lib, okokNotify, mythic\_notify, framework native or chat (auto-detected) |
| **Database**      | Not used                                                                      |

## Features

**Knockout triggers.** Each one can be turned on or off and has its own chance:

| Trigger       | Default condition                                                      | Default chance |
| ------------- | ---------------------------------------------------------------------- | -------------: |
| Melee         | Melee hit (×2 on headshots)                                            |            40% |
| Fall damage   | Fall of 5 m or more                                                    |            60% |
| Vehicle crash | Crash at 100 km/h or more                                              |            80% |
| Blood loss    | HP below 40 while bleeding                                             |            60% |
| Exhaustion    | HP below 20 and stamina at 0                                           |            20% |
| Drowning      | Underwater too long. Keeps the player at 105 HP so EMS can rescue them |              — |

**Armor physics**

* **Helmet deflection:** 85% chance to survive a headshot with a heavy concussion instead of death.
* **Vest winded:** 45% chance that a shotgun or rifle blast to the vest ragdolls the player for 4 seconds.

**After-effects**

* **Concussion** for 20 seconds after waking, with sprinting turned off.
* Knockout lasts **20–40 seconds** at random.
* Blur, vignette and black-and-white screen effects.

**Dream sequences**

* **9 cinematic dream videos** included (MP4, plus lower-size WEBM versions).
* 50% default dream chance, optional skip after 5 seconds (<kbd>E</kbd>), and fade in/out.

**Other**

* Job immunities (`ambulance` and `police` by default)
* Discord webhook logging
* Developer exports

{% content-ref url="/pages/txMVN8OokZdNGdgVQZh4" %}
[Installation](/docs/roleplay/advanced-knockout/installation.md)
{% endcontent-ref %}

{% content-ref url="/pages/6A7BBkWShtD8266gpIvp" %}
[Dream Sequences](/docs/roleplay/advanced-knockout/dream-sequences.md)
{% endcontent-ref %}