Mensajes y títulos de CannonRTP
Todos los textos para jugadores están en plugins/CannonRTP/messages.yml y se pueden sustituir por completo. Cada valor admite degradados de MagmaCore, <gradient:#start:#end>...</gradient>, etiquetas MiniMessage y códigos de color clásicos &. El marcador $prefix de cualquier mensaje se sustituye por el valor configurado en prefix.
La versión 1 solo incluye inglés; la clave language de config.yml está prevista para futuros paquetes de traducción.
Prefijo y cabecera de ayuda
| Clave | Marcadores | Predeterminado | Descripción |
|---|---|---|---|
prefix | -- | <gradient:#ff9a3d:#ffd166>CannonRTP</gradient> &8| | Prefijo que se inserta mediante $prefix |
helpHeader | $prefix | $prefix &fCannonRTP commands: | Línea inicial de /cannonrtp, /wc help y /wc list / /wc status |
Mensajes de chat
| Clave | Marcadores | Descripción |
|---|---|---|
createdCannon | $prefix, $cannon, $id, $path | Se envía al completar /wc create |
placedCannon | $prefix, $cannon | Se envía al completar /wc place |
removedCannon | $prefix, $cannon | Se envía al completar /wc remove |
deletedCannon | $prefix, $cannon | Se envía al completar /wc delete |
targetWorldUpdated | $prefix, $cannon, $world | Se envía al completar /wc target |
searchCenterUpdated | $prefix, $cannon | Se envía al completar /wc center |
reload | $prefix, $count | Se envía cuando los comandos de edición de cañones reconstruyen las colocaciones. /wc reload recarga el plugin completo y usa el mensaje de finalización compartido de MagmaCore. |
noPermission | $prefix, $cannon | Se envía al entrar en un cañón sin su requiredPermission, como máximo una vez cada 3 segundos por jugador y cañón |
launchCooldown | $prefix, $cannon, $seconds, $unit | Se envía al entrar en cualquier cañón antes de terminar el tiempo de reutilización de un lanzamiento aceptado. $seconds se redondea hacia arriba; $unit vale second o seconds. Se limita a una notificación cada 3 segundos por jugador y cañón. |
cannonDisabled | $prefix, $cannon | Reservado. Los cañones deshabilitados se excluyen del bucle de ticks, por lo que esta compilación nunca envía el mensaje: escribe la clave en messages.yml, pero nada la lee. |
queueCalibration | $prefix, $cannon, $queued, $target, $attempts | Se envía al entrar un jugador mientras el cañón sigue precargando. Aquí $target es chargedLocationsPerCannon y $attempts son los intentos de búsqueda restantes antes de agotarse. |
noValidLocationYet | $prefix, $cannon | Mensaje de respaldo para un cañón cuya cola está vacía en el momento del lanzamiento. Esta compilación comprueba antes la cola y envía queueCalibration o noValidLocationFound, así que normalmente este mensaje no se muestra. |
noValidLocationFound | $prefix, $cannon, $reason | Se envía cuando un jugador entra en un cañón con la cola vacía después de que este haya dejado de buscar (agotó searchTimeoutAttempts o una integración de protección no pudo cargarse). $reason enumera las categorías de rechazo detectadas en ese periodo, sin recuentos ni orden por frecuencia. |
invalidConfiguration | $prefix, $cannon, $reason | Se envía al detectar un error de configuración, como un mundo de destino descargado |
statusLine | $prefix, $cannon, $status, $queued, $target, $reason | Formato de cada fila de /wc list y /wc status. Aquí $target es preloadedLocationsPerCannon, el objetivo de reserva completa, no el umbral para mostrar Listo. |
probeAllowed | $prefix | Lo envía /wc probe si las integraciones de protección permiten la ubicación; no comprueba terreno ni listeners de la API |
probeBlocked | $prefix, $plugin, $reason | Lo envía /wc probe si se bloquea la ubicación |
unknownCommand | $prefix | Reservado. El gestor compartido de comandos de MagmaCore trata los subcomandos desconocidos, por lo que esta compilación nunca envía el mensaje: escribe la clave en messages.yml, pero nada la lee. |
invalidConfiguration también sirve como mensaje general de error administrativo: /wc list y /wc status lo envían cuando no hay cañones colocados, y /wc create, /wc place, /wc remove, /wc delete, /wc target y /wc center lo usan si no se puede resolver un ID o un mundo, si se indica a /wc create un ID que ya existe o si no se puede guardar o eliminar un archivo de cañón.
Etiquetas de estado
Las palabras de estado de la etiqueta flotante del cañón, /wc list y el marcador $status se pueden configurar.
| Clave | Predeterminado | Cuándo se muestra |
|---|---|---|
statusLabels.ready | Ready | La cola alcanza chargedLocationsPerCannon; un lanzamiento puede usar un destino incluso por debajo de este umbral visual |
statusLabels.charging | Charging | El cañón sigue buscando su primer destino seguro |
statusLabels.maintaining | Maintaining | El cañón repone su reserva de destinos |
statusLabels.exhausted | Exhausted | Se ha alcanzado el límite de fallos de búsqueda antes de llegar al umbral de carga; los destinos que haya en cola siguen siendo utilizables |
statusLabels.disabled | Disabled | El cañón está deshabilitado en su configuración. Solo aparece en /wc list y /wc status, porque los cañones deshabilitados no crean etiqueta flotante. |
statusLabels.invalid | Invalid | Reservado; no se muestra. Un mundo de destino no disponible reinicia la búsqueda en SEARCHING y elimina sus destinos de la cola. Una cola vacía muestra Charging; $reason indica el mundo no disponible. |
Son cadenas de texto, así que también admiten degradados y códigos de color. El valor configurado pasa a ser $status en statusLine.
Conjuntos de títulos
Varios títulos de la secuencia se configuran como una lista, en lugar de una sola cadena. En cada lanzamiento, CannonRTP elige una entrada aleatoria para variar la presentación.
| Clave | Marcadores | Fase | Descripción |
|---|---|---|---|
titles.launchQueuedTitles | $cannon | Inicio de SEARCHING | Títulos que se muestran al comenzar un lanzamiento |
titles.launchQueuedSubtitles | $cannon | Inicio de SEARCHING | Subtítulos que acompañan al título inicial |
titles.destinationPreviewTitles | -- | SEARCHING | Títulos que aparecen mientras parpadean las coordenadas aleatorias. Se elige uno al empezar la fase y se mantiene durante toda ella. |
titles.destinationPreviewSubtitle | $x, $y, $z | SEARCHING, cada tick | Subtítulo único que muestra las coordenadas aleatorias parpadeantes |
titles.destinationConfirmedTitles | $x, $y, $z, $world | Inicio de FIRING | Títulos que aparecen al fijar el destino real |
titles.destinationConfirmedSubtitle | $x, $y, $z, $world | Inicio de FIRING | Subtítulo único con el destino real |
titles.arrivalTitles | $x, $y, $z, $world | TELEPORTING | Títulos que aparecen justo después del teletransporte de descenso |
titles.arrivalSubtitles | $x, $y, $z, $world | TELEPORTING | Subtítulos que acompañan al título de llegada |
El título y su subtítulo usan el mismo conjunto de sustituciones, por lo que un marcador indicado para uno también funciona en el otro. La excepción es destinationPreviewTitles: la entrada elegida se formatea una sola vez al comenzar la fase, así que $x, $y y $z no se resuelven en ella. $prefix se resuelve en todos ellos, aunque pocas veces resulta adecuado dentro de un título.
Si un conjunto se define como una lista vacía, CannonRTP usa en su lugar la primera entrada de su valor predeterminado integrado.
Cadena única o conjunto
destinationPreviewSubtitleydestinationConfirmedSubtitleson cadenas únicas porque contienen coordenadas dinámicas que siempre deben mostrarse. Los demás títulos y subtítulos son conjuntos de los que se elige una entrada aleatoria por lanzamiento.
Conjuntos predeterminados
Valores incluidos en messages.yml:
launchQueuedTitles: Launching, Ignition, Liftoff, con degradado de naranja a dorado.
launchQueuedSubtitles: $cannon, en dorado cálido.
destinationPreviewTitles: Calibrating, Scanning, Targeting, de naranja a dorado.
destinationConfirmedTitles: Locked, Set, Engaged, en verde.
arrivalTitles: Arrived, Touchdown, Airborne, en blanco frío.
arrivalSubtitles: Good luck., Stick the landing., Eyes up. Ground soon., Wind check complete. Good luck., Drop zone acquired. Good luck.
Referencia de marcadores
| Marcador | Valor |
|---|---|
$prefix | Valor de messages.yml -> prefix |
$cannon | displayName del cañón. En deletedCannon y en la mayoría de los errores de comandos de administración enviados mediante invalidConfiguration, es en cambio el ID que has escrito. |
$id | ID de configuración del cañón, normalizado en minúsculas |
$path | Ruta absoluta del archivo de cañón recién creado, solo en createdCannon |
$world | Nombre del mundo de destino |
$count | Número de colocaciones de cañones cargadas tras la reconstrucción: una por cada entrada de cannonLocations en todos los archivos de cañones, incluidos los cañones deshabilitados |
$queued | Tamaño actual de la cola del cañón |
$target | Depende del contexto: chargedLocationsPerCannon en queueCalibration y preloadedLocationsPerCannon en statusLine. Ambas claves están en landing.yml. |
$attempts | Intentos de búsqueda restantes antes de agotarse |
$seconds | Tiempo restante de reutilización del lanzamiento, redondeado hacia arriba |
$unit | second o seconds, según $seconds |
$status | Valor correspondiente de statusLabels.*: por defecto Ready, Charging, Maintaining, Exhausted o Disabled |
$reason | Descripción legible del estado o fallo |
$plugin | Nombre del plugin de protección que bloqueó la ubicación |
$x, $y, $z | Coordenadas con un decimal |
Nota sobre traducciones
Todas las claves anteriores pasan por el procesador de colores y degradados de MagmaCore antes de mostrarse al jugador. Los paquetes de traducción que usen language en config.yml se conectarán mediante el mismo hook translatable(), que en la versión 1 devuelve el texto sin modificarlo.