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

# FAQ

Aquí tienes soluciones rápidas a las dudas y problemas más comunes que te puedes encontrar al configurar el plugin.

***

### 1. ¿El plugin necesita sí o sí Vault y LuckPerms?

**Sí, sin excepciones.** Si el plugin arranca y no encuentra alguno de estos dos instalados en tu carpeta `plugins/`, se desactivará automáticamente para evitar errores mayores.

* **Vault:** Necesita tener por detrás un plugin de economía activo (EssentialsX, RoseEconomy, etc.) para que se puedan realizar las transacciones.
* **LuckPerms:** Se encarga de manejar los grupos de permisos y detectar en qué rango está el jugador.

***

### 2. Mis jugadores hacen click en el ítem del menú de `/rankup` pero no suben ni pasa nada. ¿Por qué?

Revisa estos tres puntos:

1. **Comprueba los requisitos:** Asegúrate de que el jugador realmente tenga el dinero necesario o cumpla con el valor del placeholder.
2. **Mira en qué grupo de LuckPerms está el jugador:** Para que el plugin sepa qué rango le toca, el jugador debe tener el permiso `group.<nombre_del_grupo>` correspondiente a su rango actual. Si no está en el grupo de LuckPerms adecuado, el plugin no sabrá cuál es su rango actual y no lo dejará avanzar.
3. **Errores en consola:** Abre la consola al momento de hacer click para ver si salta alguna alerta o error que te dé una pista.

***

### 3. ¿Puedo usar otras monedas (como tokens o puntos de otros plugins) en vez de dinero normal?

**Sí, claro.** Puedes hacerlo usando **PlaceholderAPI**. En la configuración del rango (`rankups.yml`), pon un requisito de tipo `placeholder` apuntando al marcador de tu plugin de puntos (por ejemplo, `%playerpoints_points%`), define la cantidad que cuesta y añade el comando de consola que se ejecutará para cobrárselos:

```yaml
requirements:
  placeholder:
    value: "%playerpoints_points%"
    amount: 100
    consume_command: "playerpoints take %player% %amount%"
```

***

### 4. ¿Cómo hago para que un rango pida nivel o tiempo de juego pero sin quitarle nada al jugador al subir?

Si solo quieres que el plugin compruebe una estadística (por ejemplo, que el jugador tenga nivel de experiencia 30 o que lleve 10 horas jugadas) pero sin cobrarle nada, pon el placeholder y deja la línea `consume_command` vacía:

```yaml
requirements:
  placeholder:
    value: "%player_level%"
    amount: 30
    consume_command: ""
```

De esta forma el plugin solo revisará que cumpla la condición, pero no le restará nada al subir de rango.

***

### 5. Edité los archivos a mano desde el hosting y no se aplican los cambios. ¿Tengo que reiniciar el servidor?

No es necesario. Si tienes permisos de administrador, solo pon en el juego o consola:

* **`/cmrankups reload`** Esto aplicará al momento todos los cambios que hayas guardado en los archivos `config.yml` y `rankups.yml`.

***

### 6. ¿Cómo se usan los colores hexadecimales (RGB)?

El plugin es compatible con **MiniMessage/Adventure**. Puedes poner colores RGB muy fácil usando el formato `&#RRGGBB` antes del texto. Por ejemplo:

* `&#FF5733Rango Naranja`
* `&#00FF00Rango Verde` Y si quieres negrita o cursiva, puedes poner los códigos de Minecraft tradicionales al lado (ejemplo: `&#FF5733&lRango Negrita Hex`).


---

# 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/faq.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.