> For the complete documentation index, see [llms.txt](https://docs.cuxial.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cuxial.com/scripts/gangs/cuxial-gang/troubleshooting.md).

# Troubleshooting

Common Cuxial Gang problems, with their cause and fix.

The most frequent problems after installing Cuxial Gang, with the cause and the fix for each one.

<details>

<summary>The resource does not start</summary>

**Cause.** A dependency is missing or starts later. Cuxial Gang needs OneSync, `ox_lib`, `oxmysql` and `cuxial_bridge`.

**Fix.** Enable OneSync and start the dependencies first:

{% code title="server.cfg" %}

```cfg
ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure cuxial_gang
```

{% endcode %}

</details>

<details>

<summary>The console shows a failed query on start</summary>

**Cause.** The database user cannot create or alter tables, or the `player_vehicles` table does not exist because the framework is not QBox or QBCore.

**Fix.** Give the user permission to create and alter tables and restart. The console prints the query, its parameters and the reason. If you prefer to create the tables by hand, use the files in `install/`.

</details>

<details>

<summary>/crimeadmin does nothing or is not recognised</summary>

**Cause.** The player lacks one of the two requirements: the group in `commands.panel.restricted` (`group.mod` by default) or the ACE in `admin.ace` (`mod` by default).

**Fix.** Grant both in `server.cfg` and restart:

{% code title="server.cfg" %}

```cfg
add_ace group.mod mod allow
add_principal identifier.license:xxxxxxxx group.mod
```

{% endcode %}

</details>

<details>

<summary>A panel opens the cursor but shows nothing</summary>

**Cause.** The interface is not loading. The folder `web/dist` is missing or incomplete, usually after a partial upload.

**Fix.** Make sure `web/dist/index.html` and the folder `web/dist/assets` exist inside the resource. If they do not, copy the resource again from the original package and restart the server.

</details>

<details>

<summary>The headquarters markers do not appear</summary>

**Cause.** One of these:

* The points of the organization were never placed in the staff panel.
* The rank of the member does not have the permission for that point.
* The service needs an upgrade the organization has not bought.
* The service is turned off in its file (`Disable = true`, or `garage.disabled`).

**Fix.** Place the points in `/crimeadmin`, review the rank in the boss menu and buy the upgrade.

</details>

<details>

<summary>/crimetablet does not exist</summary>

**Cause.** `tablet.asItem` is `true`, so the tablet only opens with the item.

**Fix.** Set `tablet.asItem = false`, or give players the item named in `tablet.item`.

</details>

<details>

<summary>Using the spray, the remover or the burner phone does nothing</summary>

**Cause.** The item does not exist in your inventory under the name set in `data/graffiti.lua` or `data/drugselling.lua`, or the inventory does not run the usable item registered by the resource. For graffiti, `disabled` may be `true`.

**Fix.** Add the items as shown in [Installation](/scripts/gangs/cuxial-gang/installation.md). For the spray and the remover you can point the item at the exports `cuxial_gang.useSpray` and `cuxial_gang.useRemover`.

</details>

<details>

<summary>No buyer shows up when selling drugs</summary>

**Cause.** One of these:

* The player carries no item listed in `drugs` of `data/drugselling.lua`.
* Fewer police on duty than `requiredCops`.
* The `cooldown` between two uses of the burner phone has not passed.

**Fix.** Put the drug items of your server in `drugs` and adjust `requiredCops`.

</details>

<details>

<summary>Sales never alert the police</summary>

**Cause.** The alert is sent through `cuxial_police`. Without it running, no alert is sent.

**Fix.** Start `cuxial_police` before Cuxial Gang.

</details>

<details>

<summary>Organization vehicles come out without keys</summary>

**Cause.** Keys are handed out through `cuxial_garages`. Without it running, Cuxial Gang gives no keys.

**Fix.** Start `cuxial_garages` before Cuxial Gang.

</details>

<details>

<summary>A vehicle disappeared and the garage shows it as out</summary>

**Cause.** The vehicle was destroyed or removed while it was out.

**Fix.** A member recovers it from the garage paying `garage.recover.cost`. After a server restart, vehicles that were out go back for free with `garage.returnOnRestart = true`.

</details>

<details>

<summary>The clandestine medic does not revive</summary>

**Cause.** The revive is done by `cuxial_medical`. Without it running the medic does nothing and the console says so. The organization also needs the upgrade, and the player the price in the item set in `PriceItem`.

**Fix.** Start `cuxial_medical` before Cuxial Gang and check the upgrade and the money.

</details>

<details>

<summary>The cloakroom cannot save or wear outfits</summary>

**Cause.** The cloakroom reads and applies clothes through `cuxial_appearance`. Saving and deleting also need the boss menu permission.

**Fix.** Start `cuxial_appearance`, or set `clothingScript = 'tgiann_clothing'` in `data/clothing.lua` with `tgiann-clothing` running.

</details>

<details>

<summary>The arsenal or the favela bench does not exist</summary>

**Cause.** Both are built on `nextgenfivem_crafting`. Without it running there are no benches. With it, the bench type and recipes are created on start, but the benches themselves are placed by staff in the editor of that resource.

**Fix.** Start `nextgenfivem_crafting` before Cuxial Gang and place a bench of the type named in `benchType`.

</details>

<details>

<summary>The premium season pass cannot be bought</summary>

**Cause.** `seasonPass.customCurrency` is `true`, or the organization does not have the price in its clean balance.

**Fix.** Set `seasonPass.customCurrency = false` and fund the clean balance. The price is edited in the staff panel.

</details>

<details>

<summary>/startraid does not exist</summary>

**Cause.** Raids are disabled by default.

**Fix.** Set `enable = true` in `data/raids.lua` and add your police jobs to `allowedJobs`.

</details>

<details>

<summary>A raid cannot be started</summary>

**Cause.** One of the limits of `data/raids.lua`: the hour is outside `raidTime`, the job or the organization is on cooldown, there are not enough players online, the grade is too low, or `adminMode.enable` is `true` and staff have not approved it.

**Fix.** Review those options. With admin mode on, staff approve with `/approveraid <jobname> <gangid>`.

</details>

<details>

<summary>No airdrop ever falls</summary>

**Cause.** `enabled` is `false` in `data/airdrop.lua`, the hour is outside `SpawnTimeWindow`, or there are no usable sites.

**Fix.** Check the sites in the staff panel and launch one by hand with `/startAirDrop` to test. The console says why a launch failed.

</details>

<details>

<summary>Schedules run at the wrong hour</summary>

**Cause.** `timeZone` is not the zone of your server, or the time API did not answer and the machine clock is being used. The console says which on start.

**Fix.** Set `timeZone` to your IANA zone. To skip the API and always use the machine clock, set `timeApi = ''`.

</details>

<details>

<summary>Logs do not reach Discord</summary>

**Cause.** The convar is empty or has a different name from `logs.general` or `logs.admin`.

**Fix.** Add the convars to `server.cfg` before the resource starts. They are read once, on start:

{% code title="server.cfg" %}

```cfg
set cuxial_gang_webhook "https://discord.com/api/webhooks/..."
set cuxial_gang_webhook_admin "https://discord.com/api/webhooks/..."
```

{% endcode %}

With debug on, the console says whether each webhook is configured.

</details>

<details>

<summary>Stashes do not open, or searching a player does nothing</summary>

**Cause.** The inventory is not `ox_inventory`. Stashes and player search are built on it.

**Fix.** Use `ox_inventory`.

</details>

<details>

<summary>The interaction key does nothing</summary>

**Cause.** The player is not in an organization, nobody is within range, or `rope.enabled` is `false`. A changed `rope.keybind.key` only applies to players who join for the first time.

**Fix.** Check the organization and the distance. Players rebind the key in the GTA settings, under key bindings for FiveM.

</details>


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.cuxial.com/scripts/gangs/cuxial-gang/troubleshooting.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.