XPlayerKits
Requisitos
-
Compatibilidad con Spigot
Puedes usar Spigot, Paper o cualquier fork compatible desde la versión 1.8 hasta la 1.21.5.
-
PlaceholderAPI (Obligatorio)
Este plugin requiere PlaceholderAPI para funcionar correctamente. Asegúrate de descargarlo desde:
PlaceholderAPI en SpigotMC
Instalación
- Descarga el archivo
.jar del plugin XPlayerKits.
- Coloca el archivo
.jar dentro de la carpeta /plugins de tu servidor.
- Inicia o recarga el servidor.
- El plugin generará una carpeta llamada
/kits, donde podrás gestionar tus kits.
Crear o Editar Kits
Para crear o modificar un kit:
- Usa el comando:
/xkits editor
- Se abrirá un menú gráfico de edición.
- Verás opciones para:
- Editar un kit existente
- Crear un nuevo kit
- Haz clic en alguna de las opciones para abrir el editor de propiedades del kit correspondiente.
Comandos
Aquí encontrarás información sobre todos los comandos disponibles del plugin.
💬 Puedes sugerir nuevos comandos en nuestro servidor de Discord.
Comandos Normales
| Comando | Descripción |
|---|
/kits | Comando heredado. Actívalo solo si es necesario, ya que puede causar conflictos. |
/xkits | Comando principal del plugin. |
/xkits kits | Abre el menú de kits. |
/xkits reload | Recarga la configuración del plugin. |
/xkits editor | Abre el editor gráfico de kits. |
/xkits slots | Abre el editor de ranuras del menú integrado. |
/xkits give <kitId> <player> | Entrega un kit a un jugador, sin verificar requisitos. |
/xkits claim <kitId> <player> | Reclama un kit para un jugador, verificando los requisitos. |
/xkits delete <kitId> | Elimina un kit directamente en el juego. |
/xkits reset <kitId> <player> | Reinicia un kit específico para un jugador. |
/xkits resetall <player> | Reinicia todos los kits para un jugador. |
Comandos de Migración
| Comando | Descripción |
|---|
/xkits migrate playerkits2_yml | Migra datos de jugadores desde PlayerKits2 en formato YML. |
/xkits migrate playerkits2_mysql | Migra datos de jugadores desde PlayerKits2 en MySQL. |
/xkits migratekits playerkits2 | Migra todos los kits del plugin PlayerKits2. |
Permisos
Aquí encontrarás la lista de permisos utilizados por el plugin.
💬 Puedes sugerir nuevos permisos en nuestro servidor de Discord.
Lista de Permisos
| Permiso | Descripción |
|---|
xkits.admin | Otorga acceso completo a todos los comandos: crear, editar y eliminar kits. |
xkits.allow.<kitId> | Permiso para reclamar un kit específico. Por defecto, los kits usan "none" (no requieren permisos). |
Creating Kits
Requisitos
En esta sección se explica cómo definir condiciones que un jugador debe cumplir para poder reclamar un kit.
¿Cómo funcionan los requisitos?
Los requisitos son expresiones condicionales simples basadas en placeholders. Si la condición se cumple, el jugador podrá reclamar el kit.
%placeholder% (comparador) valor
Ejemplo
%vault_eco_balance% >= 100
Esto significa que el jugador debe tener al menos 100 monedas para poder reclamar el kit.
Lista de Comparadores
| Comparador | Descripción |
|---|
> | Verifica si el valor del placeholder es mayor que el valor indicado. |
< | Verifica si el valor del placeholder es menor que el valor indicado. |
= | Verifica si el valor del placeholder es igual al valor indicado. |
!= | Verifica si el valor del placeholder es diferente al valor indicado. |
>= | Verifica si el valor del placeholder es mayor o igual al valor indicado. |
<= | Verifica si el valor del placeholder es menor o igual al valor indicado. |
Acciones al Reclamar
Estas acciones se ejecutan después de que un jugador reclame exitosamente un kit.
| Tipo | Descripción de ejecución | Ejemplo |
|---|
| console | Ejecuta un comando desde la consola. | console:say test |
| command | Ejecuta un comando como el jugador. | command:dm open main |
| sound | Reproduce un sonido al jugador. | sound:ENTITY_ENDERMAN_TELEPORT;1.0f;1.0f |
| message | Envía un mensaje al jugador. | message:You claimed the kit correctly. |
Acciones al Rechazar
Estas acciones se ejecutan cuando el jugador no cumple con los requisitos para reclamar un kit.
| Tipo | Descripción de ejecución | Ejemplo |
|---|
| console | Ejecuta un comando desde la consola. | console:say test |
| command | Ejecuta un comando como el jugador. | command:dm open main |
| sound | Reproduce un sonido al jugador. | sound:ENTITY_ENDERMAN_TELEPORT;1.0f;1.0f |
| message | Envía un mensaje al jugador. | message:You can’t claim this kit. |
Para cambiar el tipo de ítem en el menú, simplemente renombra el ítem con un yunque o mediante comandos como /ie rename del plugin ItemEdit.
Los siguientes nombres de ítems activan acciones especiales en los slots del menú:
| Nombre | Descripción de la acción |
|---|
{LAST_SLOT} | Va a la página anterior (solo se muestra si no estás en la primera página). |
{NEXT_SLOT} | Va a la página siguiente (solo se muestra si hay más kits en la siguiente página). |
{CLOSE} | Cierra el menú de kits. |
Placeholders
A continuación se detallan los placeholders disponibles del plugin:
| Placeholder | Descripción |
|---|
%xplayerkits_cooldown_<kitId>% | Muestra el mensaje de cooldown definido en countdown.noCountdown, o el tiempo restante. |
%xplayerkits_claimed_onetime_<kitId>% | Devuelve yes o no dependiendo de si el kit ya fue reclamado (kits de un solo uso). |
%xplayerkits_claimed_cooldown_<kitId>% | Devuelve yes o no dependiendo de si el kit se encuentra en cooldown actualmente. |
💡 Puedes sugerir nuevos placeholders en nuestro Discord.