> 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-appearance/troubleshooting.md).

# Problemas frecuentes

Problemas habituales de Cuxial Appearance, con su causa y su solución.

Los problemas más habituales tras instalar Cuxial Appearance, con la causa y la solución de cada uno.

<details>

<summary>El recurso no arranca</summary>

**Causa.** Falta una dependencia o arranca más tarde. Cuxial Appearance necesita OneSync, `ox_lib`, `oxmysql` y `cuxial_bridge`.

**Solución.** Activa OneSync y arranca antes las dependencias:

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

```cfg
ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure cuxial_appearance
```

{% endcode %}

</details>

<details>

<summary>El menú no aparece nunca, o la pantalla se queda vacía con el cursor visible</summary>

**Causa.** La interfaz no carga. La carpeta `web/build` falta o está incompleta, normalmente tras una subida parcial.

**Solución.** Comprueba que `web/build/index.html` existe dentro del recurso. Si no, vuelve a copiar el recurso desde el paquete original y reinicia el servidor.

</details>

<details>

<summary>La consola muestra consultas fallidas sobre las tablas appearance u outfits</summary>

**Causa.** La base de datos ya tenía una tabla llamada `appearance` u `outfits` de otro script, con columnas distintas. El recurso no sustituye una tabla existente.

**Solución.** Detén el servidor, haz una copia de seguridad de la base de datos, renombra o elimina las tablas antiguas y arranca de nuevo para que se creen con las columnas correctas. Después trae los aspectos antiguos con el comando de migración, si admite tu script anterior.

</details>

<details>

<summary>He cambiado un precio en shared/config.lua y no ha cambiado nada</summary>

**Causa.** `prices`, `secondHand`, `ui.menuAlpha` y parte de `wardrobe` y `trimmer` se guardan en la base de datos en el primer arranque. Desde entonces la base de datos manda sobre el archivo.

**Solución.** Cambia el valor en el panel de staff, sección ajustes. Para volver a los valores del archivo, edita el archivo, reinicia el recurso y usa el botón de restablecer de ese bloque.

</details>

<details>

<summary>He editado data/shops.lua y las tiendas no han cambiado</summary>

**Causa.** Ese archivo solo se lee cuando la tabla de tiendas está vacía, en el primer arranque.

**Solución.** Edita las tiendas desde el panel de staff. El botón de importar añade las tiendas del archivo que faltan por nombre; no cambia las que ya existen.

</details>

<details>

<summary>La consola dice que el ítem de prenda no está registrado y falla al quitarse una prenda</summary>

**Causa.** El ítem de `wardrobe.item` no existe en tu inventario.

**Solución.** Añade los ítems de la página de [Instalación](/scripts/es/nucleo/cuxial-appearance/installation.md) y reinicia el inventario y el recurso. El nombre en el inventario debe coincidir con el del config.

</details>

<details>

<summary>Usar un ítem de prenda no hace nada</summary>

**Causa.** El ítem no tiene función de uso.

**Solución.** En `ox_inventory`, el ítem necesita `client = { export = 'cuxial_appearance.useClothing' }`. La carpeta del recurso debe llamarse `cuxial_appearance`.

</details>

<details>

<summary>Faltan el panel de ropa, las bolsas de prendas o el registro corporal</summary>

**Causa.** El modo inventario está desactivado, o la convar se definió con `set` y el cliente no puede leerla.

**Solución.** Usa `setr` y reinicia el servidor:

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

```cfg
setr cuxial_appearance:inventory 1
```

{% endcode %}

El modo inventario necesita además un inventario que aporte el panel de ropa y los contenedores de las bolsas de prendas.

</details>

<details>

<summary>El estudio de fotos dice que el servidor no conoce el recurso de fotos</summary>

**Causa.** `cuxial_appearance_photos` no está en el directorio `resources`, o el servidor no lo ha escaneado.

**Solución.** Copia el recurso y ejecuta `refresh` y `ensure cuxial_appearance_photos` en la consola del servidor. Añade la línea `ensure` a `server.cfg`.

</details>

<details>

<summary>El estudio de fotos dice que el servidor no puede escribir en el recurso de fotos</summary>

**Causa.** Falta el permiso de sistema de archivos.

**Solución.** Añade esta línea a `server.cfg` y reinicia el servidor:

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

```cfg
add_filesystem_permission cuxial_appearance write cuxial_appearance_photos
```

{% endcode %}

</details>

<details>

<summary>El estudio de fotos se cierra enseguida con un error sobre las capturas</summary>

**Causa.** No hay ningún recurso de captura en marcha.

**Solución.** Arranca `screencapture` o `screenshot-basic` antes que Cuxial Appearance, o pon el nombre del tuyo en `photos.captureResource`.

</details>

<details>

<summary>Las fotos se toman pero el catálogo no muestra ninguna</summary>

**Causa.** El recurso de fotos no está arrancado, o no se reinició tras la sesión y los clientes no tienen los archivos nuevos.

**Solución.** Comprueba que `cuxial_appearance_photos` está en marcha. El estudio lo reinicia al terminar; si la consola indica que el comando fue rechazado, reinícialo a mano con `ensure cuxial_appearance_photos`, o permítelo:

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

```cfg
add_ace resource.cuxial_appearance command.ensure allow
```

{% endcode %}

</details>

<details>

<summary>Las fotos muestran la prenda anterior o una a medio cargar</summary>

**Causa.** La captura ocurre antes de que la prenda termine de cargar.

**Solución.** Sube `photos.waitApply` y `photos.waitCapture`, marca las fotos incorrectas y repite la sesión.

</details>

<details>

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

**Causa.** Tu framework no te concede el permiso de `admin.permission`.

**Solución.** Date ese permiso en tu framework, o cambia `admin.permission` por uno que tengas. En ESX, `'admin'` acepta los grupos `admin` y `superadmin`. Si definiste `restricted` en un comando, también necesitas ese ACE.

</details>

<details>

<summary>La recortadora dice que necesita el sistema de emotes</summary>

**Causa.** `cuxial_emotes` no está en marcha, o el emote de `trimmer.emote` no existe en él.

**Solución.** Arranca `cuxial_emotes` antes que Cuxial Appearance y revisa el nombre del emote.

</details>

<details>

<summary>Un jugador no puede cambiarse el pelo</summary>

**Causa.** Lo raparon con la recortadora. El pelo queda bloqueado durante `trimmer.hairLockMinutes`.

**Solución.** Espera, o baja el valor en el panel de staff. `0` quita el bloqueo en los próximos rapados.

</details>

<details>

<summary>Falta la pestaña de tatuajes</summary>

**Causa.** `rcore_tattoos` está en marcha. Cuxial Appearance le deja los tatuajes y oculta su propia pestaña. La pestaña solo existe en el menú `appearance`.

**Solución.** Para usar los tatuajes propios, detén `rcore_tattoos`.

</details>

<details>

<summary>La bolsa de outfits colocada no se puede abrir</summary>

**Causa.** No hay ningún recurso de target en marcha, o `cuxial_bridge` eligió otro.

**Solución.** Arranca `sleepless_interact`, `ox_target` o `qb-target` antes que `cuxial_bridge`.

</details>

<details>

<summary>Los personajes de mi script de ropa anterior aparecen con el aspecto por defecto</summary>

**Causa.** Sus skins no se han importado.

**Solución.** Mantén `compat.legacySkins = true` para importar cada una cuando haga falta por primera vez, o ejecuta una vez el comando de migración. Consulta [Comandos y permisos](/scripts/es/nucleo/cuxial-appearance/commands.md#migracion).

</details>

<details>

<summary>He cambiado menu.openControl pero la tienda se sigue abriendo con la tecla anterior</summary>

**Causa.** `menu.openControl` es solo el valor por defecto. Cuando un jugador ya ha entrado, FiveM recuerda su asignación de tecla.

**Solución.** Cada jugador la cambia en los ajustes de GTA, en asignación de teclas, FiveM.

</details>

<details>

<summary>Un personaje nuevo no pasa por el creador</summary>

**Causa.** Nada llama al creador. Cuxial Appearance no lo abre por sí solo.

**Solución.** Tu recurso de multipersonaje tiene que llamar a `exports.cuxial_appearance:InitialCreation()` o disparar `qb-clothes:client:CreateFirstCharacter` para los personajes nuevos. Consulta [Exports y eventos](/scripts/es/nucleo/cuxial-appearance/developers.md#initialcreation).

</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-appearance/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.