> 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-gym/features.md).

# Guía de funciones

Cómo se usa Cuxial Gym en juego: entrenamiento, estadísticas, membresías, negocios y editores de staff.

Lo que hacen los jugadores, los dueños de negocio y el staff con Cuxial Gym una vez instalado.

## Entrenamiento

El jugador interactúa con un equipo y elige uno de sus ejercicios. El personaje se coloca y empieza la serie.

1. Cada repetición pide un minijuego. Los minijuegos y su rango de dificultad se definen por equipo; la dificultad sube del mínimo al máximo a lo largo de la serie.
2. Un minijuego superado cuenta una repetición. Uno fallado termina la serie.
3. La serie también termina cuando el jugador pulsa <kbd>X</kbd>, llega al límite de repeticiones del ejercicio, se aleja o agota el músculo que entrena.
4. Al terminar, las repeticiones se convierten en XP, fatiga, progreso de racha y logros.

Un equipo solo lo puede usar un jugador a la vez.

### Estadísticas

| Estadística | Se entrena con                                | Efecto                                                    |
| ----------- | --------------------------------------------- | --------------------------------------------------------- |
| Fuerza      | Pecho, hombros, espalda, brazos y abdominales | Vida máxima extra al llegar a ciertos niveles             |
| Agilidad    | Pecho, brazos, abdominales, muslos y gemelos  | Regeneración de stamina extra al llegar a ciertos niveles |

Cada parte del cuerpo reparte la XP de una repetición entre las dos estadísticas con sus propios pesos. Los niveles, la curva de XP, los bonos y una pérdida diaria opcional se editan en el creador.

### Fatiga

Cada repetición cansa las partes del cuerpo que trabaja el ejercicio. Por encima del límite de fatiga, una parte no se puede entrenar hasta que descanse. La fatiga se recupera sola con el tiempo, a un ritmo por parte del cuerpo.

### Rachas y logros

Hacer el mínimo de repeticiones en un día mantiene la racha. Llegar a ciertas duraciones de racha da un bono de XP. Los logros siguen repeticiones, rachas, entrenamientos, suplementos, membresías, repeticiones ayudadas, recompensas diarias, dinero gastado y variedad de ejercicios.

### Suplementos

Los suplementos son items de inventario. Al usar uno se reproduce una animación corta y empieza un efecto temporal:

| Efecto                    | Qué hace                                                       |
| ------------------------- | -------------------------------------------------------------- |
| Bono de XP                | Más XP por repetición                                          |
| Reducción de fatiga       | Menos fatiga por repetición                                    |
| Probabilidad de minijuego | Probabilidad de que una repetición pase sin jugar el minijuego |

Los efectos de varios suplementos activos se suman.

## Panel del gimnasio

El punto del menú del gimnasio abre el panel del jugador en ese gimnasio: estado físico, estadísticas, bonos activos, racha, catálogo de ejercicios, clasificaciones, logros y la pestaña de membresía. La primera vez se muestra una visita guiada.

Con `tablet.dui = true` el panel se dibuja en el propio prop de la pantalla y la cámara se coloca delante. Si no hay un prop de pantalla cerca, se abre como interfaz normal a pantalla completa.

## Membresías

Cada zona tiene sus propios ajustes de membresía:

* **Obligatoria o no.** En una zona que exige pase, los equipos y las taquillas son solo para socios.
* **Paquetes.** Cada uno tiene una duración en días y un precio.
* **Recompensa diaria.** Un item que los socios activos pueden reclamar una vez por periodo de espera.

En una zona sin negocio, el staff lo define en el creador. Cuando la zona pertenece a un negocio, el negocio define sus paquetes, el dinero va a los fondos del negocio y la recompensa diaria sale del stock de su almacén.

## Puntos de interacción

Los puntos son props, peds o simples coordenadas que coloca el staff. Cada uno lleva una o varias acciones:

| Acción                             | Quién puede usarla                           | Qué hace                                                                      |
| ---------------------------------- | -------------------------------------------- | ----------------------------------------------------------------------------- |
| Menú del gimnasio                  | Todos                                        | Abre el panel del gimnasio                                                    |
| Taquilla                           | Todos; solo socios donde se exige pase       | Alijo personal de esa zona                                                    |
| Vestuario                          | Todos                                        | Abre el armario definido en `cloakroom.handlers`                              |
| Tienda                             | Todos                                        | Compra los items que el negocio tiene a la venta                              |
| Llamar a un trabajador             | Jugadores que no son personal del negocio    | Envía un aviso al personal conectado; quien acepta recibe un punto en el mapa |
| Gestión del negocio, Menú del jefe | Personal del negocio                         | Abre el panel del negocio                                                     |
| Alijo                              | Personal del negocio                         | Alijo compartido del negocio                                                  |
| Alijo del jefe                     | Personal con el permiso *Gestionar finanzas* | Alijo restringido                                                             |
| Reclamar bonus                     | Personal del negocio                         | Recoge el bonus que el negocio le ha pagado                                   |

## Negocios

El staff crea un negocio desde `/gymadmin`, indica su dueño y le asigna una o varias zonas. A partir de ahí el dueño lo lleva desde el panel del negocio.

| Sección      | Qué contiene                                                                                         |
| ------------ | ---------------------------------------------------------------------------------------------------- |
| Panel        | Vista general y avisos, como el stock bajo                                                           |
| Negocio      | Nombre, logo, color, impuesto, nivel y traspaso                                                      |
| Empleados    | Contratar a jugadores cercanos, cambiar rangos, despedir, minutos trabajados y repeticiones ayudadas |
| Permisos     | Rangos, su sueldo por hora y lo que puede hacer cada uno                                             |
| Finanzas     | Fondos, depósitos, retiradas, ingresos por origen, impuestos y bonus                                 |
| Almacén      | Stock, pedidos al proveedor e items a la venta                                                       |
| Pedidos      | Pedidos en camino y listos para recoger                                                              |
| Membresías   | Paquetes y recompensa diaria de las zonas del negocio                                                |
| Trabajadores | Personal automático contratado por periodos                                                          |
| Progresión   | Nivel, desbloqueos y misiones                                                                        |

### Rangos y sueldo

Un negocio nace con tres rangos: dueño, encargado y empleado. Cada rango tiene ocho permisos: gestionar negocio, empleados, permisos, almacén, finanzas y trabajadores, pagar bonus y traspasar el negocio.

Los empleados suman minutos trabajados mientras están dentro del área de trabajo del negocio. Su bonus es el sueldo por hora de su rango por el tiempo trabajado. Cuando el negocio lo paga, el empleado lo recoge en un punto de reclamar bonus.

### Almacén y tienda

El negocio pide items del catálogo que define el staff. El pedido se paga con los fondos del negocio y llega tras un tiempo de entrega. Los items en stock se pueden poner a la venta en la tienda; el precio de venta es el propio del item o el precio de almacén por un multiplicador.

### Niveles y misiones

Una parte de cada ingreso se convierte en XP del negocio. Los niveles desbloquean más rangos, plazas de empleado e items de almacén, entregas más rápidas, descuentos y los trabajadores automáticos. Las misiones semanales y las de arranque, que se hacen una sola vez, dan XP extra.

### Trabajadores automáticos

Se pueden contratar y mejorar cuatro trabajadores automáticos: dos que suben los ingresos y las ventas, uno que repone y uno que recoge pedidos. Se cobran por periodo.

### Ayudantes

Un empleado puede interactuar con un jugador que entrena en una zona de su negocio y ayudarle con el ejercicio. El ayudante juega el mismo minijuego; cada uno que supera da repeticiones gratis al jugador. Las repeticiones ayudadas se cuentan por empleado.

## Editores de staff

### Creador de zonas · `/gymcreator`

| Sección                    | Qué hace                                                                                                                     |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Todas las zonas            | Listar, crear y borrar zonas                                                                                                 |
| Editor de zonas            | Equipos con sus ejercicios y minijuegos, puntos de interacción, props del mapa a retirar, membresía, blip y limpieza de peds |
| Modelos globales           | Props del mapa que sirven de equipo en cualquier sitio, sin zona                                                             |
| Minijuegos y presets       | Probar cada minijuego y guardar presets de dificultad                                                                        |
| Configuración del gimnasio | Fatiga, estadísticas, racha, partes del cuerpo, logros, valores de los ejercicios y el tutorial                              |
| Suplementos                | Items, duración y efectos                                                                                                    |

Los equipos y los puntos se colocan en el mundo con un gizmo o caminando hasta el sitio. El editor puede teletransportarte a cualquier equipo o punto.

### Administración de negocios · `/gymadmin`

| Sección             | Qué hace                                                                                                      |
| ------------------- | ------------------------------------------------------------------------------------------------------------- |
| Todos los negocios  | Crear, borrar, editar campos, empleados, stock, zonas y puntos de interacción                                 |
| Ajustes globales    | Reglas comunes a todos los negocios y categorías de la tienda                                                 |
| Objetos del almacén | Catálogo que pueden pedir los negocios: precio, precio de venta, categoría, límite de stock y nivel necesario |
| Trabajadores        | Coste, niveles y efecto de cada trabajador automático                                                         |
| Progresión          | Curva de XP, hitos de nivel y misiones                                                                        |

{% hint style="info" %}
Lo que se guarda desde estos editores queda en la base de datos y sustituye a los valores de fábrica correspondientes de los archivos de `data/`.
{% endhint %}


---

# 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-gym/features.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.
