> 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/troubleshooting.md).

# Troubleshooting & FAQ

Common problems and questions for ace\_knockout.

## Troubleshooting

<details>

<summary>Dream videos show a black screen or don't play</summary>

* Every file name in `Config.Dreaming.Videos` must **exactly** match a file in `dreams/`, including capitalization. For example, `Policecarchasedream.mp4` is not the same as `policecarchaseDream.webm`.
* The file's extension must be included in the `files` block of `fxmanifest.lua` (`'dreams/*.mp4'` or `'dreams/*.webm'`).
* WEBM files must be moved from `dreams/WEBM/` into `dreams/`. See [Switching to WEBM](/docs/roleplay/advanced-knockout/dream-sequences.md#switching-to-webm).
* Check the client F8 console for `Dream video playback failed`.

</details>

<details>

<summary>Players take a long time to load into the server</summary>

The MP4 dream videos are about 180 MB. Switch to WEBM (about 50 MB) or remove videos you don't use (from both the `dreams/` folder and `Config.Dreaming.Videos`).

</details>

<details>

<summary>No heartbeat sound on the knockout screen</summary>

The heartbeat is played by the NUI page (`ui/heartbeat.mp3`). Check the client F8 console for `Audio playback failed`, and make sure the file is still in `ui/`.

</details>

<details>

<summary>"[ace_knockout] ERROR: Failed to get core object from …"</summary>

The framework was detected but its core object couldn't be fetched. Make sure `qb-core` / `qbx_core` fully starts **before** `ace_knockout`, or set `Config.Framework` manually. Version 1.0.1 improved this for Qbox and QBCore.

</details>

<details>

<summary>Police or EMS still get knocked out</summary>

Job immunities need a framework. Check that the job names in `Config.Immunities.Jobs` match your framework's job names, and that the resource isn't running in standalone mode.

</details>

<details>

<summary>The exports return nothing / "No such export"</summary>

Set `provide_exports "yes"` in `fxmanifest.lua`. See [Exports](/docs/roleplay/advanced-knockout/exports.md).

</details>

## FAQ

<details>

<summary>Can I turn off specific triggers?</summary>

Yes. Every trigger in `Config.Triggers` has `Enabled`.

</details>

<details>

<summary>Does it replace my ambulance job?</summary>

No. It adds knockouts before death. With `Drowning.PreventInstantDeath = true`, players are kept at 105 HP underwater so EMS can rescue them.

</details>

<details>

<summary>Does it work without a framework?</summary>

Yes, in standalone mode. Job immunities and framework notifications won't be available.

</details>