> 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/trabajos/cuxial-diving/commands.md).

# Comandos y permisos

Comandos, teclas y permisos de Cuxial Diving, y quién puede usar cada uno.

Cuxial Diving añade dos comandos de jugador y tres de staff. Todo lo demás se hace desde el NPC del trabajo y con teclas.

## Comandos

| Comando                      | Quién                   | Qué hace                                                                                                                                  |
| ---------------------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| `/divinggear`                | Todos                   | Quita la botella y la máscara. La botella no se devuelve.                                                                                 |
| `/divingreset`               | Dueño de la tripulación | Reinicia el trabajo en curso. El barco se elimina, nadie cobra y el trabajo queda en el historial como reiniciado.                        |
| `/divinglist`                | Staff, consola          | Lista las tripulaciones: número, miembros, región y fase.                                                                                 |
| `/divingclose <tripulación>` | Staff, consola          | Cierra la tripulación con ese número. Un trabajo en curso se cancela sin pago.                                                            |
| `/divingfast [cantidad]`     | Staff                   | Completa las tareas obligatorias de tu propio trabajo: `cantidad` piezas por tarea, o todas si se omite. Solo con la depuración activada. |

{% hint style="info" %}
`<tripulación>` es obligatorio y `[cantidad]` es opcional. El número de tripulación es el que muestra `/divinglist`. Los nombres de los comandos se pueden cambiar, o el comando desactivar, en el bloque `commands` de `shared/config.lua`.
{% endhint %}

{% hint style="warning" %}
`/divingfast` solo funciona si la depuración está activa en el momento en que arranca el recurso: `debug = true` en `shared/config.lua`, o la convar `cuxial_diving_debug` a `1` antes de arrancar. No la dejes activa en un servidor abierto.
{% endhint %}

## Teclas

| Tecla                | Qué hace                                                                                                 |
| -------------------- | -------------------------------------------------------------------------------------------------------- |
| <kbd>H</kbd>         | Echa o leva el ancla. Solo sentado en el barco del trabajo.                                              |
| <kbd>E</kbd>         | Entrega el barco en el punto de entrega, lanza la cuerda a una caja que flota y cierra el resumen final. |
| <kbd>Y</kbd>         | Acepta una invitación a una tripulación.                                                                 |
| <kbd>N</kbd>         | Rechaza una invitación a una tripulación.                                                                |
| <kbd>Retroceso</kbd> | Oculta la pista en pantalla.                                                                             |

Son los valores por defecto del bloque `keys`. Cada jugador puede cambiarlas en los ajustes de GTA, en las asignaciones de teclas de FiveM.

## Interacciones

| Dónde            | Opción           | Requisito                                                                |
| ---------------- | ---------------- | ------------------------------------------------------------------------ |
| NPC del trabajo  | Trabajo de buceo | Poder hacer el trabajo (`job` en el config).                             |
| Coral            | Cortar coral     | Trabajo en curso, en el sitio.                                           |
| Basura           | Recoger basura   | Trabajo en curso, en el sitio.                                           |
| Maleta           | Abrir maleta     | Llevar en la mano el arma de `suitcase.weapon`, un cuchillo por defecto. |
| Maleta abierta   | Saquear maleta   | Ninguno.                                                                 |
| Caja en el fondo | Enganchar globo  | Llevar un globo de elevación. Se gasta, junto con algo de oxígeno.       |
| Caja con globo   | Subir caja       | Ninguno.                                                                 |

Cuando una caja flota, la cuerda se lanza con <kbd>E</kbd> desde el barco, con el ancla echada.

## Equipo

Las botellas y la máscara se usan desde el inventario.

* Una botella llena el oxígeno y se gasta al usarla. Usar otra botella lo vuelve a llenar.
* La máscara necesita una botella puesta. Permite respirar bajo el agua y enciende la linterna.
* El equipo no se puede poner dentro de un vehículo.
* Con `gear.requireRun = true`, el valor por defecto, el equipo solo funciona durante un trabajo.
* El equipo se quita cuando el trabajo termina, cuando se acaba el oxígeno o con `/divinggear`.

## Roles de la tripulación

| Acción                                                             | Quién                                                                             |
| ------------------------------------------------------------------ | --------------------------------------------------------------------------------- |
| Invitar y expulsar jugadores, elegir la región, empezar el trabajo | Dueño de la tripulación                                                           |
| Repartir el dinero por porcentaje                                  | Dueño de la tripulación, con `crew.splitRewards = true`                           |
| Reiniciar el trabajo                                               | Dueño de la tripulación                                                           |
| Entregar el barco                                                  | Cualquier miembro sentado en el barco                                             |
| Salir de la tripulación                                            | Cualquier miembro. El dueño no puede salir durante un trabajo: antes lo reinicia. |

Si el dueño se desconecta durante un trabajo, otro miembro conectado pasa a ser el dueño. Si no queda nadie conectado, el trabajo se cancela.

## Permisos

| Función                                                   | Requisito                                                                        |
| --------------------------------------------------------- | -------------------------------------------------------------------------------- |
| Abrir el panel, entrar en una tripulación, usar el equipo | Tener un trabajo permitido por `job` en `shared/config.lua`. Con `'all'`, todos. |
| Elegir una región                                         | Todos los miembros de la tripulación en el `minLevel` de la región o por encima. |
| `/divinglist`, `/divingclose`, `/divingfast`              | Pertenecer al grupo definido en `restricted`, `group.admin` por defecto.         |

Para dar los comandos de staff a otro grupo, cambia `restricted` en el bloque `commands`:

{% code title="shared/config.lua" %}

```lua
commands = {
    gear = { name = 'divinggear' },
    reset = { name = 'divingreset' },
    list = { name = 'divinglist', restricted = 'group.mod' },
    close = { name = 'divingclose', restricted = 'group.mod' },
    fast = { name = 'divingfast', restricted = 'group.admin' },
},
```

{% endcode %}

Un jugador pertenece a un grupo con las líneas habituales de `server.cfg`:

{% code title="server.cfg" %}

```cfg
add_principal identifier.license:xxxxxxxx group.admin
```

{% endcode %}


---

# 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/trabajos/cuxial-diving/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.
