> 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/vehiculos/cuxial-chipeo/commands.md).

# Comandos y permisos

Comandos, teclas, ítems y permisos de Cuxial Chipeo, y quién puede usar cada uno.

Cuxial Chipeo tiene un comando de jugador, uno de taller y dos de staff. La mayoría de las acciones se hacen con ítems y desde la radio.

## Comandos

| Comando            | Quién                       | Qué hace                                                                                                                                                                                      |
| ------------------ | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `/chipeo`          | Todos                       | Abre o cierra la radio del vehículo en el que vas, o del vehículo más cercano dentro de `remoteRange`. El servidor decide si puedes manejarla.                                                |
| `/repairchipeo`    | Trabajos de `mechanic.jobs` | Repara el equipo frito del vehículo en el que vas o del más cercano dentro de `mechanic.range`. Consume los materiales de `mechanic.requirements`. Solo existe con `mechanic.enabled = true`. |
| `/removeallchipeo` | Staff                       | Retira todos los altavoces portátiles colocados en el servidor.                                                                                                                               |
| `/removechipeo`    | Staff                       | Retira los altavoces portátiles que estén a menos de `admin.nearbyRadius` de ti.                                                                                                              |

{% hint style="info" %}
Los cuatro nombres se pueden cambiar en `shared/config.lua`: `command`, `mechanic.command`, `admin.removeAll` y `admin.removeNearby`. Los comandos de staff borran los altavoces sin devolver el ítem a sus dueños.
{% endhint %}

## Comandos del modo de pruebas

Solo existen con `debug = true` y exigen ser staff (`admin.permission`). Hacen lo mismo que los ítems, sin necesitar ni gastar nada.

| Comando                   | Qué hace                                                                       |
| ------------------------- | ------------------------------------------------------------------------------ |
| `/chipeo_install`         | Instala el equipo en el vehículo en el que vas o en el más cercano.            |
| `/chipeo_unmount`         | Lo desinstala.                                                                 |
| `/chipeo_usb [capacidad]` | Inserta un USB virtual en el vehículo en el que vas. 32 canciones si se omite. |
| `/chipeo_medusa [ítem]`   | Coloca un altavoz portátil. `ítem` es una de las claves de `items.medusas`.    |
| `/chipeo_repair`          | Repara un equipo frito, sin trabajo y sin materiales.                          |

## Teclas

| Tecla                      | Qué hace                                                                                                              |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <kbd>F4</kbd>              | Abre o cierra la radio. Valor por defecto de `keybind`; cada jugador puede cambiarla en los ajustes de teclas de GTA. |
| <kbd>Alt</kbd> (mantenida) | Con la radio abierta, suelta el ratón para mover la cámara. Se define en `ui.cameraKey`.                              |

## Ítems

| Ítem                | Cómo se usa                      | Qué hace                                                                                                          |
| ------------------- | -------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `chipeo_radio`      | Dentro del vehículo o junto a él | Instala el equipo tras una barra de progreso. El ítem se consume.                                                 |
| `chipeo_unmount`    | Dentro del vehículo o junto a él | Desinstala el equipo. El ítem se consume, y recibes de vuelta el `chipeo_radio` y el USB que estuviera insertado. |
| `usb_8` a `usb_128` | Dentro de un vehículo con equipo | Inserta ese USB en la radio. Si había otro insertado, se expulsa antes y vuelve a tu inventario.                  |
| Ítems de altavoz    | A pie                            | Coloca el altavoz delante de ti. Se empareja con el vehículo con equipo más cercano dentro de `medusa.pairRange`. |

El equipo pertenece a la matrícula del vehículo. Un vehículo lo conserva entre reinicios, garajes y reapariciones mientras la matrícula sea la misma.

### Memorias USB

* La capacidad es el número de canciones que caben en el USB.
* Las canciones se guardan en el USB, no en el coche. Expúlsalo desde la pestaña de biblioteca y vuelve a tu inventario con sus canciones.
* Insertar, expulsar y clonar exigen estar dentro del vehículo.
* Clonar copia las canciones del USB insertado en un USB vacío de tu inventario, uno que nunca se haya insertado, con capacidad suficiente para todas.

### Altavoces portátiles

Un altavoz colocado se maneja con el target:

| Opción                  | Quién                                           | Qué hace                                                                              |
| ----------------------- | ----------------------------------------------- | ------------------------------------------------------------------------------------- |
| Abrir radio             | El dueño, o cualquiera si el altavoz es público | Abre la radio del coche emparejado. Solo aparece mientras el altavoz está emparejado. |
| Hacer pública / privada | El dueño                                        | Deja que todos, o solo el dueño, manejen la radio desde este altavoz.                 |
| Recoger medusa          | El dueño, o el staff                            | Retira el altavoz y devuelve el ítem.                                                 |

Un altavoz suena mientras su coche esté dentro de `medusa.signalRange`. Los altavoces colocados se borran cuando el recurso se detiene, y sus ítems no se devuelven.

## Permisos

### Quién puede manejar una radio

| Situación                 | Requisito                                                                                    |
| ------------------------- | -------------------------------------------------------------------------------------------- |
| Dentro del vehículo       | Ninguno. Cualquier ocupante, en cualquier asiento.                                           |
| Fuera del vehículo        | Ser el dueño del vehículo o quien instaló el equipo, dentro de `remoteRange`.                |
| Desde un altavoz portátil | Ser el dueño del altavoz, o que el altavoz sea público, dentro de `remoteRange` del altavoz. |

### Quién puede instalar, desinstalar y reparar

| Acción      | Requisito                                                                                                                             |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Instalar    | Tener el ítem. Con `install.ownerOnly = true`, además ser el dueño del vehículo. El modelo no puede estar en `vehicles.blacklist`.    |
| Desinstalar | Tener el ítem y sitio en el inventario para el equipo. Con `install.unmountOwnerOnly = true`, además ser el dueño o quien lo instaló. |
| Reparar     | Tener un trabajo de `mechanic.jobs` y todos los materiales.                                                                           |

El dueño de un vehículo se lee de la tabla de vehículos de tu framework a través de Cuxial Bridge. Un vehículo sin dueño en la base de datos no tiene ninguno para estas comprobaciones.

### Staff

El staff son los jugadores con el permiso del framework indicado en `admin.permission`, `'admin'` por defecto, comprobado a través de Cuxial Bridge. Da acceso a:

* `/removeallchipeo` y `/removechipeo`.
* Recoger altavoces portátiles colocados por otros jugadores.
* El modo de pruebas y sus comandos, con `debug = true`.


---

# 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/vehiculos/cuxial-chipeo/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.