> 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/es/nucleo/cuxial-multichar/troubleshooting.md).

# Problemas frecuentes

Problemas habituales de Cuxial Multichar y cómo resolverlos.

Casi todos los fallos vienen de una dependencia que falta, del orden de arranque o de una convar. Mira primero la consola del servidor: el recurso avisa de lo que está mal.

<details>

<summary>El recurso no arranca</summary>

**Causa.** Falta una dependencia obligatoria o arranca después: OneSync, `ox_lib`, `oxmysql` o `cuxial_bridge`.

**Solución.** Activa OneSync y arranca esos recursos antes que `cuxial_multichar`. Tienes el orden en [Instalación](/scripts/es/nucleo/cuxial-multichar/installation.md).

</details>

<details>

<summary>La selección se abre pero no se puede entrar ni crear ningún personaje</summary>

**Causa.** El framework no se ha detectado. Cuxial Multichar requiere QBox o QBCore.

**Solución.** Arranca tu framework antes que `cuxial_bridge`, y `cuxial_bridge` antes que `cuxial_multichar`.

</details>

<details>

<summary>El personaje sale con el cuerpo base o no se abre el creador</summary>

**Causa.** No hay ningún recurso de apariencia compatible en marcha. Cuxial Multichar usa `cuxial_appearance` y, si no está en marcha, `illenium-appearance`. Con apartamentos iniciales en uso, este script tampoco abre el creador.

**Solución.** Arranca uno de los dos antes que `cuxial_multichar`. Con `illenium-appearance`, el aspecto sale de la tabla `playerskins`: el personaje necesita una fila con `active = 1`.

</details>

<details>

<summary>Pantalla negra o vacía en lugar de la selección</summary>

**Causa.** Falta la carpeta `web/build` o está incompleta, o hay otro recurso de pantalla de carga en marcha.

**Solución.** Vuelve a subir el recurso con su carpeta `web/build` completa y quita cualquier otra pantalla de carga de tu `server.cfg`.

</details>

<details>

<summary>Los roles de Discord no dan huecos extra</summary>

**Causa.** Una de estas:

* `discordSlots.enabled` está en `false`.
* Faltan las convars. La consola avisa de que los huecos por Discord están activos pero faltan las convars del bot o del servidor.
* El bot no está en tu servidor de Discord, o el token es incorrecto. La consola muestra el código de estado con el que respondió Discord.
* El jugador no tiene Discord vinculado a FiveM.
* El ID del rol es incorrecto, o `characters.maxSlots` es menor que los huecos del rol.

**Solución.** Revisa cada punto. Los cambios de rol tardan hasta `discordSlots.cacheMinutes` en aplicarse, o hasta que el jugador se reconecta.

</details>

<details>

<summary>Los huecos extra desaparecen de vez en cuando</summary>

**Causa.** Discord no contestó dentro de `discordSlots.timeoutMs`. El jugador recibe los huecos base, y la consulta se repite un minuto después.

**Solución.** Sube `discordSlots.timeoutMs`. A los usuarios importantes añádelos en `discordSlots.users`, que no depende de que Discord conteste.

</details>

<details>

<summary>Los personajes nuevos aparecen sin objetos</summary>

**Causa.** Un objeto inicial no existe en tu inventario, o el inventario no cargó a tiempo. La consola indica el objeto o el jugador.

**Solución.** Crea los objetos o edita `starterItems` en el config.

</details>

<details>

<summary>No aparece el carné al crear un personaje</summary>

**Causa.** El recurso indicado en `idCard.resource` no está en marcha, o no tiene carné para `idCard.item`.

**Solución.** Arranca ese recurso antes que `cuxial_multichar`, o pon `idCard.enabled = false`.

</details>

<details>

<summary>No sale la opción de vehículo en la selección</summary>

**Causa.** El recurso indicado en `vehicles.resource` no está en marcha, o el personaje no tiene ningún coche ni moto.

**Solución.** Arranca ese recurso, o pon `vehicles.enabled = false` para ocultar la función.

</details>

<details>

<summary>Los personajes se quedan quietos, sin emote</summary>

**Causa.** `cuxial_emotes` no está en marcha. La escena recurre a `scene.fallbackScenario`.

**Solución.** Arranca `cuxial_emotes`, o usa ubicaciones con `emote = { scenario = '...' }`.

</details>

<details>

<summary>No se puede jugar con un personaje menor</summary>

**Causa.** La solicitud sigue pendiente, o fue rechazada o revocada. Los menores necesitan la aprobación del staff antes de aparecer por primera vez.

**Solución.** Revisa la solicitud con los [exports](/scripts/es/nucleo/cuxial-multichar/developers.md).

</details>

<details>

<summary>No llegan registros a Discord</summary>

**Causa.** La convar `cuxial_multichar_webhook` está vacía, `logs.enabled` está en `false`, o el webhook se ha borrado. La consola muestra el código de estado cuando el webhook rechaza un mensaje.

**Solución.** Define la convar con `set` y reinicia el recurso.

</details>

<details>

<summary>El HUD sigue visible en la selección</summary>

**Causa.** La función `hud` del config está vacía o falla. Si falla, se avisa en la consola del cliente.

**Solución.** Llama al export de tu HUD dentro de `hud = function(visible) ... end`.

</details>

<details>

<summary>Los comandos de staff responden que no tienes permiso</summary>

**Causa.** El jugador no pertenece al grupo indicado en `restricted`.

**Solución.** Añade al jugador a ese grupo con `add_principal`. Mira [Comandos y permisos](/scripts/es/nucleo/cuxial-multichar/commands.md).

</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/es/nucleo/cuxial-multichar/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.