> For the complete documentation index, see [llms.txt](https://wiki.qfdevelopers.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.qfdevelopers.com/scripts/editor-21/configuration.md).

# Configuration

## Languages

You can set the language of the script in the configuration file.

* `en`: English
* `fr`: French
* `pl`: Polish
* `de`: German
* `es`: Spanish

<figure><img src="/files/ig9o7wm8oX8fWWbPFHXs" alt=""><figcaption></figcaption></figure>

## Society

Defines the society settings used for billing and fine distribution.

* `name`: Society account name used for transactions.
* `jobname`: Job identifier that will access the system.
* `label`: Display name of the organization.
* `percentToBoss`: Percentage of the fine that goes to the society account.
* `percentToWorker`: Percentage of the fine paid directly to the officer.

<figure><img src="/files/unYjTMvr4vkfAQgGBiuN" alt=""><figcaption></figcaption></figure>

## Billings

Enables integration with external billing systems.\
Set the desired system to `true` to allow fines and charges to be processed through that billing resource. Only one billing system should be enabled at a time to avoid conflicts.

<figure><img src="/files/qkDrsBdr8CtsW3G9o6IM" alt=""><figcaption></figcaption></figure>

## Banks

Selects the banking system used for processing payments.\
Set the appropriate option to `true` to enable compatibility with your server's banking resource.\
Only one banking system should be enabled at a time.

<figure><img src="/files/posm6LkEt7MIFvfxVXqM" alt=""><figcaption></figcaption></figure>

## Phones

Specifies the in-game phone system used for sending notifications and alerts.\
Set the matching phone resource to `true` to enable integration.\
Only one phone system should be active at a time.

<figure><img src="/files/IFCQ7r6fIceWzoFQTfQ4" alt=""><figcaption></figcaption></figure>

## Licenses

Determines which license system is used for managing player licenses (e.g., driving, weapon).\
Set the appropriate license system to `true` based on your server's framework.\
Only one license system should be enabled at a time.

<figure><img src="/files/RXBcjuPdPO0SHAyGYcJf" alt=""><figcaption></figcaption></figure>

## Max Distance to Jail or Fine

Defines the maximum distance (in meters) between the officer and the suspect required to issue a jail sentence or fine. If the suspect is farther than this value, the action will be blocked.

<figure><img src="/files/wMuX0hHvxMO9Az6pjoOK" alt=""><figcaption></figcaption></figure>

## Show

Controls the visibility of specific UI elements and features:

* `Radio`: Shows the player's radio channel.
* `Nearest`: Displays the nearest players in the MDT.
* `BadgeSystem`: Enables integration with a badge/ID system (if available).

<figure><img src="/files/4JYV5ywyUQmtlfJIsrsS" alt=""><figcaption></figcaption></figure>

## Using Radio

Specifies which radio system is used for displaying the player's active radio channel.\
Set the radio system your server uses to `true` (e.g., `pma_voice`).\
Only one radio integration should be enabled.

<figure><img src="/files/Nunm0cbOIOAWNetZfjTW" alt=""><figcaption></figcaption></figure>

## Jobs

Defines job-related permissions and behavior for accessing and managing the MDT system:

* `OneJob`: If `true`, each job has its own separate reports and dispatches. If `false`, all authorized jobs share the same system.
* `OnDuty`: List of job names allowed to access the MDT (e.g., `'police'`).
* `KickDuty`: Settings applied when a player is removed from duty:
  * `name`: Job to assign after being kicked from duty.
  * `data`: Controls how the grade is set (new grade, same grade, etc.).
* `AccessToManagementFunctions.fromGrade`: Minimum job grade required to access management features.
* `CityStatus.Message`: Enables city-wide announcement events with a customizable prefix and icon.
* `ShowHours`: If `true`, shows officers' total service hours in the MDT.
* `ShowFines`: If `true`, enables the fines system in the MDT.
* `BlockProfiles`, `ResetHours`, `AddRemoveLicense`: Minimum job grades required to block profiles, reset duty hours, or manage licenses.

<figure><img src="/files/9LDNGUQVypOEI6D6WOof" alt=""><figcaption></figcaption></figure>

## ToggleMDT

Configures how players can open the MDT interface:

* `key`: Default keybind assigned to open the MDT (can be changed by the player in GTA settings).
* `commandName`: Chat command that gets triggered by the keybind.
* `keymappingLabel`: Label shown in GTA V settings under **Key Bindings > FiveM**, allowing players to rebind the key.

<figure><img src="/files/I0zXaQiwrueNVvoxntaZ" alt=""><figcaption></figcaption></figure>

## Properties

Enables compatibility with housing and property systems used on your server.\
Set the corresponding option to `true` based on the property resource you use (e.g., `qs_housing`, `esx_property_legacy`, `qb_apartments`, etc.). Only enable the one that matches your server setup to ensure correct address detection and property integration in the MDT.

<figure><img src="/files/k0fnriYgcXPgkGymofov" alt=""><figcaption></figcaption></figure>

## Jails

Defines which jail system is used for handling arrests through the MDT.\
Set the jail system used on your server to `true` (only one should be enabled at a time). Some systems, like `pickle_prisons`, may require an additional jail name (e.g., `pickle_prisons_jailName = "default"`).

<figure><img src="/files/QdssIcURTYfd0oDkWdHg" alt=""><figcaption></figcaption></figure>

## Gender Table

Configures how the script reads player gender from your database (for ESX-based servers only).

* `sqlUserName`: The column name in your `users` table that stores gender information (e.g., `'sex'` or `'gender'`).
* `sqlNames`: Maps gender values from your database to standard terms:
  * `'male'`: Value used to represent male players (e.g., `'m'`, `1`, etc.).
  * `'female'`: Value used to represent female players (e.g., `'f'`, `0`, etc.).

> **Note:** This section is not required if you're using **QBCore**, as gender is handled differently.

<figure><img src="/files/ZRH2Y5yjKDHHFZ3KbSzi" alt=""><figcaption></figcaption></figure>

## Citizens Licenses

Defines how player licenses are displayed in the MDT (e.g., driving or weapon licenses).\
Each entry represents one license type pulled from your database.

* `sqlName`: The name of the license in your database (e.g., `'drive'`, `'weapon'`).
* `isText`: Set to `true` to display the license as text (e.g., `"A"`, `"B"`), or `false` to show it as an icon.
* `translateLicense`: Text label shown if `isText` is `true` (e.g., `"A"` for motorcycle). Leave empty if using an icon.
* `licenseIcon`: Font Awesome icon name used if `isText` is `false`. Leave empty when using text.\
  → Browse available icons here: <https://fontawesome.com/icons>

> You can freely customize this list to match your license structure (e.g., weapon permits, truck licenses, etc.).

<figure><img src="/files/zZYIX6gvYAPCC2ksDNcw" alt=""><figcaption></figcaption></figure>

## Navigation bar

Controls the visibility of navigation tabs in the MDT interface.\
Set each option to `true` to show the corresponding section or `false` to hide it.

* `home`: Main dashboard
* `annoucements`: Internal announcements
* `files`: Case and report management
* `sep_files`: Separate files tab (if needed for custom setups)
* `lawyer_list`: List of active lawyers
* `house_list`: Property and address records
* `radio_codes`: List of radio/code signals
* `warrants`: Active warrants database
* `evidences`: Evidence tracking and storage

<figure><img src="/files/xfOPZ9KA0EqliYEc2HJ0" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://wiki.qfdevelopers.com/scripts/editor-21/configuration.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.