> 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/ocio/cuxial-danceclass/troubleshooting.md).

# Problemas frecuentes

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

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

<details>

<summary>El recurso no arranca</summary>

**Causa.** Falta una dependencia o arranca después. Cuxial Dance Class necesita `ox_lib`, `oxmysql`, `cuxial_bridge` y `cuxial_emotes`.

**Solución.** Arranca primero las dependencias:

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

```cfg
ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure cuxial_emotes
ensure cuxial_danceclass
```

{% endcode %}

</details>

<details>

<summary>«No hay bailes disponibles en el catálogo» al empezar un baile</summary>

**Causa.** No se pudo leer el catálogo de bailes de Cuxial Emotes. La consola muestra `[cuxial_danceclass] no se pudo leer el catálogo de bailes de cuxial_emotes`.

**Solución.** Comprueba que `cuxial_emotes` está completo y arranca antes que `cuxial_danceclass`. Si le faltan archivos, cópialo de nuevo desde el paquete original.

</details>

<details>

<summary>/danceclass no hace nada, o aparece el cursor sin panel</summary>

**Causa.** La interfaz no carga. Falta la carpeta `web/dist` o está incompleta, normalmente por una subida a medias.

**Solución.** Comprueba que dentro del recurso existen `web/dist/index.html` y la carpeta `web/dist/assets`. Si no, copia el recurso de nuevo desde el paquete original y reinicia el servidor.

</details>

<details>

<summary>«No puedes dar clases de baile»</summary>

**Causa.** `instructor.mode` es `'job'` y el trabajo del jugador no está en `instructor.jobs`, o es `'ace'` y el jugador no tiene el permiso de `instructor.ace`.

**Solución.** Añade el trabajo a `instructor.jobs`, concede el permiso ACE o pon `instructor.mode = 'everyone'`.

</details>

<details>

<summary>«Tienes que estar en un estudio de baile»</summary>

**Causa.** `rooms.anywhere` es `false` y el centro de la zona dibujada queda fuera de todos los estudios de `rooms.studios`. Con la lista `studios` vacía no se puede abrir ninguna clase.

**Solución.** Añade tus estudios a `rooms.studios` con sus coordenadas y su radio, o pon `rooms.anywhere = true`.

</details>

<details>

<summary>La zona se rechaza al abrir la clase</summary>

**Causa.** Una de estas:

* Tiene menos puntos que `rooms.zone.minPoints`.
* Su punto más lejano está a más de `rooms.zone.maxRadius` metros del centro.
* Se solapa con otra clase abierta.

**Solución.** Dibuja la zona otra vez, más pequeña o más lejos. Sube `rooms.zone.maxRadius` si tus estudios necesitan zonas mayores.

</details>

<details>

<summary>«El creador de zonas de cuxial_bridge no está disponible»</summary>

**Causa.** La versión instalada de Cuxial Bridge no trae creador de zonas.

**Solución.** Actualiza `cuxial_bridge` a la última versión y reinicia el servidor.

</details>

<details>

<summary>Un jugador entra en la zona y no se une</summary>

**Causa.** Una de estas:

* La clase ya ha empezado. Los alumnos solo pueden unirse antes del primer baile.
* La clase está llena.
* El jugador ya está en otra clase, o es el instructor de esta.
* La clase tiene entrada. El jugador tiene que pulsar <kbd>E</kbd> mientras el aviso está en pantalla, y necesita el dinero en la cuenta indicada en `rooms.fee.account`.

**Solución.** Revisa los puntos anteriores. El jugador también puede unirse con `/danceclass join` dentro de la zona, y `/danceclass debug` imprime en la consola F8 las clases detectadas a su alrededor.

</details>

<details>

<summary>F6 no empieza el baile</summary>

**Causa.** Una de estas:

* El jugador no es el instructor de una clase.
* Todavía hay un baile en curso.
* Hay menos alumnos que `class.minStudents`.
* La clase ya llegó a `class.maxRounds`.
* El jugador tiene la tecla asignada a otra cosa. `instructor.nextKey` es solo el valor por defecto para quien nunca ha entrado.

**Solución.** Usa `/danceclass next` o el botón del panel, o reasigna la tecla en los ajustes de teclas de GTA.

</details>

<details>

<summary>Los bailes no dan puntos del gimnasio</summary>

**Causa.** Una de estas:

* Cuxial Gym no está en marcha. El script lo busca con el nombre de recurso `CuxialGym`, que `cuxial_gym` declara.
* La precisión del alumno quedó por debajo de `points.minAccuracy`.
* El alumno ya alcanzó `points.maxPerClass` en esta clase.
* `points.skill` no es un nombre de habilidad que Cuxial Gym acepte.

**Solución.** Arranca `cuxial_gym` antes que `cuxial_danceclass` y revisa el bloque `points`. Sin Cuxial Gym el resto del script funciona y no sube ninguna habilidad.

</details>

<details>

<summary>A un alumno no se le devolvió la entrada</summary>

**Causa.** Una de estas:

* `rooms.refundIfNoRound` es `false`.
* Ya había empezado un baile. Las entradas solo se devuelven mientras la clase no ha bailado.

**Solución.** Es lo previsto. Las entradas se devuelven mientras la clase no ha bailado y `rooms.refundIfNoRound` es `true`.

</details>

<details>

<summary>El historial sigue a cero</summary>

**Causa.** Una de estas:

* La clase se cerró sin ningún baile. Solo se guardan las clases con al menos un baile.
* El alumno salió antes de que terminara la clase. Solo se guardan los alumnos presentes al final.
* No se pudo crear la tabla `cuxial_danceclass_history`. La consola muestra `[cuxial_danceclass] error creando la tabla`.

**Solución.** Para la tabla, revisa los errores de `oxmysql` en la consola del servidor al arrancar el recurso. El usuario de la base de datos necesita permiso para crear tablas.

</details>

<details>

<summary>Los nombres de las dificultades o de los rangos salen en otro idioma</summary>

**Causa.** Los campos `label` de `difficulties` y `ranks` se escriben en `shared/config.lua`.

**Solución.** Reescribe esos nombres en el idioma de tu servidor.

</details>

<details>

<summary>Los textos salen en otro idioma</summary>

**Causa.** El script sigue la convar `ox:locale`.

**Solución.** Defínela en `server.cfg` y reinicia. Se incluyen `en` y `es`:

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

```cfg
setr ox:locale "es"
```

{% endcode %}

</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/ocio/cuxial-danceclass/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.