Configuración
config.yml clave por clave, las carpetas de idioma, messages.yml, los archivos de menú y dónde se configura la base de datos.
Todo se genera en plugins/ExyliaTotemTrainer/ en el primer arranque, con comentarios. Edita los
archivos de ahí, nunca las copias del jar. Los tiempos son segundos con decimales salvo que una clave diga
ticks; veinte ticks son un segundo. Los colores usan tokens de paleta como {primary} o {success}; mira
Colores.
Tras editar un archivo, ejecuta /totemtraineradmin reload (permiso exyliatotemtrainer.admin): vuelve a
leer la configuración, las carpetas de idioma y los menús sin reiniciar. Las arenas, los perfiles y los
récords están en la base de datos, no en estos archivos, así que un reload nunca los toca.
Lo que más cambian los dueños#
- Velocidades y cuenta atrás del entrenamiento:
training.ticks,training.default-ticks,training.countdown.default-ticksycountdowntambién son botones en/totemtraineradmin→ Ajustes → Entrenamiento. - Longitud y tiempos de los duelos:
match.formats,match.round-delay,match.duel-request-expiry. En el juego (Ajustes → Partidas). Guía: Configura los duelos. - Lo estricta que es la calificación:
performance.defaults,fail-penalty,speed-weights. En el juego (Ajustes → Puntuación). Guía: Ajusta la calificación. - Tamaño de clasificaciones e historial, aislamiento del chat:
leaderboard.entries,history.entries,history.retention-days,chat.isolation. En el juego: Ajustes → Récords y chat. - Tus propios modos:
training.modes, solo en config. Guía: Elige y ajusta los modos. - Idioma, mensajes, sidebar y menús:
languagey la carpetalang/<idioma>/. Mira Mensajes e idiomas y Editar menús. - Base de datos:
database.yml, que escribe ExyliaLib. Mira Base de datos.
config.yml#
El archivo entero como se genera
language: default
training:
modes:
normal:
display-name: Normal
totems: 0
refill: false
close-inventory: false
icon: CHEST
description: One full inventory of totems. When it runs out, you are done.
infinite:
display-name: Infinite
totems: 0
refill: true
close-inventory: false
icon: TOTEM_OF_UNDYING
description: A full inventory, refilled forever. It ends when you miss one.
random:
display-name: Random
totems: 1
refill: false
close-inventory: false
icon: ENDER_EYE
description: A single totem, in a different random slot after every pop.
chaos:
display-name: Chaos
totems: 1
refill: false
close-inventory: false
random-interval:
min-ticks: 10
max-ticks: 30
icon: ENDER_PEARL
description: Random slot and random timing. Nothing is where you left it.
acceleration:
display-name: Acceleration
totems: 3
refill: false
close-inventory: false
speed-up:
every: 10
by: 5
min-ticks: 5
icon: SUGAR
description: Three totems on screen, faster every 10 pops. Find your ceiling.
blackout:
display-name: Blackout
totems: 0
refill: true
close-inventory: true
icon: ENDER_CHEST
description: A full inventory that slams shut on every pop. Open it again, fast.
ticks: [25, 20, 15, 10, 5]
default-ticks: 20
countdown: 3.0
performance:
defaults:
perfect: 0.25
excellent: 0.40
good: 0.60
ok: 0.90
by-ticks: {}
by-mode: {}
points:
perfect: 100
excellent: 85
good: 70
ok: 50
slow: 25
fail-penalty: 15
full-credit-pops: 20
speed-weights:
"25": 0.8
"20": 1.0
"15": 1.5
"10": 2.5
"5": 5.0
reference-ticks: 20
match:
formats: [1, 3, 5, 7]
default-format: 3
allow-even-formats: false
round-delay: 3.0
result-delay: 5.0
duel-request-expiry: 30.0
duel-request-cooldown: 15.0
allowed-commands: [totem, tt, totemtrainer, msg, r, tell, w]
leaderboard:
entries: 10
cache-seconds: 300
history:
entries: 20
retention-days: 30
prune-interval-minutes: 60
arena:
max-matches-per-arena: 0
return-location: ""
arenas-scope: default
chat:
isolation: true
debug: falselanguage#
De qué carpeta bajo plugins/ExyliaTotemTrainer/lang/ se leen los menús, messages.yml y
scoreboards.yml. default sigue el language puesto en el propio config.yml de ExyliaLib, así que una
línea ahí cambia todos los plugins de Exylia; en, es, pt, fr, ru o tr fijan solo este plugin. Cada
idioma es una carpeta completa que puedes editar:
plugins/ExyliaTotemTrainer/
config.yml
lang/es/messages.yml
lang/es/scoreboards.yml
lang/es/menus/*.ymlEl inglés es la base sobre la que se ponen los demás, así que una línea aún sin traducir llega en inglés.
En el primer arranque de 1.1.0, los antiguos messages.yml, scoreboards.yml y menus/ se mueven a
lang/custom/, y config.yml apunta ahí con language: custom, así que no se pierde nada de lo que el
servidor editó. La sección feedback pasa de config.yml a ese messages.yml entera, sonidos incluidos.
Pon language en default o en un código para pasar a las traducciones incluidas.
training#
| Clave | Por defecto | Qué hace |
|---|---|---|
modes | seis modos | Un bloque por modo; una clave nueva es un modo nuevo, sin código. La clave es el id del modo que usan comandos, récords, tablas y placeholders. Los menús listan los modos en el orden del archivo. Ver Modos. |
modes.<id>.display-name | Lo que ven los jugadores. Admite tokens de paleta. | |
modes.<id>.totems | Tótems mantenidos en ranuras aleatorias a la vez; el que explota vuelve en otra ranura. 0 entrega un inventario completo en su lugar. | |
modes.<id>.refill | Solo modos de inventario completo: entregar otro inventario cuando se va el último tótem. false termina la sesión ahí. | |
modes.<id>.close-inventory | Cierra el inventario de golpe tras cada pop, así que hay que volver a abrirlo antes de poder cambiar el siguiente tótem de mano. | |
modes.<id>.random-interval | ausente | min-ticks y max-ticks. Cada intervalo se sortea dentro de la ventana, desplazada para que la velocidad elegida quede en su centro. max-ticks: 0 lo apaga, y el bloque se deja fuera del archivo. |
modes.<id>.speed-up | ausente | every golpes entre dos aceleraciones, by ticks que se quitan cada vez, min-ticks el suelo. by: 0 o every: 0 lo apaga, y el bloque se deja fuera. |
modes.<id>.icon | Material o cabeza usada en los menús. | |
modes.<id>.description | Una línea mostrada bajo el modo en los menús. | |
ticks | [25, 20, 15, 10, 5] | Los intervalos entre golpes que un jugador puede elegir. Cualquier otro valor se rechaza. |
default-ticks | 20 | El intervalo usado cuando un comando lo omite y la primera vez que un jugador abre un selector. |
countdown | 3.0 | Segundos antes del primer golpe, en entrenamiento y en cada ronda de duelo. 0 empieza al instante. |
performance#
| Clave | Por defecto | Qué hace |
|---|---|---|
defaults | 0.25 / 0.40 / 0.60 / 0.90 | La reacción más lenta, en segundos, que todavía gana perfect, excellent, good y ok. Más lento que ok es slow. |
by-ticks | vacío | Sobrescrituras por intervalo de ticks, con el intervalo como texto por clave. Se mira primero. Vacío a propósito: la calificación es un solo estándar a cualquier velocidad, y lo difícil que es una velocidad le toca a speed-weights. |
by-mode | vacío | Sobrescrituras por id de modo. Se mira después de by-ticks. |
points | 100 / 85 / 70 / 50 / 25 | Puntos que vale cada calificación en la puntuación de 0 a 100. |
fail-penalty | 15 | Puntos que se restan a la puntuación por cada fallo. |
full-credit-pops | 20 | Pops que necesita una sesión para que su puntuación cuente entera; por debajo, la media se escala según lo que faltó. 0 puntúa la media sola. |
speed-weights | 25: 0.8, 20: 1.0, 15: 1.5, 10: 2.5, 5: 5.0 | Cuánto vale una velocidad en la tabla. El rating de una sesión es su puntuación de 0 a 100 por el peso del intervalo al que se jugó, con el intervalo como texto por clave. |
reference-ticks | 20 | El peso de un intervalo que falta en speed-weights: este intervalo pesa 1.0 y cualquier otro reference-ticks / ticks. |
Ver Calificación para la fórmula.
match#
| Clave | Por defecto | Qué hace |
|---|---|---|
formats | [1, 3, 5, 7] | Longitudes de best-of ofrecidas en la pantalla de duelo y aceptadas por /totem duel. |
default-format | 3 | La longitud usada cuando un comando la omite y la primera vez que un jugador abre el selector. |
allow-even-formats | false | Si las longitudes pares de formats se ofrecen o no. |
round-delay | 3.0 | Segundos entre el fin de una ronda y la siguiente cuenta atrás. |
result-delay | 5.0 | Segundos que el resultado se queda en pantalla antes de devolver a los dos jugadores. |
duel-request-expiry | 30.0 | Segundos que una solicitud sigue abierta. Nunca menos de uno. |
duel-request-cooldown | 15.0 | Segundos que un jugador espera entre dos solicitudes que envió. Solo una solicitud que llegó a su destinatario empieza la espera. 0 la quita. |
allowed-commands | [totem, tt, totemtrainer, msg, r, tell, w] | Etiquetas de comando que un jugador aún puede ejecutar mientras entrena o está en un duelo. Un prefijo plugin:comando se quita antes de comprobar. |
leaderboard#
| Clave | Por defecto | Qué hace |
|---|---|---|
entries | 10 | Filas mostradas por tabla. |
cache-seconds | 300 | Segundos que se guarda una tabla antes de volver a preguntar a la base de datos. Nunca menos de cinco. |
history#
| Clave | Por defecto | Qué hace |
|---|---|---|
entries | 20 | Duelos mostrados a un jugador en /totem history. |
retention-days | 30 | Los duelos más antiguos que esto se borran. 0 lo guarda todo. |
prune-interval-minutes | 60 | Cada cuánto corre la limpieza. La primera pasada es un minuto después del arranque. |
arena#
| Clave | Por defecto | Qué hace |
|---|---|---|
max-matches-per-arena | 0 | Duelos y sesiones en solitario simultáneos que aloja una arena. 0 es ilimitado. |
return-location | vacío | Adónde se envía a un jugador al salir, como world,x,y,z o world,x,y,z,yaw,pitch. Vacío lo devuelve a donde estaba. |
arenas-scope | default | Qué servidores comparten las arenas guardadas en la base de datos. default sigue el grupo de red de config.yml de ExyliaLib (servidores idénticos comparten; sin grupo hay una sola tabla compartida), server da a cada servidor las suyas, global comparte con todos, cualquier otro valor es el nombre de un grupo. Se lee al arrancar. |
chat#
| Clave | Por defecto | Qué hace |
|---|---|---|
isolation | true | Mantiene el chat de una sesión o de un duelo dentro de él: quien está en uno lee ese y nada más, y el resto del servidor no lee nada de él. false deja el chat tal como lo entrega el plugin de chat del servidor. Se lee en cada mensaje, así que una recarga lo cambia al momento. |
debug#
false por defecto. true imprime líneas de depuración en la consola.
messages.yml#
lang/<idioma>/messages.yml. Cada línea que dice el plugin. %prefix% se expande al valor prefix de la cabecera del archivo,
{primary}&lTOTEM {letters_black}•<reset> por defecto. Los colores son tokens de paleta, así que recolorear la red nunca
significa editar este archivo; las etiquetas MiniMessage también funcionan, y la solicitud de duelo usa
<click> y <hover> para sus botones ACEPTAR y RECHAZAR, y [center] para centrar cada una de sus líneas.
Una línea puede abrir con una etiqueta de efecto, que nunca llega a la pantalla: [sound:NAME|volume|pitch]
reproduce un sonido a quien recibe la línea. Los valores por defecto usan tres de forma consistente:
ENTITY_VILLAGER_NO para un rechazo, ENTITY_EXPERIENCE_ORB_PICKUP para algo que funcionó y
BLOCK_NOTE_BLOCK_PLING para algo que pide atención.
| Sección | Contiene |
|---|---|
no-permission, player-only, player-not-found | Los tres rechazos de comando. |
reload | started, done (%steps%, %ms%), failed. |
common | busy, busy-elsewhere (%plugin%), busy-advice (%reason%), not-in-anything, left, command-blocked, no-arena, y las palabras yes y no. |
training | started, stopped, completed, failed (%pops%), unknown-mode, unknown-ticks. El resumen es una pantalla, menus/training_result.yml. |
match | starting, round-start (%round%, %rounds%), round-won, round-lost, round-draw, ready, opponent-ready, no-arena, unknown-format, cancelled, opponent-left, forfeited; la lista round-summary (%round%, %winner%, %pops%, %average%, %best%, %score%, %score_for%, %score_against%) y la lista match-summary (%winner%, %loser%, %score_winner%, %score_loser%, %format%, %mode%, %ticks%, %pops%, %best%, %average%, %duration%). |
duel | request-sent, request-cooldown (%time%, %seconds%), la lista request-received (%player%, %mode%, %ticks%, %format%, %time%, %seconds%), accepted, expired, expired-sent, no-pending, target-busy, target-not-ready (%target%, %reason%), self-duel, denied, denied-by. |
admin | Lo que confirman las pantallas de administración: arena creada, borrada, ya existe, no encontrada, renombrada, spawn puesto, activada, desactivada, duelo cancelado, estadísticas reiniciadas, cancelado; los títulos y descripciones de las tres pantallas de confirmación (%arena%, %player%); y lo que preguntan los prompts de arena y el asistente de spawn (%spawn%). |
menu | Palabras que los menús necesitan y no son una línea entera: los títulos de victoria y derrota, none (—), loading, los textos de vacío de cada lista, las tres etiquetas de estado, reason-self, reason-busy, set, not-set, categories, ticks-label, all-speeds (el botón de velocidad de la tabla antes de acotarlo), las líneas de regla de cada modo, y grades, cómo se llama cada calificación. |
feedback | Los efectos de cada pop, fallo, cuenta atrás y momento del duelo. Ver feedback más abajo. |
menu.categories da nombre e icono a las cinco categorías de la tabla:
menu:
categories:
rating:
name: Rating
icon: NETHER_STAR
best_pops:
name: Most pops
icon: TOTEM_OF_UNDYING
fastest_average:
name: Fastest average
icon: CLOCK
best_streak:
name: Best streak
icon: BLAZE_POWDER
longest_run:
name: Longest run
icon: FEATHERfeedback#
Lo que un jugador ve y oye, en messages.yml desde 1.1.0 para que se traduzca con el resto. Cada
entrada es un efecto de ExyliaLib: title, action-bar, boss-bar, sound, particle y
firework, todos opcionales. Una subsección que no hace nada se deja fuera del archivo, y quitar una
sección deja ese canal en silencio.
| Clave | Se dispara cuando | Placeholders |
|---|---|---|
perfect, excellent, good, ok, slow | Un pop ganó esa calificación. Cada una tiene un effect y una línea chat, vacía para ninguna. | %grade% (PERFECT…), %reaction% en segundos, %pops%, %streak% |
fail | No había tótem en la mano cuando llegó un golpe. | — |
countdown | La cuenta atrás antes del primer golpe; el título y la action bar se refrescan con el tiempo que queda. | %time% (los segundos), %time_precise% (lo mismo con su unidad) |
match-found | Ambos duelistas llegaron a la arena. | — |
round-won, round-lost | Se decidió una ronda. | — |
round-draw | Ambos lados soltaron el tótem en el mismo tick; la ronda se repite. | — |
match-won, match-lost | Se decidió el duelo. | — |
training-complete | Un modo de inventario completo sin refill usó su último tótem. | — |
Las claves del efecto son las de ExyliaLib: title { text, subtitle, fade-in, stay, fade-out, time-style },
action-bar { text, duration, time-style }, sound { name, volume, pitch, category }. Ver la
página de efectos de la librería para boss-bar, particle y firework.
scoreboards.yml#
lang/<idioma>/scoreboards.yml. Dos sidebars, training y match, movidos por completo por placeholders. Ver
Scoreboard.
menus/#
Cada pantalla es un archivo YAML bajo lang/<idioma>/menus/:
| Archivo | Pantalla |
|---|---|
main.yml | El hub que abre /totem. Con el estilo de menú SCREEN es la pantalla nativa de screens/main.html (solitario, duelos, tablas y perfil en una sola app), con sus textos en lang/<idioma>/screens/main.yml. |
training.yml | Filas de modo sobre el selector de ticks. |
opponents.yml | Quién está conectado y libre para un duelo. |
duel.yml | Modo, velocidad y formato de una solicitud. |
profile.yml, records.yml, history.yml | Los números de un jugador, sus mejores marcas por modo y velocidad, sus duelos recientes. |
leaderboard_modes.yml, leaderboard.yml | El selector de modos y la tabla de un modo. |
result.yml | La pantalla tras un duelo, con el botón de revancha (screens/result.html con el estilo SCREEN). |
training_result.yml | La pantalla tras una sesión en solitario, con Jugar de nuevo y Volver ▸ Entrenamiento solo. |
admin/main.yml, admin/arenas.yml, admin/arena.yml, admin/duels.yml, admin/players.yml, admin/settings.yml, admin/settings_training.yml, admin/settings_matches.yml, admin/settings_scoring.yml, admin/settings_records.yml | Las pantallas de staff. Borrar una arena, cancelar un duelo y reiniciar a un jugador preguntan antes con un diálogo de confirmación. |
Los archivos de jugador siguen la versión sin pisarte: un archivo que falta se escribe, una clave nueva se
añade, y un valor por defecto cambiado espera en /exylialib updates en lugar de sustituir tu edición. La carpeta admin/ se reescribe desde el jar en cada arranque, para
que un botón añadido en una versión te llegue; nada que debas editar vive ahí.
Un archivo que no se puede leer se informa en la consola con su ruta y el motivo, y esa única pantalla no abre hasta que se arregle. Todo lo demás sigue funcionando.
El formato es el YAML declarativo de menús de ExyliaLib; ver la
página de menús de la librería. Las acciones de clic viven bajo el espacio
totemtrainer, por ejemplo totemtrainer:open training.
database.yml#
Lo escribe ExyliaLib la primera vez que arranca el plugin: H2 por defecto, con MySQL, MariaDB, PostgreSQL y MongoDB como alternativas. Arenas, perfiles, récords de entrenamiento e historial de duelos viven ahí. Ver la página de base de datos de la librería.
¿Falta algo en esta página? Dínoslo en Discord