Configuración
Cada clave de config.yml, las recompensas de triggers.yml, dónde se documentan los demás archivos, y los mensajes y menús.
plugins/ExyliaRandomKitsCore/config.yml guarda todo lo ajustable que no es un mensaje, una rareza ni una
recompensa. Las arenas y los kits se crean en el juego con /rkadmin. Los tiempos se escriben 30s, 5m o
1h30m. Aplica una edición a mano con /rkadmin reload, o edítalo en el
editor web, que lo aplica solo.
| Archivo | Se documenta en |
|---|---|
config.yml | Esta página. |
triggers.yml | Recompensas, más abajo. |
rarities.yml | Kits. |
progression.yml, perks.yml, missions.yml | Progresión. |
events.yml, seasons.yml | Eventos y temporadas. |
balance.yml | Balance de kits. |
database.yml | La base de datos de ExyliaLib. |
Idioma
languagestringpor defecto defaultdefault sigue el idioma de config.yml de ExyliaLib; un código como en o es lo fija solo para este
plugin. Se incluyen en, es, fr, pt, ru y tr, cada uno una carpeta bajo lang/ que puedes editar.
debugbooleanpor defecto falseExplica en la consola lo que hace el plugin, incluidas las kills rechazadas.
Grupo de red
network-groupstringpor defecto Los servidores de una red que comparten kits, arenas, estadísticas y clasificaciones escriben aquí el mismo grupo y apuntan a una base de datos, con Redis para que los cambios lleguen a los demás al momento. Vacío mantiene las tablas normales. Minúsculas, dígitos y guiones bajos, como mucho 24. Consulta Red y ExyliaDuels.
Entrada automática: auto-join
| Clave | Por defecto | Qué hace |
|---|---|---|
auto-join.enabled | false | Mete en una arena a cada jugador que entra al servidor: para servidores que solo tienen RandomKits. |
auto-join.arena | "" | El id de la arena. Vacío elige cualquier arena lista. |
Tiradas: roll
| Clave | Por defecto | Qué hace |
|---|---|---|
roll.anti-repeat | 3 | Un jugador nunca vuelve a recibir uno de sus últimos N kits mientras se puedan tirar otros. |
roll.pity | {epic: 10, legendary: 40} | Protección contra la mala suerte: tras estas tiradas seguidas por debajo de una rareza, la siguiente es al menos de esa rareza. 0 desactiva una regla. |
roll.draft-size | 3 | Kits que se ofrecen a la vez en las arenas Draft. |
roll.draft-timeout | 10s | Cuánto espera un draft una elección antes de quedarse el primer kit. |
roll.draft.display | MENU | MENU abre un menú con los kits, CHAT envía botones clicables. |
Muertes: death
| Clave | Por defecto | Qué hace |
|---|---|---|
death.drops | CONSUMABLES | Lo que deja una muerte en el suelo: NONE, CONSUMABLES (los roles de abajo) o ALL. |
death.consumable-roles | [FOOD, POTIONS, PEARLS, ARROWS, BLOCKS] | Roles que cuentan como consumibles. |
death.drop-lifetime | 10s | Cuánto se quedan en el suelo los objetos soltados. |
death.void-margin | 2 | Bloques por debajo de la caja más baja de la arena que aún cuentan como dentro; más abajo es una caída. |
Asistencias: assists
| Clave | Por defecto | Qué hace |
|---|---|---|
assists.minimum-percent | 25.0 | Parte del daño que recibió una víctima, de 0 a 100, que da una asistencia. |
assists.window | 15s | Solo cuenta el daño hecho en este tiempo, para las asistencias y para la propia kill. |
Rachas: streaks
| Clave | Por defecto | Qué hace |
|---|---|---|
streaks.milestones | [5, 10, 15, 20, 25, 30, 50] | Rachas que se anuncian a la arena. |
streaks.end-minimum | 5 | Cortar una racha al menos así de larga ejecuta on-streak-end para el asesino. |
Evolución del kit: evolution
| Clave | Por defecto | Qué hace |
|---|---|---|
evolution.steps | tres pasos, en 3, 5 y 10 | Los pasos que sigue cada kit. |
evolution.kits | {} | Kits que siguen sus propios pasos, por id de kit, cada uno con sus steps. |
Un paso: streak, enchant-bonus (niveles que se suman a cada encantamiento del equipo puesto y en mano),
items (item como fuente de objeto de ExyliaLib, amount, role), effects (NAME|LEVEL|SECONDS, hasta
la siguiente muerte) y feedback (líneas de secuencia de ExyliaLib). Consulta
Jugar.
evolution:
steps:
- streak: 5
enchant-bonus: 1
items: []
effects: []
feedback:
- '[SOUND] BLOCK_ANVIL_USE;0.7;1.4'
- '[TITLE] ;{highlight}&lKIT EVOLVED {letters_black}» {info}+1 enchant;0.1;1.5;0.4'Antiabuso: anti-abuse
| Clave | Por defecto | Qué hace |
|---|---|---|
anti-abuse.same-address | true | Ni recompensas ni estadísticas por una kill cuando asesino y víctima comparten dirección o cuenta. |
anti-abuse.repeat-limit | 3 | Ni recompensas ni estadísticas cuando un asesino mató a la misma víctima más de estas veces dentro de la ventana. 0 lo desactiva. |
anti-abuse.repeat-window | 10m | La ventana de repeat-limit. |
anti-abuse.fresh-spawn | 3s | Ni recompensas ni estadísticas por matar a un jugador que apareció hace menos de esto. |
anti-abuse.afk | 60s | Ni recompensas ni estadísticas por matar a un jugador que lleva esto sin moverse. 0s lo desactiva. |
Némesis: nemesis
| Clave | Por defecto | Qué hace |
|---|---|---|
nemesis.min-kills | 2 | Kills sobre un jugador que convierten al asesino en su némesis. Gana el que más kills tiene, y en un empate el más reciente. |
nemesis.tracked | 5 | Rivales que sigue cada jugador; pasado eso se olvida al que menos kills tiene. |
Distribución por defecto: layout
Dónde cae cada rol del kit cuando un jugador no ha guardado una distribución. Las ranuras 0-8 son la barra, las 9-35 el inventario. Los roles que no aparecen ocupan la primera ranura libre.
layout:
WEAPON: 0
BOW: 1
PEARLS: 2
POTIONS: 3
FOOD: 7
BLOCKS: 8
ARROWS: 9Arenas: arenas
| Clave | Por defecto | Qué hace |
|---|---|---|
arenas.spawn-protection | 3s | La protección de spawn con la que empieza una arena nueva. |
arenas.placed-blocks | 30s | Los bloques que pone un jugador en una arena desaparecen pasado esto. 0s los deja hasta el siguiente reinicio. |
Estadísticas: stats
| Clave | Por defecto | Qué hace |
|---|---|---|
stats.save-interval | 30s | Cada cuánto se escriben en la base de datos las estadísticas de los jugadores conectados. |
stats.leaderboard-refresh | 60s | Cada cuánto se vuelven a leer las clasificaciones. |
stats.leaderboard-size | 10 | Entradas que guarda cada clasificación. |
Balanceo y Duels
balancing envía jugadores entre los servidores de un grupo, y duels es el kit aleatorio de ExyliaDuels. Los
dos se documentan en Red y ExyliaDuels.
Comandos en una arena: allowed-commands
allowed-commandslistpor defecto [rk, randomkits, msg, tell, w, whisper, m, r, reply]Los únicos comandos que puede usar un jugador dentro de una arena, sin la barra. Todo lo demás se rechaza.
También se reconocen los alias con prefijo de plugin (essentials:msg). Cambiarla desde el editor web queda a
la espera de confirm.
Recompensas: triggers.yml
El plugin no paga nada por sí mismo: todo lo que paga es una lista con nombre de recompensas de ExyliaLib en
triggers.yml, que se ejecuta cuando pasa algo en una arena, a través del pipeline de boosters de ExyliaLib.
| Trigger | Se ejecuta para |
|---|---|
on-kill | El asesino. |
on-death | La víctima. |
on-assist | Cada jugador que asiste. |
on-streak-<n> | El asesino que llega a esa racha, como on-streak-5. |
on-streak-end | Quien corta una racha de al menos streaks.end-minimum. |
on-roll-<rareza> | Tirar un kit de esa rareza, como on-roll-legendary. |
on-first-join | La primera vez que la red ve al jugador. |
on-arena-join, on-arena-leave | Entrar y salir de una arena. |
on-level-up, on-level-<n> | Cada subida de nivel, o llegar a ese nivel (%level%). |
on-prestige | Un prestigio (%prestige%). |
on-mastery-<n> | Llegar a ese nivel de maestría con un kit (%kit%, %level%). |
on-mission-complete | Cada misión completada (%mission%, %pool%). |
on-revenge | Matar a tu némesis. |
on-nemesis-new | La víctima, cuando %killer% pasa a ser su nuevo némesis. |
on-event-start-<id>, on-event-win-<id> | Consulta Eventos. |
Por defecto una kill paga 10, una asistencia 3 y cortar una racha 25, en la moneda por defecto del servidor.
Una recompensa tiene un type y lo que el tipo necesita:
| Tipo | Necesita |
|---|---|
COMMAND | command, ejecutado por la consola: give %player% diamond 1. |
MESSAGE | message: %prefix% {success}+10 coins. |
ECONOMY | amount, y currency (vacío es la moneda por defecto del servidor). |
EXPERIENCE | amount, en puntos de experiencia. |
ITEM | item, y opcionalmente min-amount y max-amount para una cantidad aleatoria. |
POTION | effect: SPEED|2|10. |
Opcional en cualquiera: chance (0-100), permission, condition ('%player_level% >= 10'). Placeholders:
%player%, %killer%, %victim%, %streak%, %kit%, %rarity%, %arena%.
arenas guarda listas por arena, por id de arena, que sustituyen ahí a la lista global del mismo trigger:
triggers:
on-kill:
- type: ECONOMY
amount: '10'
arenas:
ranked:
triggers:
on-kill:
- type: ECONOMY
amount: '25'
- type: MESSAGE
message: '%prefix% {success}+25 {letters}for a ranked kill'La mejora rewards y el prestigio suben lo que pagan (no en arenas con las mejoras desactivadas), y también los
eventos MULTIPLIER. Cambiar una recompensa COMMAND desde el editor web queda a la espera de confirm.
Mensajes
lang/<idioma>/messages.yml guarda cada línea de chat, título, boss bar y etiqueta, agrupadas como arena,
roll, fight, streak, stats, top, layout, progression, reroll, perks, missions, events,
seasons, nemesis, balance, network, duels, admin, prompts, imports y labels. Los colores usan
tokens de paleta como {primary}, así que cambiar los colores del servidor nunca obliga a editar este archivo.
%prefix%se sustituye por el valor deprefix,{primary}&lRANDOMKITS {letters_black}•<reset>. Un mensaje vacío no se envía.- Un mensaje puede empezar con una etiqueta de efecto, que nunca llega a la pantalla:
[sound:NAME|volume|pitch]reproduce un sonido,[center]centra la línea. progression.prestige-display,progression.mastery-titlesyprogression.ascended-suffixson cómo se escriben el prestigio, los títulos de maestría y los kits Ascended.labelsson las palabras que se inyectan en menús y mensajes (activado, desactivado, los modos de tirada, todos los kits), así que un cambio de paleta reestiliza cada pantalla.
Menús
Las pantallas de jugador de lang/<idioma>/menus/user/ son tuyas para retocar: una actualización solo añade lo
que falta. Las pantallas de admin de menus/admin/ se regeneran desde el jar en cada arranque. Consulta
los menús de ExyliaLib para el formato.
¿Falta algo en esta página? Dínoslo en Discord