> For the complete documentation index, see [llms.txt](https://notnaxito.gitbook.io/notnaxito-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://notnaxito.gitbook.io/notnaxito-docs/comandos.md).

# Comandos

Aquí tienes la lista completa de comandos que incluye el plugin, explicados de forma sencilla y directa.

***

## Comandos para Jugadores

Son los comandos que usan los usuarios comunes de tu servidor. No necesitan ningún permiso especial.

### 1. `/rankup` (o `/ranks`, `/ru`)

* **¿Qué hace?:** Abre el menú de rangos.
* **¿Cómo funciona?:** Al hacer click en el rango que te toca, el plugin revisa si tienes el dinero o los requisitos necesarios. Si todo está en orden, te cobra y te sube de rango en el chat y en el sistema de permisos.

***

## Comandos para Administradores

Para usar estos comandos necesitas tener el permiso **`cmrankups.admin`** o ser Operador (OP) del servidor. Todos usan el atajo `/cmr` en vez de escribir el nombre completo del plugin.

### 1. `/cmrankups help`

* **¿Qué hace?:** Muestra una lista rápida con todos los comandos de administrador directamente en el chat.

### 2. `/cmrankups reload`

* **¿Qué hace?:** Recarga las configuraciones (`config.yml` y `rankups.yml`) desde el disco. Viene genial si editaste los archivos a mano desde el hosting y quieres aplicar los cambios sin reiniciar el servidor.

### 3. `/cmrankups prefix set <prefijo>`

* **¿Qué hace?:** Cambia el prefijo del plugin en el chat al instante. Soporta colores tradicionales y hexadecimales (RGB).
* **Ejemplo:** `/cmrankups prefix set &#00FF00[MiServidor] &f`

### 4. `/cmrankups list`

* **¿Qué hace?:** Muestra en el chat el orden exacto en el que están configurados tus rangos.

### 5. `/cmrankups create <nombre>`

* **¿Qué hace?:** Crea un nuevo rango. Lo añade al final del archivo de configuración, crea su grupo correspondiente en LuckPerms de forma automática y le asigna un prefijo por defecto en el chat (`&#00FF00<nombre>` ).
* **Ejemplo:** `/cmrankups create Experto`

### 6. `/cmrankups delete <nombre>`

* **¿Qué hace?:** Elimina por completo ese rango de la configuración y de la lista de progresiones del plugin.
* **Ejemplo:** `/cmrankups delete Experto`

### 7. `/cmrankups edit`

* **¿Qué hace?:** Abre el editor visual interactivo. Esta es la forma más cómoda de editar todo tu sistema de rangos directamente desde el juego.

***

## Guía de uso del editor visual (/cmrankups edit)

Cuando abras el editor visual con `/cmrankups edit`, verás todos los rangos creados. Si haces click sobre cualquiera de ellos, puedes hacer lo siguiente:

1. **Click Izquierdo (Cambiar Casilla / Slot):**
   * Se abrirá una previsualización de tu inventario. Simplemente haz click en la casilla vacía (de la `0` a la `53`) donde quieres colocar el ítem del rango. El plugin guardará la posición automáticamente.
2. **Click Derecho (Cambiar Atributos del Rango):**
   * Te abrirá un submenú con varias opciones:
     * **Editar Nombre:** Haz click en la etiqueta de nombre, y luego escribe en el chat el nuevo nombre (soporta colores normales y RGB). Si te arrepientes, escribe `cancelar`.
     * **Material (Normal):** Cambia el bloque o ítem del rango cuando ya se compró o está listo para comprar.
     * **Material (Bloqueado):** Cambia el bloque o ítem que se muestra cuando el rango aún está bloqueado.
     * **Editar Lore:** Te permite modificar las líneas de descripción. Puedes elegir cambiar el *Lore Normal* (cuando no se ha comprado) o el *Lore Adquirido* (cuando ya lo compraron).
       * *Para añadir una línea:* Haz click abajo en el botón verde.
       * *Para editar una línea (Click Izquierdo):* Escríbela en el chat y presiona enter.
       * *Para borrar una línea (Click Derecho):* Se eliminará al instante.
     * **Requisitos:** Abre un panel para gestionar lo que cuesta subir al rango.
       * *Añadir dinero (Vault):* Haz click en el botón de oro y escribe el número en el chat.
       * *Añadir variables (Placeholder):* Haz click en el botón de comandos y escribe el placeholder de PAPI (ej: `%tokens_amount%`), luego la cantidad y opcionalmente el comando de cobro (ej: `tokens remove %player% %amount%`).
       * *Borrar un requisito:* Haz click derecho sobre él para quitarlo.


---

# 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://notnaxito.gitbook.io/notnaxito-docs/comandos.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.