Duelos

Retar

/duel <player> abre la pantalla de reto. Autocompleta a todos los jugadores de este servidor, y a todos los de la red cuando los duelos en red están activados.

Antes de abrir la pantalla, el plugin comprueba que:

• el jugador no se está retando a sí mismo;
• el retado acepta retos (/duel toggle los desactiva);
• ninguno de los dos está ya en un duelo, viendo uno o de camino a uno, ni retenido por otro plugin (una sesión de ExyliaLib como una cola o un minijuego);
• ninguno de los dos está en combate;
• hay al menos una arena lista (o, en una red, un duelo con kit podría jugarse en el servidor de arenas);
• quien reta no está en el cooldown de retos (requests.cooldown, o el exyliaduels.cooldown.<n> de su rango, que se salta con exyliaduels.bypass.cooldown).

La pantalla de reto

Una pantalla, una tarjeta por condición. Cada clic la redibuja en el sitio; ESC la cierra sin dejar nada pendiente.

La pantalla se abre con inventario propio cuando el servidor lo permite y alguna arena lo acepta; si no, con el primer kit activado. Un cambio que la arena elegida ya no acepta (otro kit, o inventario propio en una arena ligada a un kit) devuelve la arena a Aleatoria. Una apuesta de dinero que el jugador no puede pagar, o por debajo del mínimo, se rechaza al escribirla, así que la pantalla nunca muestra una apuesta que no se pueda enviar.

Cada opción depende de un nodo que todos tienen por defecto (exyliaduels.mode.own, mode.risk, bet.money, bet.items, arena.choose, kit.<id>). Un botón que el rango del jugador no incluye responde "Tu rango no incluye esa opción." y no cambia nada. Consulta Permisos.

La solicitud

Al enviar, empieza el cooldown y el jugador retado recibe un bloque centrado en el chat: quién, el modo, la arena, la apuesta y cuánto espera, con los botones clicables [✔ ACEPTAR] y [✘ RECHAZAR]. Un kit con golpes para ganar o con rondas lo indica tras su nombre: "(gana quien dé 5 golpes)", "(al mejor de 3)". Un reto espera requests.expiry (60 segundos por defecto); cuando caduca se avisa a los dos.

Cada jugador tiene como mucho un reto enviado: uno nuevo sustituye al anterior. Salir del servidor descarta todos los retos que un jugador envió o recibió.

De aceptar a luchar

Al aceptar se comprueban otra vez las condiciones, los dos jugadores y los dos saldos: el servidor, las arenas o cualquiera de los jugadores pueden haber cambiado desde que se envió el reto. Después:

El combate

• Solo los dos rivales pueden hacerse daño. Esto se aplica lo último, así que una región sin PvP de otro plugin no detiene un duelo, y nadie de fuera puede meterse. Los luchadores y los espectadores no pueden dañar a jugadores de fuera del duelo.
• Nadie sale de la arena. Un luchador no puede salir andando de las columnas de la arena, y un teletransporte hacia fuera se rechaza con "No puedes salir de la arena durante un duelo." Nadie más entra andando ni por teletransporte en una arena en uso, salvo quien tenga exyliaduels.admin.
• Caer fuera es perder. Bajar más de un bloque por debajo del suelo de la arena cuenta como una muerte, y también bajar por debajo de la profundidad de caída del kit.
• Se aplican las reglas del kit: sus flags de arena, sin daño, retraso de golpe, regeneración, hambre, las esperas de perla de ender y manzana dorada y la altura de construcción. Consulta Arenas y kits.
• Los plugins de habilidades quedan en pausa. AuraSkills y mcMMO no dan a los luchadores experiencia, habilidades ni estadísticas de combate hasta que están en casa.
• Los comandos que no estén en allowed-commands se rechazan.
• Tirar objetos se rechaza en los duelos con kit y en los de inventario propio sin riesgo: lo que devuelve la instantánea volvería dos veces. En un duelo a riesgo los objetos son de los jugadores y pueden tirarlos.
• El cofre de ender no se puede abrir desde la arena: se restaura con el jugador después.
• Morir nunca llega a pasar: la muerte se cancela y no cae nada. Durante el combate supone perder el duelo. Las tumbas, los cofres de muerte y las recompensas por kill nunca ven una muerte en duelo.

Rondas

Un kit con Rondas ajustadas se juega al mejor de 3, 5 o más. Perder una ronda (una muerte, una caída, o que el rival dé los golpes para ganar) se la apunta al otro jugador: los dos ven el marcador en el chat y en un título de RONDA GANADA o RONDA PERDIDA durante match.end-delay. Después se reponen los bloques de la arena, se retira lo que quedó por el suelo, y los dos vuelven a empezar desde sus spawns con el kit y su inicio del combate (un kit de otro plugin lo vuelve a equipar ese plugin, con la misma tirada), congelados durante match.countdown con el número de ronda bajo el título.

• Gana el duelo el primero en ganar las rondas del kit. Solo el duelo decide las estadísticas, las apuestas y lo que se juega.
• match.max-duration cubre todas las rondas juntas: si se acaba, es un empate, vaya como vaya el marcador, y se devuelven todas las apuestas.
• Desconectarse en cualquier ronda es rendir el duelo entero.
• El marcador sale en rounds-scoreboard, y el reto dice "(al mejor de N)".
• Los duelos con inventario propio, sin riesgo o a riesgo, son siempre un solo combate.

Cómo termina un duelo

Los dos ven un título de VICTORIA, DERROTA o EMPATE, y el perdedor ve el final como espectador. El resultado se queda en pantalla match.end-delay (3 segundos por defecto). Después se devuelve a los espectadores, se restaura a los dos jugadores, se liquidan las apuestas, y la arena se libera y se regenera.

Quién se lleva qué

Quien se desconectó recupera sus cosas cuando vuelve a entrar. Las victorias, derrotas y rachas solo se anotan cuando hay ganador; un empate no cambia ninguna estadística.

Después del duelo

Cuando se decide un duelo que llegó al combate, los dos jugadores leen un bloque centrado en el chat: DUELO TERMINADO con el rival, la duración ⌚ y, para un kit de rondas o de golpes, el marcador. Tres botones funcionan durante after-duel.window (5 minutos por defecto; 0s los desactiva):

Un botón pulsado fuera de su plazo, o por alguien que no estaba en el duelo, responde "Ese duelo ya no se puede consultar." En una red el resumen se guarda en la base de datos compartida hasta que se cierra su plazo, así que los botones funcionan desde el servidor al que se haya devuelto a los jugadores.

Historial

/duel history muestra tus duelos terminados, del más reciente al más antiguo: resultado, rival, modo, marcador, duración ⌚ y fecha, con tus victorias, derrotas y empates entre ellos. /duel history <player> muestra los de cualquiera y necesita exyliaduels.history.others. Cada duelo abre una pantalla con el modo y la arena, el marcador, la apuesta de dinero, el tiempo, el servidor que lo decidió, y Ver repetición.

Se guarda cada duelo que llegó al combate, empates incluidos; un duelo cancelado antes del combate nunca. Cada jugador guarda history.keep duelos (45 por defecto) durante como mucho history.max-age (30 días).

Repeticiones

Cada duelo que llega al combate se graba (o solo los duelos con kit, con replays.kit-only): los dos luchadores, cada flecha, perla y poción, cada bloque puesto, roto o volado dentro de la arena, y cada ronda. Ver repetición da al espectador una copia libre de la misma arena, donde vuela alrededor del combate como una cámara que nadie puede tocar, manejada desde una barra rápida:

Encima se muestran el tiempo, la duración y la velocidad. /duel leave, desconectarse o un apagado también salen, y al espectador se le deja exactamente como estaba. La barra solo la ve quien mira: lo que lleva de verdad no se toca.

• Tus propios duelos necesitan exyliaduels.replay; los de cualquiera, exyliaduels.replay.others.
• La repetición se ve en su propia arena: un servidor sin esa arena la rechaza con "La arena de ese duelo no está en este servidor.", y cuando todas las copias están en uso, "No hay ninguna copia libre de esa arena ahora mismo."
• Se guarda una sola repetición para los dos jugadores, y se borra con la última fila del historial que la muestra, o pasado replays.max-age (14 días).

Espectadores

/duel spectate <player> permite ver un duelo que se está jugando en este servidor, desde dentro de la arena, en modo espectador. Autocompleta a los jugadores que luchan aquí. Se guarda al espectador y se le lleva entre los dos spawns, un poco por encima; se avisa a los dos luchadores de quién está mirando.

Un espectador no puede salir de la caja de la arena y solo puede usar los comandos de allowed-commands. /duel leave lo devuelve exactamente como vino, y el final del duelo también. Se desactiva con spectators.enabled: false.

Estadísticas

Cada jugador tiene sus estadísticas: victorias, derrotas, racha actual de victorias, mejor racha y dinero ganado. /duel stats muestra las tuyas, /duel stats <player> las de cualquiera que el servidor conozca.

El dinero ganado solo cuenta los pagos en la moneda configurada (bets.money.currency, o la del servidor por defecto): cantidades en monedas distintas no se suman.

El porcentaje de victorias, los duelos jugados, las clasificaciones de victorias y rachas, y el rival y el resultado del último duelo son placeholders: consulta Placeholders.

/duel toggle deja de recibir retos o vuelve a recibirlos; se guarda con las estadísticas, así que sigue al jugador entre servidores que comparten la base de datos.