> 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/bandas/cuxial-gang/features.md).

# Guía de funciones

Cómo se usa Cuxial Gang en el juego: panel de staff, menú de jefe, tablet, territorio y actividades.

Qué hace cada parte de Cuxial Gang en el juego y quién la usa. Los nombres de opción en `código` remiten a [Configuración](/scripts/es/bandas/cuxial-gang/configuration.md).

## Roles

| Rol     | Cómo se obtiene                                        | Qué da                                                              |
| ------- | ------------------------------------------------------ | ------------------------------------------------------------------- |
| Staff   | El ACE de `admin.ace`                                  | El panel de staff y los comandos de staff                           |
| Jefe    | Rango más alto de una organización                     | Todo el menú de jefe                                                |
| Miembro | Invitado desde el menú de jefe, o añadido por el staff | Tablet, puntos de la sede que permita su rango, menú de interacción |
| Mula    | Reclutada por una organización con la red de mulas     | Una vista de mula de la tablet con encargos que aceptar             |

## Panel de staff

Se abre con `/crimeadmin`. Todo lo que se edita aquí se guarda en la base de datos y se aplica sin reiniciar.

| Sección                       | Qué gestionas                                                                                                                             |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Organizaciones                | Crear, editar y borrar organizaciones: nombre, tipo (banda o cartel), color, puntos de la sede, alijos extra, dinero, mejoras y vehículos |
| Garajes, Puertos, Helipuertos | Ubicaciones compartidas donde las organizaciones sacan vehículos de tierra, agua y aire                                                   |
| Médico clandestino            | Ubicaciones del NPC médico                                                                                                                |
| Tienda de vehículos           | Catálogo de vehículos que una organización puede comprar, su precio y qué organizaciones pueden comprarlos                                |
| Mejoras                       | Precio de cada mejora                                                                                                                     |
| Pase de temporada             | Recompensas por nivel, precio del pase premium y fecha de fin; reinicio de los niveles de las organizaciones                              |
| Territorios                   | Dibujar, editar y borrar los polígonos de territorio en el mapa                                                                           |
| Extorsión                     | Puntos de cobro y lo que pagan                                                                                                            |
| Favelas                       | Polígonos, recetas de fabricación, asignación manual e historial                                                                          |
| Airdrops                      | Sitios de caída, botín por nivel, lanzamiento manual, cancelación e historial                                                             |
| Historial                     | Registro de las acciones del staff                                                                                                        |

Los puntos y los polígonos se colocan en el mundo con una cámara libre. Mientras los colocas el panel se esconde; <kbd>Mayús derecha</kbd> recupera un panel minimizado.

## Organizaciones

Una organización tiene un tipo, un color, un nivel con experiencia, dos cuentas (saldo limpio y dinero negro), rangos, miembros y una sede.

* **Banda** es el tipo por defecto.
* **Cartel** añade dos cosas: un helipuerto en su propia sede y puntos de abastecimiento en las zonas que controla.

Una organización nueva empieza con `org.defaultSlots` rangos y miembros, y crece con mejoras hasta `org.ranksLimit` y `org.membersLimit`.

### Puntos de la sede

Cada punto es un marcador en el mundo. Un miembro lo ve y lo usa solo si su rango se lo permite.

| Punto                | Permiso de rango                                                              | Notas                                                                                |
| -------------------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Menú de jefe         | Acceso al menú de jefe                                                        |                                                                                      |
| Alijo y alijos extra | Acceso al alijo                                                               | La capacidad crece con la mejora de alijo                                            |
| Vestuario            | Cualquier miembro para vestirse; acceso al menú de jefe para guardar o borrar | Necesita `cuxial_appearance`, o `tgiann-clothing` si se elige en `data/clothing.lua` |
| Garaje               | Acceso al garaje                                                              | Los garajes compartidos necesitan la mejora de garaje                                |
| Puerto               | Acceso al puerto                                                              | Necesita la mejora de puerto                                                         |
| Helipuerto           | Ninguno                                                                       | Solo carteles, necesita la mejora de helipuerto                                      |
| Médico clandestino   | Acceso al médico clandestino                                                  | Necesita la mejora y `cuxial_medical`                                                |
| Lavado de dinero     | Acceso al lavado de dinero                                                    | Necesita la mejora                                                                   |

## Menú de jefe

| Sección           | Qué hace el jefe                                                                                                                                                        |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Resumen           | Nivel, experiencia, miembros conectados, dinero y misiones en curso                                                                                                     |
| Miembros          | Invitar a un jugador cercano, cambiar un rango, despedir, leer el historial de un miembro                                                                               |
| Rangos            | Crear, renombrar, reordenar y borrar rangos, y marcar los permisos de cada uno                                                                                          |
| Finanzas          | Dinero limpio y negro, con ingresos y gastos                                                                                                                            |
| Mejoras           | Comprar huecos (vehículos, conjuntos, miembros, rangos, mulas) y desbloquear servicios (garaje, puerto, helipuerto, médico clandestino, lavado de dinero, red de mulas) |
| Vehículos         | Comprar del catálogo y revender, perdiendo `garage.sellPercentage`                                                                                                      |
| Pase de temporada | Desbloquear el pase premium y reclamar la recompensa de cada nivel                                                                                                      |
| Arsenal           | Nivel del arsenal, recetas desbloqueadas y cupo semanal                                                                                                                 |
| Mulas             | Reclutar, redactar encargos, seguirlos y despedir a una mula                                                                                                            |
| Actividad         | Acciones recientes de la organización                                                                                                                                   |

Las mejoras se pagan con el saldo limpio, o con dinero negro si `org.useDirtyMoneyInBossMenu = true`. El pase de temporada premium se paga siempre con el saldo limpio.

## Tablet

Se abre con `/crimetablet`, o con el ítem si `tablet.asItem = true`.

| Pestaña           | Contenido                                                                                                           |
| ----------------- | ------------------------------------------------------------------------------------------------------------------- |
| Ranking           | Organizaciones ordenadas por puntos: zonas capturadas, misiones hechas, nivel, lealtad, zonas controladas y favelas |
| Mapa              | Zonas, territorios y sus dueños                                                                                     |
| Chat oscuro       | Chat que comparten los miembros de todas las organizaciones                                                         |
| Pase de temporada | Progreso y recompensas                                                                                              |
| Misiones          | Misiones disponibles hasta el siguiente reinicio                                                                    |
| Mulas             | Encargos, para una mula                                                                                             |

El ranking, el chat oscuro y el pase de temporada se pueden ocultar uno a uno en el bloque `tablet`.

### Misiones

En cada reinicio el servidor sortea `tablet.missionsPerRestart` misiones de `data/missions.lua`. Un miembro empieza una desde la tablet. El servidor comprueba el tiempo mínimo, el lugar de entrega y los ítems antes de pagar. La recompensa va al alijo, al saldo, al dinero negro o al garaje según su tipo.

## Territorio

### Zonas de captura

Polígonos fijos definidos en `zones.list`. La organización que tiene miembros dentro captura la zona con el tiempo y gana `zones.captureExp`. Una zona capturada no se puede volver a disputar durante `zones.cooldownMinutes`.

### Territorios

Polígonos dibujados en el panel de staff. Cada organización acumula lealtad en un territorio vendiendo droga y pintando grafitis en él.

Con `turf.control.enabled = true`, el dueño lo deciden las ventas dentro de una ventana móvil de `windowDays` días:

| Nivel | Estado    | Cuándo                                                                                                             |
| ----- | --------- | ------------------------------------------------------------------------------------------------------------------ |
| 0     | Tranquila | El dueño no tiene competencia real                                                                                 |
| 1     | Disputada | Un rival llega a `disputedUnits` unidades                                                                          |
| 2     | Caliente  | El rival llega a `hotRatio` de lo que vende el dueño. Más avisos a la policía y más compradores que se echan atrás |
| 3     | Guerra    | El rival vende más que el dueño por `takeoverMargin`. Se abre una guerra de `warHours` horas                       |

Una zona sin dueño pasa a la primera organización que vende `claimUnits` unidades. Una zona en la que nadie vende durante `abandonDays` días pierde a su dueño.

Una organización también puede pagar `turf.rivalry.startPrice` para declarar la guerra por una zona. La ganadora obtiene `turf.rivalry.winExp`.

### Venta de droga

Un jugador usa el móvil desechable en cualquier punto del mapa. Un comprador se acerca y pide unas unidades de una droga que el jugador lleva encima. El precio sale de `data/drugselling.lua` y cambia según la zona: zona propia, zona enemiga, zona disputada y grafiti propio cerca tienen cada uno su multiplicador en `turf.sales`.

Vender en la zona de otro avisa al dueño, con más precisión cuanto más insiste el vendedor, y le genera una parte como dinero negro (`turf.sales.taxPercent`). Una venta puede llegar a la policía a través de `cuxial_police`, y un comprador puede negarse y atacar.

### Grafitis

Un miembro usa el spray sobre una pared, elige el tamaño y pinta la imagen de la organización. Un grafiti da lealtad en su territorio y un extra de precio a las ventas de alrededor. Dura `lifetimeHours`, está protegido de los rivales durante `protectionMinutes` y cae tras `enemySalesToRemove` ventas enemigas en su radio. El quitagrafitis borra un grafiti.

### Extorsión a negocios

El staff crea puntos de cobro con un pago. Un miembro cobra un punto cada `cooldown` minutos, definidos en `data/racketeering.lua`.

### Puntos de abastecimiento de los carteles

Un cartel deja droga en un alijo físico dentro de una zona que controla. A partir de ahí la zona vende sola cada `tickMinutes` mientras quede género y el dueño tenga miembros conectados. Los rivales pueden robar el punto y la policía puede incautarlo.

### Favelas

Polígonos creados por el staff. Una organización toma una favela manteniendo `minInside` miembros dentro durante una barra de aviso y después una barra de toma. Si entretanto entra otra organización con miembros suficientes, las barras se paran y pasa a ser una pelea: gana la que aguante. El premio es un banco de fabricación que solo usa la dueña, con las recetas que el staff le ponga a esa favela. Necesita `nextgenfivem_crafting`. La propiedad está protegida durante `ownershipHours`.

### Airdrops

Cada `timerHours` horas cae una caja en uno de los sitios. Las fases son: una señal amplia en el mapa, la caída con guardias NPC, la captura por la organización que se queda sola dentro del radio el tiempo de su nivel y, en los niveles altos, la extracción de las cajas en vehículo hasta la sede.

Hay cuatro niveles: bronze, silver, gold y diamond. Los sitios y el botín se siembran desde `data/airdrop.lua` la primera vez y después se editan en el panel de staff.

## Mulas

Una organización con la mejora de red de mulas recluta a jugadores cercanos como mulas. El jefe redacta un encargo con un pago; la mula lo acepta desde la tablet y completa sus pasos en los puntos marcados, o con `/mulapaso`. Los encargos terminados suben la confianza de la mula; los fallidos la bajan.

## Menú de interacción y rehenes

Un miembro pulsa <kbd>F6</kbd> junto a otro jugador para abrir el menú de interacción: esposar, escoltar, cachear, poner una bolsa en la cabeza, meter en un vehículo o sacar de él. El servidor vuelve a comprobar la distancia en cada acción.

Apuntar con un arma a un rehén NPC abre su propio menú: manos arriba, arrodillarse, seguir, subir al vehículo o soltar.

## Actividades por teléfono

Con `lb-phone` y la app complementaria, los miembros tienen tres actividades más por chat: extorsionar a civiles, comprar rehenes a intermediarios y pedir piezas del arsenal a un armero. Las mulas reciben además sus notificaciones y su correo en el teléfono.

## Arsenal

Con `nextgenfivem_crafting`, una organización fabrica armas en los bancos de arsenal que coloca el staff. El nivel del arsenal depende de las unidades que la organización ha vendido. Cada nivel desbloquea recetas, fija un cupo semanal y entrega un plano al alijo. Un banco cercano a una sede es de esa organización; uno alejado de toda sede es neutral.

## Redadas policiales

Desactivadas por defecto en `data/raids.lua`. Al activarlas, un trabajo de `allowedJobs` inicia una redada en una sede con `/startraid`. Durante la redada los agentes pueden abrir el alijo, llevarse el dinero limpio y el negro e incautar vehículos guardados, dentro de los límites del archivo.


---

# 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/bandas/cuxial-gang/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.