> 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/policia-y-medico/cuxial-diseases.md).

# Cuxial Diseases

Sistema de enfermedades para FiveM con etapas, síntomas animados, contagio, pruebas, tratamientos y vacunas.

Cuxial Diseases da a cada personaje un estado médico: puede contraer una enfermedad, notar sus síntomas, hacerse una prueba, seguir un tratamiento y curarse. Cada enfermedad se define en un único archivo de datos, así que se añaden o se cambian sin tocar código.

## Qué hace

* **Enfermedades como datos.** Incluye seis enfermedades como catálogo de partida. Cada una es una entrada de `data/diseases.lua` con sus etapas, síntomas, prueba, tratamiento, vacuna y plan de cura.
* **Etapas en horas reales.** Una enfermedad pasa a la etapa siguiente cuando se agota el tiempo, también con el jugador desconectado. Un tratamiento activo puede pausarla.
* **Síntomas que el jugador nota.** Tos, mareo, vómito, falta de aliento, visión borrosa, temblor de cámara y pérdida de vida, cada uno con su intervalo.
* **Tres formas de contraerla.** Cercanía a un jugador enfermo (desactivada por defecto), contacto entre dos personajes comunicado por otro recurso, o a mano mediante un export, un comando o el plazo de vacunación.
* **Pruebas y diagnóstico.** Un ítem de prueba devuelve negativo, no concluyente o positivo. Por defecto el paciente solo conoce el nombre de la enfermedad cuando se la diagnostican.
* **Tratamiento por dosis.** Un ítem controla la enfermedad durante unas horas y, en las curables, la cura al llegar a un número de dosis.
* **Vacunas e inmunidad.** Temporal o permanente, por un ítem de vacuna o tras curarse.
* **Plazo de vacunación.** Opcional: cada personaje tiene unas horas reales para vacunarse; si no, enferma.
* **Etapas letales.** Una etapa terminal puede hacer que el paciente colapse.
* **Embarazo.** Meses, síntomas, prenda de barriga, parto y nacimiento, seguidos desde el mismo recurso.
* **App de salud para el teléfono**, con enfermedades diagnosticadas, tratamiento, inmunidades e historial.
* **Comandos de staff** para asignar, curar y probar todo dentro del juego.

## Requisitos

| Recurso                         | Obligatorio        | Para qué                                                                                  |
| ------------------------------- | ------------------ | ----------------------------------------------------------------------------------------- |
| OneSync                         | Sí                 | Posición de los jugadores en el servidor                                                  |
| `ox_lib`                        | Sí                 | Comandos, callbacks, tareas programadas y textos                                          |
| `oxmysql`                       | Sí                 | Casos, inmunidades, plazos e historial                                                    |
| `cuxial_bridge`                 | Sí                 | Conecta con tu framework y tu inventario                                                  |
| `ox_inventory` o `qb-inventory` | Sí, uno de los dos | Ítems de prueba, tratamiento y vacuna                                                     |
| `cuxial_police`                 | No                 | Parte de EMS en la MDT: ficha del paciente, farmacia, plan de cura con minijuegos y citas |
| `cuxial_medical`                | No                 | Derriba al paciente cuando colapsa una etapa letal                                        |
| `cuxial_emotes`                 | No                 | Contagio y concepción entre dos personajes                                                |
| `lb-phone`                      | No                 | App de salud en el teléfono                                                               |

{% hint style="warning" %}
El plazo de vacunación lee la tabla de personajes de tu framework y necesita las columnas `id` y `citizenid`. QBox y QBCore las tienen. En ESX, deja `onboarding.enabled = false`; el resto del script pasa por `cuxial_bridge`.
{% endhint %}

## Qué funciona sin los recursos opcionales

Cuxial Diseases funciona por sí solo. Esto es lo que aporta cada recurso opcional y lo que pasa sin él.

| Sin              | Sigue funcionando                                                                                                                                   | No disponible                                                                                                                                                                   |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `cuxial_police`  | Infección, etapas, síntomas, ítems de prueba, tratamiento por dosis, vacunas, inmunidad, plazo de vacunación, comandos de staff y todos los exports | Las pantallas de EMS, los pasos del plan de cura que aplica un médico (minijuego incluido), la farmacia, las citas, las revisiones automáticas del embarazo y el aviso de parto |
| `cuxial_medical` | El evento `collapse` se sigue enviando a otros recursos                                                                                             | El paciente no cae cuando colapsa una etapa letal                                                                                                                               |
| `cuxial_emotes`  | Contagio y embarazo mediante exports y comandos                                                                                                     | El contagio y la concepción tras un encuentro, y el ítem de prueba marcado como externo en el catálogo                                                                          |
| `lb-phone`       | Los avisos en pantalla                                                                                                                              | La app de salud                                                                                                                                                                 |

{% hint style="info" %}
Sin Cuxial Police, una enfermedad se cura completando sus dosis, con `/disease cure`, o desde tu propio recurso con los exports `AdvanceCureStep` y `Cure`.
{% endhint %}

## Páginas

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Instalación</strong></td><td>Dependencias, ítems, permisos y orden de arranque.</td><td><a href="/scripts/es/policia-y-medico/cuxial-diseases/installation.md">Instalación</a></td></tr><tr><td><strong>Configuración</strong></td><td>Todas las opciones, el catálogo de enfermedades y cómo añadir la tuya.</td><td><a href="/scripts/es/policia-y-medico/cuxial-diseases/configuration.md">Configuración</a></td></tr><tr><td><strong>Comandos y permisos</strong></td><td>Comandos de staff para asignar, curar y probar.</td><td><a href="/scripts/es/policia-y-medico/cuxial-diseases/commands.md">Comandos y permisos</a></td></tr><tr><td><strong>Exports y eventos</strong></td><td>Infecta, haz pruebas, trata y cura desde tus recursos.</td><td><a href="/scripts/es/policia-y-medico/cuxial-diseases/developers.md">Exports y eventos</a></td></tr><tr><td><strong>Problemas frecuentes</strong></td><td>Los fallos habituales y cómo resolverlos.</td><td><a href="/scripts/es/policia-y-medico/cuxial-diseases/troubleshooting.md">Problemas frecuentes</a></td></tr></tbody></table>


---

# 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/policia-y-medico/cuxial-diseases.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.