> 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-admin/commands.md).

# Comandos y permisos

Comandos, teclas, rangos y la lista completa de permisos de Cuxial Admin.

Cuxial Admin tiene tres comandos. Todo lo demás se hace desde el panel, y cada acción se comprueba en el servidor contra el rango de quien la pide.

## Comandos

| Comando        | Quién                                            | Qué hace                                                                                                                 |
| -------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| `/admin`       | Staff                                            | Abre el panel. Quien no tiene rango recibe un aviso.                                                                     |
| `/report`      | Todos                                            | Abre la ventana de reporte. El primer mensaje crea el reporte; los siguientes continúan la conversación.                 |
| `/staffreload` | Consola del servidor, o staff con `staff.manage` | Recarga rangos y staff desde la base de datos y reconstruye las listas de ítems, vehículos, trabajos y bandas del panel. |

Los tres nombres se pueden cambiar en `commands` de `shared/config.lua`.

{% hint style="info" %}
Un jugador solo se reconoce como staff cuando tiene un personaje cargado. En la pantalla de selección de personaje nadie tiene rango.
{% endhint %}

## Teclas

| Tecla                    | Qué hace                                                                                                                               |
| ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| <kbd>U</kbd>             | Abre el panel. Valor por defecto de `keybinds.panel`.                                                                                  |
| <kbd>Fin</kbd>           | Activa o desactiva el noclip. Valor por defecto de `keybinds.noclip`.                                                                  |
| <kbd>Alt izquierdo</kbd> | Con el panel abierto, suelta el cursor para poder andar mientras el panel sigue en pantalla. Vuelve a pulsarlo para regresar al panel. |

El modo dios, la invisibilidad, la munición infinita, el súper salto, las marcas y los nombres no tienen tecla por defecto. Cada miembro del staff las asigna en los ajustes de teclas de GTA, en el apartado de FiveM. La ventana de reporte no tiene tecla salvo que definas `keybinds.report`.

## Cómo funcionan los rangos

Un rango es un nombre más una lista de permisos. Hay tres formas de tenerlo, y gana la más específica:

| Ámbito         | Se da a                     | Se aplica a                        |
| -------------- | --------------------------- | ---------------------------------- |
| Personaje      | Un citizenid                | Solo ese personaje                 |
| Discord        | Un identificador de Discord | Todos los personajes de esa cuenta |
| Rol de Discord | Un identificador de rol     | Cualquiera que lleve ese rol       |

* El rango de personaje manda sobre el de Discord, y el de Discord sobre el de rol. Así un miembro del staff puede tener un personaje sin poderes.
* El ámbito Discord necesita que el jugador tenga Discord vinculado a FiveM.
* El ámbito de rol de Discord necesita el servicio externo de panel web, que informa de quién lleva cada rol. Sin él, usa los otros dos ámbitos.
* Cuando alguien tiene varios rangos por rol, se aplica el más alto.

### Rangos de partida

Se crean en el primer arranque a partir de `data/permissions.lua`. Edítalos, añade o borra desde el panel.

| Rango      | Acceso remoto | Permisos                                                                                                                                                                                     |
| ---------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Superadmin | Sí            | Todo (`*`)                                                                                                                                                                                   |
| Admin      | Sí            | Jugadores, vehículos, inventario, sanciones, reportes, menores, teleporte y herramientas personales; ver el registro y el servidor; mundo, anuncios y limpieza                               |
| Moderator  | No            | Ver, revivir, curar, congelar, efectos, avisar, expulsar, servicios comunitarios y espectar; teleporte; noclip, invisibilidad, marcas y nombres; reportes; ver menores, sanciones y servidor |
| Support    | No            | Ver jugadores y sanciones; ver, atender y responder reportes                                                                                                                                 |

### Reglas al gestionar el staff

Se aplican a cualquiera con `staff.manage`:

* Solo puedes conceder un rango cuyos permisos tengas tú.
* Solo puedes crear o editar un rango con permisos que tengas tú.
* No puedes cambiar ni retirar el rango de alguien cuando ese rango tiene permisos que tú no tienes.
* No puedes retirarte tu propio rango.
* Un rango no se puede borrar mientras alguien lo tenga.

## Permisos

Un permiso se escribe como `grupo.acción`. Hay dos comodines: `*` lo concede todo y `grupo.*` concede un grupo entero, por ejemplo `player.*`.

### Panel

| Permiso         | Permite                                           |
| --------------- | ------------------------------------------------- |
| `player.view`   | Ver la lista de jugadores                         |
| `sanction.view` | Ver el historial de sanciones                     |
| `registry.view` | Ver el registro de auditoría y la lista de rangos |
| `server.view`   | Ver la pestaña del servidor                       |
| `staff.manage`  | Gestionar el staff y los rangos                   |

### Jugadores

| Permiso            | Permite                                                                              |
| ------------------ | ------------------------------------------------------------------------------------ |
| `player.revive`    | Revivir a un jugador, a ti mismo o a todos los que estén en un radio                 |
| `player.reviveAll` | Revivir a todo el servidor                                                           |
| `player.heal`      | Curar                                                                                |
| `player.freeze`    | Congelar y descongelar                                                               |
| `player.effects`   | Efectos: borrachera, fuego y otros                                                   |
| `player.kill`      | Matar                                                                                |
| `player.clothes`   | Abrirle el editor de apariencia a un jugador                                         |
| `player.screen`    | Ver la pantalla de un jugador. Necesita además la lista `cuxial_admin_screen_owners` |
| `player.ped`       | Cambiar el modelo                                                                    |
| `player.job`       | Dar trabajo                                                                          |
| `player.gang`      | Dar banda                                                                            |
| `player.money`     | Dar dinero                                                                           |
| `player.warn`      | Avisar                                                                               |
| `player.kick`      | Expulsar                                                                             |
| `player.service`   | Dar y quitar servicios comunitarios                                                  |
| `player.ck`        | Character kill. Borra el personaje; el motivo es obligatorio                         |
| `player.spectate`  | Espectar                                                                             |

### Inventario

| Permiso             | Permite                           |
| ------------------- | --------------------------------- |
| `inventory.open`    | Abrir el inventario de un jugador |
| `inventory.give`    | Dar objetos                       |
| `inventory.clear`   | Vaciar un inventario              |
| `inventory.stash`   | Abrir alijos cercanos             |
| `inventory.vehicle` | Abrir guantera y maletero         |

### Vehículos

| Permiso          | Permite                                                             |
| ---------------- | ------------------------------------------------------------------- |
| `vehicle.spawn`  | Generar un vehículo                                                 |
| `vehicle.give`   | Dar un vehículo a un jugador como propietario                       |
| `vehicle.fix`    | Reparar y repostar                                                  |
| `vehicle.mod`    | Mejorar                                                             |
| `vehicle.plate`  | Cambiar la matrícula                                                |
| `vehicle.keys`   | Coger las llaves del vehículo más cercano                           |
| `vehicle.delete` | Eliminar el vehículo en el que vas, o los vacíos dentro de un radio |

### Teleporte

| Permiso           | Permite                                      |
| ----------------- | -------------------------------------------- |
| `teleport.self`   | Ir a unas coordenadas o al marcador del mapa |
| `teleport.player` | Ir a un jugador y traer jugadores            |

### Reportes

| Permiso        | Permite                              |
| -------------- | ------------------------------------ |
| `report.view`  | Ver la bandeja y las transcripciones |
| `report.claim` | Atender un reporte                   |
| `report.reply` | Responder                            |
| `report.close` | Cerrar                               |

### Menores

| Permiso         | Permite                                |
| --------------- | -------------------------------------- |
| `family.view`   | Ver las solicitudes de personaje menor |
| `family.review` | Aprobarlas o rechazarlas               |

### Personales

| Permiso             | Permite                        |
| ------------------- | ------------------------------ |
| `self.noclip`       | Noclip                         |
| `self.godmode`      | Modo dios                      |
| `self.invisible`    | Invisibilidad                  |
| `self.infiniteAmmo` | Munición infinita              |
| `self.superJump`    | Súper salto                    |
| `self.blips`        | Marcas de jugadores en el mapa |
| `self.names`        | Nombres sobre los jugadores    |
| `self.adminCar`     | Vehículo de staff              |
| `self.clothes`      | Editor de apariencia para ti   |
| `self.copyCoords`   | Copiar coordenadas             |

### Servidor

| Permiso           | Permite                                |
| ----------------- | -------------------------------------- |
| `server.world`    | Hora, clima, congelar la hora y apagón |
| `server.announce` | Anuncios                               |
| `server.cleanup`  | Limpieza de entidades                  |

{% hint style="info" %}
El panel pone avisos y expulsa. Los baneos se hacen desde txAdmin y después aparecen en el historial de sanciones.
{% endhint %}

Cuxial Admin no usa permisos ACE. El acceso depende solo del rango.


---

# 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-admin/commands.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.