> 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-cmservices.md).

# Cuxial Servicios Comunitarios

Sanciones de staff para FiveM: tareas comunitarias y cárcel administrativa, con panel de administración.

Cuxial Servicios Comunitarios da a tu staff dos sanciones: una cantidad de tareas comunitarias o minutos de cárcel administrativa. El jugador es llevado a la zona, no puede salir de ella y queda libre de forma automática al cumplir la sanción.

## Qué hace

* **Comunitarias por tareas.** El jugador recibe una tarea cada vez, elegida al azar entre cinco categorías: construcción, jardinería, limpieza, mantenimiento y reparaciones.
* **Tareas guiadas.** Cada tarea tiene un blip con ruta en el mapa, un objeto resaltado, un marcador flotante, un punto de interacción y un indicador en pantalla con dirección y distancia.
* **Zona cerrada.** Un polígono rodea el área de trabajo. Quien sale andando es devuelto. Dentro no se puede atacar.
* **Cárcel administrativa por minutos.** Celda al azar, sin armas, sin ataques, invencible mientras cumple y con una distancia máxima a la celda.
* **Sanciones persistentes.** El progreso se guarda tras cada tarea y cada minuto, y la sanción se vuelve a aplicar al cargar el personaje.
* **Panel de administración.** `/sanciones` lista todos los personajes sancionados por tipo y quita una sanción, esté el jugador conectado o no.
* **Notificaciones y anuncios.** Se avisa al miembro del staff y al jugador, y el chat del servidor anuncia las sanciones aplicadas y cumplidas.
* **Herramienta para mapear tareas.** `/taskcoords` copia al portapapeles modelos de objeto, coordenadas o una tarea completa, lista para pegar en el config.
* **Exports para otros recursos**: leer una sanción, añadir comunitarias o quitarlas, también a personajes desconectados.

## Cómo funciona una sanción

{% tabs %}
{% tab title="Comunitarias" %}

1. El staff ejecuta `/comserv` con el id del jugador, la cantidad de tareas y el motivo.
2. El jugador es llevado a la zona y recibe la primera tarea.
3. En el punto de interacción el jugador pulsa <kbd>E</kbd>. Corre una barra de progreso con la animación de esa tarea.
4. Cada tarea terminada resta uno al contador y aparece una tarea nueva en otro sitio.
5. Al llegar a cero el jugador es llevado al punto de salida y la sanción se borra.
   {% endtab %}

{% tab title="Cárcel" %}

1. El staff ejecuta `/jaila` con el id del jugador, los minutos y el motivo.
2. El jugador es llevado a una celda al azar.
3. Cada minuto conectado en la cárcel cuenta como un minuto cumplido.
4. Al cumplir el tiempo el jugador es llevado al punto de salida y la sanción se borra.
   {% endtab %}
   {% endtabs %}

Un personaje tiene una sola sanción a la vez: los comandos rechazan una segunda mientras la primera sigue activa.

## Requisitos

| Recurso         | Obligatorio | Para qué                                                                             |
| --------------- | ----------- | ------------------------------------------------------------------------------------ |
| OneSync         | Sí          | Mover jugadores desde el servidor                                                    |
| `ox_lib`        | Sí          | Comandos, zona, barra de progreso, notificaciones                                    |
| `oxmysql`       | Sí          | Guardar las sanciones                                                                |
| `cuxial_bridge` | Sí          | Conecta con tu framework                                                             |
| QBox o QBCore   | Sí          | Personajes y permisos de staff                                                       |
| `bl_sprites`    | Sí          | Punto de interacción de cada tarea                                                   |
| `cuxial_chat`   | No          | Anuncia las sanciones en el canal de sanciones del chat. Sin él van al chat estándar |
| `wais-hudv6`    | No          | Muestra el radar mientras el jugador está dentro de la zona de comunitarias          |

{% hint style="warning" %}
Requiere QBox o QBCore. El panel de administración lee los nombres de los personajes de la tabla `players` de esos frameworks.
{% endhint %}

## Páginas

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><i class="fa-download">:download:</i></td><td><strong>Instalación</strong></td><td>Dependencias, SQL, permisos y orden de arranque.</td><td><a href="/scripts/es/nucleo/cuxial-cmservices/installation.md">Instalación</a></td></tr><tr><td><i class="fa-sliders">:sliders:</i></td><td><strong>Configuración</strong></td><td>Zonas, celdas y tareas en <code>config/shared.lua</code>.</td><td><a href="/scripts/es/nucleo/cuxial-cmservices/configuration.md">Configuración</a></td></tr><tr><td><i class="fa-terminal">:terminal:</i></td><td><strong>Comandos y permisos</strong></td><td>Comandos de staff, teclas y el grupo ACE que necesitan.</td><td><a href="/scripts/es/nucleo/cuxial-cmservices/commands.md">Comandos y permisos</a></td></tr><tr><td><i class="fa-code">:code:</i></td><td><strong>Exports y eventos</strong></td><td>Lee, añade y quita sanciones desde tus propios recursos.</td><td><a href="/scripts/es/nucleo/cuxial-cmservices/developers.md">Exports y eventos</a></td></tr><tr><td><i class="fa-wrench">:wrench:</i></td><td><strong>Problemas frecuentes</strong></td><td>Problemas habituales y cómo resolverlos.</td><td><a href="/scripts/es/nucleo/cuxial-cmservices/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/nucleo/cuxial-cmservices.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.