CXDuels es un plugin de duelos 1vs1 para servidores Spigot/Paper 1.21.11.

Que incluye

• Duelos 1vs1 con /duel <jugador>.
• Menus configurables.
• Kits editables.
• Mapas configurables sin WorldEdit.
• Apuestas de dinero, EXP y objetos.
• Modo inventario propio.
• Stats en SQLite.
• Soporte PlaceholderAPI.
• Colores HEX en menus y mensajes.

Requisitos

• Paper o Spigot 1.21.11.
• Java 21.
• Vault instalado.
• Un plugin de economia compatible con Vault si quieres apuestas de dinero.
• PlaceholderAPI opcional.

Instalacion

1. Copia CXDuels.jar dentro de la carpeta plugins de tu servidor.
2. Reinicia el servidor.
3. Se creara la carpeta plugins/CXDuels.
4. Edita los archivos .yml si quieres personalizar el plugin.
5. Usa /duel reload despues de cambiar configuraciones.

Importante: no uses original-CXDuels.jar. Ese archivo es un respaldo viejo de compilacion.

Archivos del plugin

config.yml

Configura tiempos generales, limpieza de mapas, base de datos y defaults.

menus.yml

Configura titulos, nombres, lore, materiales, cabezas base64 y botones.

messages.yml

Configura todos los mensajes enviados a jugadores.

maps.yml

Guarda mapas, spawns e iconos.

kits.yml

Guarda kits, inventarios, armaduras, mano secundaria e iconos.

data.yml

Guarda datos internos como orden personal de kits.

database.db

Base de datos SQLite donde se guardan estadisticas.

Primeros pasos

Para usar el plugin necesitas:

1. Crear o configurar un mapa.
2. Crear al menos un kit, o usar el kit default.
3. Dar permisos a los jugadores.
4. Probar /duel <jugador>.

Comandos de jugadores

/duel help

Muestra la ayuda del plugin.

/duel <jugador>

Abre el menu para crear un duelo contra ese jugador.

/duel accept

Acepta una invitacion pendiente.

/duel deny

Rechaza una invitacion pendiente.

/duel leave

Sale de un duelo o deja de espectear.

/duel spectate <jugador>

Espectea el duelo activo de un jugador.

/duel version

Muestra la version del plugin. En esta version debe mostrar 1.4.1.

/duel kitlayout <kit>

Permite ordenar un kit de forma personal sin modificar el kit global.

Aliases:

• /duel ordenarkit <kit>
• /duel ordenar <kit>

Comandos administrativos

/duel admin

Abre el panel principal de administracion.

/duel maps

Abre el menu administrativo de mapas.

/duel wand <mapa>

Entrega la wand para crear o ajustar la region de un mapa.

/duel createkit <kit>

Guarda el inventario actual como kit.

Aliases:

• /duel savekit <kit>
• /duel guardar <kit>

/duel editkit <kit>

Abre el editor visual del kit.

/duel setkiticon <kit>

Usa el item que tienes en la mano como icono del kit.

/duel deletekit <kit>

Borra un kit.

/duel setmap <mapa> pos1

Marca la posicion 1 del mapa donde estas parado.

/duel setmap <mapa> pos2

Marca la posicion 2 del mapa donde estas parado.

/duel editmap <mapa>

Abre el editor visual del mapa.

/duel deletemap <mapa>

Borra un mapa de la configuracion. No borra bloques del mundo.

/duel reload

Recarga la configuracion.

Permisos

cxduels.use

Permite usar comandos basicos y crear duelos.

cxduels.spectate

Permite espectear duelos.

cxduels.version

Permite usar /duel version.

cxduels.admin

Permite abrir menus administrativos.

cxduels.reload

Permite usar /duel reload.

cxduels.kit.manage

Permite crear, editar, borrar y cambiar iconos de kits.

cxduels.kit.layout

Permite ordenar kits de forma personal.

cxduels.map.manage

Permite configurar, editar y borrar mapas.

Como crear un mapa

Metodo rapido:

1. Ve al lugar donde aparecera el jugador 1.
2. Usa /duel setmap arena pos1.
3. Ve al lugar donde aparecera el jugador 2.
4. Usa /duel setmap arena pos2.
5. Prueba abrir /duel <jugador> y selecciona ese mapa.

Metodo con wand:

1. Usa /duel wand arena.
2. Marca la primera esquina con click izquierdo.
3. Marca la segunda esquina con click derecho.
4. Sigue las instrucciones que salen en chat.
5. Ajusta spawns si hace falta con /duel setmap arena pos1 y /duel setmap arena pos2.

Como crear un kit

Metodo rapido:

1. Ponte la armadura e items que quieres para el kit.
2. Usa /duel createkit nodebuff.
3. El kit aparecera en el selector.

Editar kit:

1. Usa /duel editkit nodebuff.
2. Cambia items en el menu.
3. Cierra el menu para guardar.

Slots del editor:

• Slots 0-35: inventario.
• Slots 45-48: armadura.
• Slot 50: mano secundaria.
• Slot 53: cerrar y guardar.

Cambiar icono:

1. Toma un item en la mano.
2. Usa /duel setkiticon nodebuff.

Como funciona un duelo normal

1. Un jugador usa /duel <jugador>.
2. Se abre el menu de creacion.
3. Elige kit, mapa, rondas y apuestas.
4. Envia la invitacion.
5. El otro jugador acepta con /duel accept.
6. Ambos son llevados al mapa.
7. Empieza una cuenta regresiva.
8. Gana quien cumpla las rondas configuradas.
9. Al terminar, ambos vuelven a su ubicacion anterior.

Modo inventario propio

El modo inventario propio hace que cada jugador pelee con los items que tenia antes de entrar.

Reglas importantes:

• Las rondas se bloquean automaticamente a 1.
• Es un combate a muerte.
• Al morir, los items del perdedor caen al suelo.
• El ganador tiene 20 segundos para recoger esos items.
• El perdedor no puede recoger esos items durante ese tiempo.
• Al terminar el tiempo, el ganador vuelve a su ubicacion anterior.

El tiempo se cambia en config.yml:

Apuestas

Dinero

• Requiere Vault.
• Requiere un plugin de economia.
• Ambos jugadores deben tener suficiente dinero.

Experiencia

• Ambos jugadores pagan la misma cantidad de EXP.

Objetos

• Se abre un menu compartido de apuesta.
• Cada jugador coloca items en su lado.
• Ambos deben marcar listo.
• Si se cancela, los items vuelven.

Configurar menus

Los menus se editan en menus.yml.

Titulos

Puedes cambiar el texto y colores.

No borres placeholders como:

• %target%
• %map%
• %kit%

Nombres de items

Cada item tiene un name.

Ejemplo:

Puedes usar colores normales:

Y tambien HEX:

Ocultar botones

Si quieres quitar un boton del menu principal, usa:

Ejemplo:

Eso oculta el boton y tambien desactiva el click.

Cambiar materiales

Usa nombres de materiales de Spigot:

Cabezas base64

Si un item usa:

puedes poner:

Si base64 esta vacio, el plugin usa la skin del jugador cuando corresponde.

Configurar mensajes

Los mensajes estan en messages.yml.

Ejemplo:

No borres placeholders como:

• %winner%
• %loser%
• %target%
• %map%
• %kit%
• %seconds%

Base de datos

CXDuels usa SQLite local para estadisticas.

Archivo:

Ventajas:

• No necesitas MySQL.
• Cada servidor tiene sus propias estadisticas.
• Es facil de distribuir a otros servidores.

Si existian estadisticas viejas en data.yml, el plugin intenta migrarlas a SQLite al iniciar.

Placeholders

Si PlaceholderAPI esta instalado, puedes usar:

Configuracion principal

Archivo: config.yml

request-timeout-seconds

Tiempo que dura una invitacion antes de expirar.

duel-start-countdown-seconds

Cuenta regresiva antes de iniciar el duelo.

own-inventory-pickup-cooldown-seconds

Tiempo que tiene el ganador para recoger items del perdedor en inventario propio.

map-cleanup-radius

Radio para limpiar items y experiencia alrededor de la arena.

database.file

Nombre del archivo SQLite.

disabled-defaults.kit

Si es true, oculta el kit default.

disabled-defaults.map

Si es true, oculta el mapa default.

Problemas comunes

No veo los cambios en menus

Revisa que estes editando:

Luego usa:

No aparece el titulo editable

Busca esta seccion:

Si no existe, reinicia el servidor con la version nueva.

No funciona la apuesta de dinero

Verifica:

• Vault instalado.
• Plugin de economia instalado.
• Los jugadores tienen dinero suficiente.

El mapa no aparece listo

El mapa necesita spawn1 y spawn2.

Usa: