> 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/config-yml.md).

# Configuración

En el archivo `config.yml` vas a encontrar el prefijo del plugin en el chat, todos los mensajes traducibles del sistema y los títulos de los menús (GUIs).

***

## Contenido por defecto

Este es el archivo base que se crea al iniciar el plugin por primera vez:

```yaml
prefix: "&#00ff00[CMRankups] &f"

messages:
  no_permission: "&cNo tienes permisos para usar este comando."
  reloaded: "&aConfiguración recargada correctamente."
  rankup_success: "&a¡Felicidades! Has subido al rango &e%rank%&a."
  rankup_failed: "&cNo cumples con los requisitos para subir al rango &e%rank%&c."
  no_more_ranks: "&cYa tienes el rango máximo."
  creating_rank: "&ePor favor, escribe en el chat el nombre del nuevo rango. Escribe 'cancelar' para abortar."
  rank_created: "&aRango &e%rank% &acreado con éxito. Grupo de LuckPerms generado."
  action_cancelled: "&cAcción cancelada."

gui:
  rankup_title: "&#00ff00&lMenú de Rankups"
  edit_title: "&c&lMenú de Edición"
  slot_select_title: "&e&lSelecciona una posición"
```

***

## ¿Qué hace cada campo?

### 1. Prefijo (`prefix`)

* Es el texto que sale antes de los mensajes del plugin en el chat.
* Puedes usar colores de Minecraft tradicionales (como `&a`, `&7`) o usar códigos hexadecimales modernos (RGB) con el formato `&#RRGGBB` (por ejemplo, `&#00ff00` para verde brillante).

### 2. Mensajes (`messages`)

Aquí puedes traducir a tu gusto todas las alertas que envía el plugin:

* `no_permission`: Se le muestra al jugador si intenta usar comandos administrativos sin permiso.
* `reloaded`: Mensaje que avisa cuando recargas los archivos con `/cmrankups reload`.
* `rankup_success`: Lo que le aparece al jugador en el chat cuando sube de rango con éxito. La variable `%rank%` se cambia automáticamente por el nombre estético del rango.
* `rankup_failed`: Si el jugador intenta subir de rango pero no le alcanza el dinero o no cumple los requisitos. También soporta `%rank%`.
* `no_more_ranks`: Le avisa al jugador que ya está en el último rango disponible de la lista.
* `creating_rank`: Instrucciones que le salen al staff cuando empieza a crear un rango desde el chat usando el editor.
* `rank_created`: Avisa que el rango se creó correctamente en el plugin y en LuckPerms. Soporta `%rank%`.
* `action_cancelled`: Sale si un administrador cancela el editor escribiendo la palabra `cancelar` en el chat.

### 3. Títulos de los menús (`gui`)

Modifica los nombres que aparecen arriba en la barra de los inventarios del plugin:

* `rankup_title`: Título del menú de subir rango (`/rankup`).
* `edit_title`: Título del menú del editor administrativo (`/cmrankups edit`).
* `slot_select_title`: Título que sale cuando estás eligiendo en qué casilla colocar un rango.

***

## Colores y Formatos

El plugin utiliza la tecnología **Adventure/MiniMessage** para procesar los textos, por lo que puedes decorarlos de dos maneras:

1. **Códigos clásicos:** Usa el símbolo `&` y la letra o número del color (ejemplo: `&6` para oro, `&l` para negrita).
2. **Colores personalizados (RGB):** Usa el formato `&#RRGGBB` para poner colores exactos según la estética de tu servidor (ejemplo: `&#FF5733` para un tono naranja personalizado).


---

# 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/config-yml.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.