> For the complete documentation index, see [llms.txt](https://docs.privalo.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.privalo.dev/scripts/essentials/comunitarias/about.md).

# ABOUT

## 🧹 PV Comunitarias

Sistema completo de **servicio comunitario** para condenar a jugadores a hacer tareas de limpieza en la ciudad. El admin asigna una cantidad de tareas desde un panel NUI y el jugador es teletransportado a una zona aleatoria (Richman, Municipalidad, Playa…), donde debe completar tareas de barrer y recoger basura con animaciones reales. La condena persiste entre relogs y reinicios del servidor.

* 🎨 **Panel admin NUI** `/comunitariasadmin` con dashboard, stats y tabs (Cumpliendo / Online).
* 🔍 **Autocompletado** de jugadores online con avatar + citizenid + ID.
* 🌍 **Multi-framework** (ESX / QB / QBox) con bridge propio.
* 💾 **Persistencia en BD** — la condena continúa aunque el jugador se desconecte o el server reinicie.
* 🗺 **Múltiples zonas** configurables (Richman, Municipalidad, Playa) con selección aleatoria por condena.
* 🧹 **Animaciones reales** con escoba (`WORLD_HUMAN_JANITOR`) y prop basurero (`PROP_HUMAN_BUM_BIN`).
* 🔵 **Marcadores celestes** configurables por color.
* 📋 **Barra de progreso** con cancelación por ox\_lib.
* ⚡ **Anti-escape**: si se aleja del radio de la zona, se le teletransporta al centro.
* 🌐 **Locales ES / EN** con `L('key', ...)`.
* 💾 **Auto-crea 1 tabla SQL** (`pv_comunitarias`) con auto-ALTER si la tabla existía sin la columna `zone`.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.privalo.dev/scripts/essentials/comunitarias/about.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.