> 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/features/incidents-and-fines.md).

# Incidents and Fines

Incident reports document what happened, who was involved, and which charges apply. Charges come from the penal code, and fines are issued when the report is filed.

## 📝 Incident Reports

An incident report contains:

| Field     | Description                                                                                                                   |
| --------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Title     | Short name of the incident.                                                                                                   |
| Report    | Full written report.                                                                                                          |
| Criminals | Suspects involved in the incident.                                                                                            |
| Officers  | Officers involved in the incident.                                                                                            |
| Civilians | Witnesses, victims, and other civilians.                                                                                      |
| Charges   | Penal codes applied to the criminals.                                                                                         |
| Evidence  | Evidence notes.                                                                                                               |
| Tags      | Labels used to find the incident later.                                                                                       |
| Photos    | In-game photos added to the report. See [Photos](https://documentation.rcore.cz/paid-resources/rcore_mdt/features/photos.md). |

Creating and deleting incidents and removing a criminal from an incident needs the `incidents` permission.

{% hint style="warning" %}
Check the report before filing it. Filed incidents can be deleted, but not edited.
{% endhint %}

## ⚖️ Penal Code

The penal code is managed in-game from the **Penal Code** screen. Each charge has:

| Field       | Description                                 |
| ----------- | ------------------------------------------- |
| Code number | Code shown in the MDT and used for sorting. |
| Title       | Name of the charge.                         |
| Description | Details of the charge.                      |
| Severity    | Infraction, misdemeanor, or felony.         |
| Fine        | Fine amount.                                |
| Jail time   | Minimum and maximum jail time.              |
| Tags        | Labels used for search.                     |

Creating, updating, and deleting charges needs the `penal_codes` permission.

{% hint style="info" %}
The MDT does not include default penal codes. Add your charges after the first start.
{% endhint %}

## 💵 Fines and Sentencing

When charges are added to an incident, the MDT shows the recommended sentence: the total fine and the total jail time range.

When the report is filed:

* a fine is recorded for each charge of each criminal
* online criminals are billed automatically

| Framework  | Billing                                                               |
| ---------- | --------------------------------------------------------------------- |
| ESX        | A bill is sent through `esx_billing` to the `society_police` society. |
| QBCore/QBX | The amount is taken from the player's cash.                           |
| Standalone | Not billed. Add your billing in `client/api/billing.lua`.             |

Criminals who are offline when the report is filed get a fine record, but are not billed.

{% hint style="info" %}
Jail time is a recommendation for the officer. The MDT does not send players to jail.
{% endhint %}

## 🧾 Fines Screen

The **Fines** screen lists issued fines. Each fine has a status:

| Status      | Meaning                      |
| ----------- | ---------------------------- |
| `issued`    | The fine has been issued.    |
| `paid`      | The fine has been paid.      |
| `cancelled` | The fine has been cancelled. |
| `appealed`  | The fine is being appealed.  |

Changing a fine's status needs the `fines` permission. Statuses are changed by hand and are not linked to your billing resource.
