Cambia el marcador y el HUD de pantalla
El sidebar, la barra de jefe, la barra de experiencia, el feedback de impactos, los sonidos y las partículas: qué muestra cada uno, dónde se configura y qué puede apagar un jugador.
Alrededor de cada ejercicio el plugin dibuja un marcador lateral, una barra de jefe con el tiempo y la puntuación, la cuenta atrás en la barra de experiencia, avisos de acierto y partículas. Todo se dibuja con paquetes, así que tu propio marcador e inventario nunca se tocan. Esta página muestra cómo cambiar cada pieza.
Antes de empezar#
- Acceso a la carpeta del plugin en el servidor.
/aimtraineradmin reloadvuelve a leer los archivos sin reiniciar.
Pasos#
Esto edita el marcador lateral que se ve durante un ejercicio en solitario.
Abre el archivo del marcador
Abre plugins/ExyliaAimTrainer/lang/es/scoreboards.yml (usa la carpeta del idioma de tu servidor).
Edita las líneas
Bajo training: (ejercicio en solitario) o match: (duelo), edita title y lines. Una línea puede usar cualquier placeholder %exyliaaimtrainer_<nombre>%, escrito sin el nombre del plugin, como %exyliaaimtrainer_score%, y cualquier otro placeholder que resuelva ExyliaLib.
Recarga
Ejecuta /aimtraineradmin reload. Todos los que están en un ejercicio o duelo reciben el marcador nuevo al instante.
Comprueba que funciona#
Ejecuta /aim train. El marcador muestra tus líneas nuevas mientras juegas, y tu marcador del lobby vuelve cuando sales.
Ir más allá#
Ocultar la barra de jefe o cambiar su estilo#
En config.yml, hud.boss-bar.enabled: false no muestra barra de jefe a nadie. colour y overlay cambian su aspecto, y su texto es hud.boss-bar en lang/es/messages.yml.
Cambiar sonidos y avisos de acierto#
Cada evento de un ejercicio (un acierto perfecto, un fallo, una salida en falso) es una entrada bajo feedback en lang/es/messages.yml, con su propia action bar, título y sonido. Edita o vacía lo que no quieras.
Quitar partículas o la barra de experiencia#
hud.hit-particle: "" no dibuja partículas. hud.experience-bar: false deja en paz la experiencia del jugador.
Qué pueden apagar los jugadores#
En /aim settings y luego Pantalla, cada jugador puede ocultarse el Marcador lateral, la Barra de jefe, el Aviso de aciertos, los Sonidos de acierto y las Partículas de acierto. Mira Dejar que los jugadores elijan tamaño y color. Un jugador no puede encender algo que hayas desactivado en la configuración.
Detalles técnicos
Todo lo que rodea a una ronda se dibuja con paquetes: el scoreboard, la experiencia y el inventario
reales del servidor nunca se tocan. Cinco canales, configurados en tres sitios. Lo que lee un jugador —el
sidebar, el texto de la barra de jefe y el feedback de impactos— se traduce, así que vive en la carpeta
lang/<code>/ del plugin; lo que solo decide cómo se comporta un canal se queda en config.yml.
| Canal | Se configura en | Un jugador puede apagarlo |
|---|---|---|
| Sidebar | scoreboards.yml | Sí — Marcador lateral |
| Barra de jefe | config.yml → hud.boss-bar, texto en messages.yml → hud.boss-bar | Sí — Boss bar |
| Barra de experiencia | config.yml → hud.experience-bar | No |
| Títulos, action bars y sonidos | messages.yml → feedback | Action bar y sonidos — Aviso de aciertos y Sonidos de acierto |
| Partículas de impacto | config.yml → hud.hit-particle | Sí — Partículas de acierto |
Los botones de la hotbar también forman parte del HUD; son un archivo de menú y se describen en Menús.
Sidebar#
scoreboards.yml define dos sidebars: training, que se muestra durante una sesión en solitario, y
match, que ve quien está en un duelo. Se muestra cuando el jugador entra en cualquiera de los dos y se
reconstruye cada vez que empieza una ronda en solitario. Fuera de ambos, el plugin no muestra nada, y el tablero que
tuviera debajo un plugin de lobby vuelve solo.
training:
enabled: true
title:
- "{primary}&lAIM TRAINER"
lines:
- ""
- "{secondary}Drill:"
- " {letters_black}▎ {letters}%exyliaaimtrainer_drill% {muted}· {info}×%exyliaaimtrainer_difficulty%"
- " {letters_black}▎ {letters}Time {letters_black}» {info}%exyliaaimtrainer_time_left%"
- ""
- "{secondary}Live:"
- " {letters_black}▎ {letters}Score {letters_black}» {highlight}%exyliaaimtrainer_score%"
- " {letters_black}▎ {letters}Hits {letters_black}» {success}%exyliaaimtrainer_hits% {muted}· {error}%exyliaaimtrainer_misses%"
- " {letters_black}▎ {letters}Accuracy {letters_black}» {info}%exyliaaimtrainer_accuracy%%"
- " {letters_black}▎ {letters}Streak {letters_black}» {highlight}%exyliaaimtrainer_streak%"
- " {letters_black}▎ {letters}Last {letters_black}» %exyliaaimtrainer_grade%"
- ""
- "{muted}{server-ip}"
update:
interval: 10
smart: true
cache: true
match:
enabled: true
title:
- "{primary}&lAIM TRAINER"
lines:
- ""
- "{secondary}Duel: {muted}· {letters}%exyliaaimtrainer_format%"
- " {letters_black}▎ {letters}vs {highlight}%exyliaaimtrainer_opponent%"
- " {letters_black}▎ {letters}Round {letters_black}» {info}%exyliaaimtrainer_round%"
- " {letters_black}▎ {letters}Series {letters_black}» {success}%exyliaaimtrainer_series%"
- " {letters_black}▎ {letters}%exyliaaimtrainer_match_state%"
- ""
- "{secondary}Round:"
- " {letters_black}▎ {letters}Time {letters_black}» {info}%exyliaaimtrainer_time_left%"
- " {letters_black}▎ {letters}You {letters_black}» {highlight}%exyliaaimtrainer_score% {muted}· {letters}%exyliaaimtrainer_hits% hits"
- " {letters_black}▎ {letters}Them {letters_black}» {highlight}%exyliaaimtrainer_opponent_score% {muted}· {letters}%exyliaaimtrainer_opponent_hits% hits"
- " {letters_black}▎ {letters}Accuracy {letters_black}» {info}%exyliaaimtrainer_accuracy%%"
- ""
- "{muted}{server-ip}"
update:
interval: 10
smart: true
cache: true| Clave | Por defecto | Qué hace |
|---|---|---|
enabled | true | false deja la sección escrita pero no muestra tablero en ese contexto. |
title | una línea | Una lista. Con varias entradas se anima: cada refresco muestra la siguiente. |
lines | ver arriba | Las líneas, de arriba abajo. Como máximo 15; las demás se descartan. |
update.interval | 10 | Ticks entre refrescos. 20 ticks son un segundo. |
update.smart | true | Envía solo las líneas que cambiaron en lugar del tablero entero. |
update.cache | true | Se conserva por los archivos antiguos: ExyliaLib cachea el texto parseado para todos los plugins a la vez. |
La referencia completa de claves está en la sección de Sidebars de la librería.
Qué pueden decir las líneas
A un tablero no se le empuja nada. La librería lo dibuja con su propio intervalo y pregunta a los
placeholders, así que una línea es cualquier texto con los placeholders %exyliaaimtrainer_<nombre>% de este plugin,
y cualquier otro placeholder que resuelva ExyliaLib también funciona. Este archivo lo lee el propio
plugin, así que los nombres van sin el nombre del plugin delante; la lista completa, en la forma en que
la leen otros plugins, está en Placeholders.
%exyliaaimtrainer_hits%, %exyliaaimtrainer_misses%, %exyliaaimtrainer_shots% y %exyliaaimtrainer_accuracy% significan la ronda en curso mientras hay
una y los totales de por vida del jugador en otro caso — y no hay ronda en curso durante la cuenta
atrás, mientras el jugador descansa tras un ejercicio ni entre dos rondas de un duelo. En esos momentos
las líneas Hits y Accuracy por defecto muestran números de por vida, mientras Score y Streak
leen 0 y Last lee —. Escribe las líneas teniéndolo en cuenta, o usa %exyliaaimtrainer_phase% para distinguir
los momentos.
El interruptor del jugador
Un jugador que apaga Marcador lateral en sus ajustes pierde el tablero al instante, y lo recupera al instante cuando lo vuelve a encender. Hasta entonces el tablero sigue oculto en todas sus sesiones siguientes.
Barra de jefe#
Aparece cuando empieza la cuenta atrás de una ronda, con toda la duración del ejercicio, y se redibuja mientras la ronda avanza. Su progreso es el tiempo restante. Cuando la ronda termina se queda como la dejó hasta que el jugador sale o empieza la siguiente.
hud:
boss-bar:
enabled: true
colour: PURPLE
overlay: PROGRESS
refresh-ticks: 5hud:
boss-bar: "{primary}&l%drill% {muted}· {letters}%time% {muted}· {success}%hits% {letters}hits {muted}· {info}%accuracy%% {muted}· {highlight}%score% pts"| Clave | Por defecto | Qué hace |
|---|---|---|
enabled | true | false no muestra barra de jefe a nadie. |
boss-bar en messages.yml | ver arriba | La línea de la barra. Antes de los idiomas era hud.boss-bar.text en config.yml; un archivo antiguo se mueve en su primer arranque. |
colour | PURPLE | PINK, BLUE, RED, GREEN, YELLOW, PURPLE o WHITE. |
overlay | PROGRESS | PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12 o NOTCHED_20. |
refresh-ticks | 5 | Ticks entre dos redibujados. Como mínimo 1. |
El texto conoce sus propios valores, que se rellenan en cada redibujado; no son placeholders globales.
| Valor | Qué es |
|---|---|
%drill% | El nombre visible del ejercicio |
%time% | Segundos restantes, redondeados hacia arriba: 30, 1:30 |
%hits% | Impactos hasta ahora |
%misses% | Fallos hasta ahora |
%accuracy% | Precisión sin decimales y sin el signo %: 87 |
%score% | La puntuación en vivo |
%streak% | Impactos seguidos |
%opponent_score% | La puntuación en vivo del rival en un duelo; 0 en entrenamiento en solitario |
Barra de experiencia#
Con hud.experience-bar: true (por defecto), el nivel muestra los segundos restantes y la barra se vacía
según avanza la ronda. Es un paquete por segundo; la experiencia real del servidor nunca cambia, y se
vuelve a enviar en cuanto el jugador sale. No hay interruptor por jugador.
En un ejercicio REACTION el tiempo es el tope del ejercicio, porque la ronda termina con sus intentos.
Feedback de impactos#
Cada suceso de una ronda reproduce una entrada de feedback en messages.yml. Antes de los idiomas vivía
en config.yml; un archivo antiguo se mueve en su primer arranque, sonidos incluidos. Cada entrada es un efecto
de ExyliaLib con cualquiera de estos: un título, una action bar, una barra de jefe, un sonido, una
partícula y un fuego artificial; una sección que no se escribe no hace nada. Los campos están en la
página de Efectos de la librería.
feedback:
perfect:
effect:
action-bar:
text: "{success}⚡ PERFECT {muted}· {letters}%time%s {muted}· {info}x%streak%"
duration: 1.5
sound:
name: ENTITY_EXPERIENCE_ORB_PICKUP
volume: 0.7
pitch: 1.8
chat: ""
miss:
action-bar:
text: "{error}✘ MISS {muted}· {letters}%accuracy%% accuracy"
duration: 1.5
sound:
name: ENTITY_PLAYER_ATTACK_NODAMAGE
volume: 1.0
pitch: 1.0Durante una ronda
A estas llegan los interruptores Aviso de aciertos y Sonidos de acierto del jugador: apagar uno reproduce el mismo efecto con su action bar, o su sonido, en blanco. Un título nunca se deja en blanco.
| Entrada | Cuándo | Por defecto |
|---|---|---|
perfect | Un impacto calificado PERFECT | Action bar ⚡ PERFECT · %time%s · x%streak%, sonido de orbe de experiencia con tono 1.8 |
excellent | Un impacto calificado EXCELLENT | ✦ EXCELLENT, tono 1.5 |
good | Un impacto calificado GOOD | ✔ GOOD, tono 1.2 |
ok | Un impacto calificado OK | • OK, tono 1.0 |
slow | Un impacto calificado SLOW | ▼ SLOW, tono 0.7 |
miss | Un clic que no dio a nada | ✘ MISS · %accuracy%% accuracy, ENTITY_PLAYER_ATTACK_NODAMAGE |
expired | Un objetivo FLICK al que se le acabó el tiempo | ⌛ EXPIRED · %accuracy%% accuracy, BLOCK_NOTE_BLOCK_SNARE |
false-start | Un clic REACTION antes de la luz, o uno más rápido que scoring.min-reaction-millis | ✘ TOO EARLY · wait for the light, ENTITY_VILLAGER_NO |
armed | Un objetivo REACTION que se enciende | Solo sonido, BLOCK_NOTE_BLOCK_PLING |
rushed | Un impacto COMBO dentro del cooldown de ataque | ✘ RUSHED · wait for the cooldown, ENTITY_PLAYER_ATTACK_WEAK |
Las cinco entradas de calificación tienen un segundo campo, chat: una línea de chat que se envía con el
efecto, vacía por defecto. No le afectan los interruptores del jugador. Cómo se califica un impacto está
en Puntuación.
Las entradas de calificación, miss, expired y rushed conocen estos valores:
| Valor | Qué es |
|---|---|
%grade% | La calificación en mayúsculas: PERFECT. Vacío fuera de una entrada de calificación. |
%time% | El tiempo calificado en segundos, con dos decimales: 0.42. 0.00 fuera de una entrada de calificación. |
%hits% | Impactos hasta ahora |
%streak% | Impactos seguidos |
%combo% | El combo actual |
%accuracy% | Precisión sin decimales y sin el signo % |
El primer impacto de una ronda no tiene un impacto anterior contra el que medirse, así que no tiene
calificación: reproduce solo el sonido de la entrada good, y solo si el jugador tiene los sonidos de
impacto encendidos.
Alrededor de una ronda
Estas suenan igual para todos, apague lo que apague el jugador.
| Entrada | Cuándo | Por defecto |
|---|---|---|
countdown | Cada segundo de la cuenta atrás; %time% son los segundos restantes, %time_precise% lo mismo con su unidad | Título %time% / Left click the targets, action bar Starting in %time_precise% ⌚, BLOCK_NOTE_BLOCK_HAT |
go | El primer objetivo está activo | Título GO, BLOCK_NOTE_BLOCK_PLING |
session-complete | Un ejercicio en solitario llegó al final | Título TIME, UI_TOAST_CHALLENGE_COMPLETE |
personal-best | La ronda superó el mejor rating del jugador; conoce %rating% | Título NEW BEST / Rating %rating%, ENTITY_PLAYER_LEVELUP |
match-found | Los dos duelistas han llegado a la arena | Título MATCH FOUND / Teleporting… |
round-won | Ronda de duelo ganada | Título ROUND WON, ENTITY_PLAYER_LEVELUP |
round-lost | Ronda de duelo perdida | Título ROUND LOST, BLOCK_NOTE_BLOCK_BASS |
round-draw | Ronda de duelo empatada y repetida | Título DRAW / Same score — replaying, action bar Round replayed |
match-won | Duelo ganado | Título VICTORY / Match won, UI_TOAST_CHALLENGE_COMPLETE |
match-lost | Duelo perdido | Título DEFEAT / Match lost, ENTITY_WITHER_HURT |
Partículas de impacto#
hud:
hit-particle: "ELECTRIC_SPARK|8|0.15|0.15|0.15|0.05"Se dibujan donde se golpeó un objetivo, solo para el jugador que lo golpeó. La línea es
NOMBRE|cantidad|dx|dy|dz|velocidad; una cadena vacía no dibuja nada para nadie. Un jugador con
Partículas de acierto apagado no ve ninguna.
Cuándo surte efecto un interruptor#
| Ajuste | Clave del ajuste | Surte efecto |
|---|---|---|
| Sidebar | sidebar | Al instante |
| Boss bar | boss_bar | Desde la siguiente ronda, o la siguiente ronda de un duelo |
| Hit feedback | action_bar | Desde la siguiente ronda |
| Hit sounds | hit_sounds | Desde la siguiente ronda |
| Hit particles | particles | Desde la siguiente ronda |
Un cambio hecho en mitad de una sesión además envía la línea settings.applies-next-drill. Los
interruptores se guardan en el perfil, así que sobreviven a los reinicios. Los nombres que muestra la
pantalla de ajustes están en messages.yml, bajo menu.toggles.
Nadie camina durante una ronda: el plugin descarta el movimiento propio del cliente mientras el HUD está puesto, para todos los jugadores. No hay interruptor para eso.
Recargar#
/aimtraineradmin reload vuelve a leer los tres archivos y reconstruye el sidebar de cada jugador que
esté en una sesión o en un duelo. La barra de jefe toma un text nuevo en su siguiente redibujado; su
color y su overlay se aplican desde la siguiente ronda.
¿Falta algo en esta página? Dínoslo en Discord