> For the complete documentation index, see [llms.txt](https://documentation.rcore.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.rcore.cz/paid-resources/rcore_mdt/troubleshooting.md).

# Troubleshooting

Use these fixes when `rcore_mdt` does not work as expected.

<details>

<summary>The MDT does not open.</summary>

**Cause:** The player's job is not a department, they are off duty, or they are missing the required item.

**Fix:**

* Check that the job name is a key in `CONFIG.JOBS`.
* On QBCore and QBX, go on duty.
* If `CONFIG.RequireItem = true`, check that the player has `CONFIG.RequiredItem`.
* Check that `CONFIG.Framework` matches your framework.

</details>

<details>

<summary>The MDT opens, but every action is blocked.</summary>

**Cause:** The player's rank has no permissions.

**Fix:** Check that the grade numbers in `Ranks` match your framework's job grades, and that the rank names in `Perms` match `Ranks` exactly. See [Add Jobs](https://documentation.rcore.cz/paid-resources/rcore_mdt/configuration/add-jobs.md#rank-permissions).

</details>

<details>

<summary>The MDT opens, but it is empty.</summary>

**Cause:** Every screen is turned off for the job.

**Fix:** Check the job's `Screens` table in `configs/sh_config.lua` and enable at least `home`. See [Add Jobs](https://documentation.rcore.cz/paid-resources/rcore_mdt/configuration/add-jobs.md#screens).

</details>

<details>

<summary>Two departments don't see each other's bulletins or case files.</summary>

**Cause:** The jobs are in different bulletin groups.

**Fix:** Give both jobs the same `BulletinGroup` and the same `CaseFileCategories`. See [Add Jobs](https://documentation.rcore.cz/paid-resources/rcore_mdt/configuration/add-jobs.md#case-file-categories).

</details>

<details>

<summary>There are no charges to select when creating an incident.</summary>

**Cause:** The penal code is empty.

**Fix:** Open the **Penal Code** screen with a rank that has the `penal_codes` permission and add your charges.

</details>

<details>

<summary>Photos do not upload.</summary>

**Cause:** `screencapture` is not running, or the image upload is not configured.

**Fix:** Check the server console:

| Message                                                              | Fix                                                       |
| -------------------------------------------------------------------- | --------------------------------------------------------- |
| `Cannot upload since, you are not running screencapture resource!`   | Install `screencapture` and ensure it before `rcore_mdt`. |
| `SV_CONFIG.ImageUpload.<Provider>.Url and ApiKey must be configured` | Add your API key in `configs/sv_config.lua`.              |
| `Failed to upload image via <provider> - No URL in response`         | Check that your API key is valid and matches `Provider`.  |

</details>

<details>

<summary>Fines are not billed on ESX.</summary>

**Cause:** `esx_billing` is not running.

**Fix:** Install and ensure `esx_billing`. Bills are sent to the `society_police` society. Only criminals who are online when the report is filed are billed.

</details>

<details>

<summary>Discord logs are not sent.</summary>

**Cause:** Logging is disabled, the URL is empty, or the category is turned off.

**Fix:** In `configs/sv_config.lua`, set `SV_CONFIG.Webhook.Enabled = true`, add the webhook `Url`, and check the category in `Actions`.

</details>

<details>

<summary>Something is wrong, but there is no clear error.</summary>

**Fix:** Enable debug in `configs/sh_config.lua`, reproduce the issue, then check F8 and the server console.

```lua
CONFIG.Debug = true
```

</details>
