Referencia

Configuración

Los tres archivos generados: los números del RTP, las barras de la cola, los visuales de las plataformas, la lista blanca, los mensajes y el marcador.

En la primera ejecución se generan tres archivos en plugins/ExyliaSandBox/. Ninguno existe dentro del jar: se escriben desde el propio esquema del plugin, comentarios incluidos, que es por lo que una clave desconocida se avisa una vez y se elimina.

Archivo	Qué lleva
`config.yml`	Los números del RTP y la cola, las dos barras de acción, el tiempo del TPA, los visuales de las plataformas y la lista blanca
`messages.yml`	Cada línea que manda el plugin, en doce secciones
`scoreboards.yml`	El único marcador

Todo lo demás — mundos, kits, plantillas, categorías de la sala de kits, plataformas, el lobby y la sala del creador — vive en la base de datos y se edita desde /sandbox.

`config.yml`

`rtp`

Clave	Por defecto	Qué hace
`queue-pair-distance`	`10`	Bloques entre los dos jugadores que empareja la cola
`search-attempts`	`50`	Sitios aleatorios probados antes de rendirse
`border-margin`	`20`	Bloques que se dejan libres desde el borde, restados al radio
`rotative-queue-actionbar-time`	`2.0`	Segundos que se anuncia a cada jugador en espera

in-queue-actionbar y rotative-queue-actionbar son bloques de efecto. Su text admite %world%, %time% y, en la rotativa, %player%. Un duration de 0 significa que la barra se queda hasta que la pasada de la cola la reemplace o la pare.

plugins/ExyliaSandBox/config.yml

rtp:
  queue-pair-distance: 10
  search-attempts: 50
  border-margin: 20
  in-queue-actionbar:
    action-bar:
      text: "{primary}Waiting in queue {muted}- %world% {muted}- {info}⌚ %time%"
      duration: 0
      time-style: full
  rotative-queue-actionbar-time: 2.0
  rotative-queue-actionbar:
    action-bar:
      text: "{highlight}%player% {letters}is in queue in %world% {muted}- {highlight}/rtpqueue"
      duration: 0
      time-style: full

`tpa`

Clave	Por defecto	Qué hace
`request-timeout-seconds`	`60`	Cuánto vive una petición de `/tpa`

`tp-region`

Tres bloques de efecto y un holograma, todos explicados en la página de Plataformas de teletransporte.

bossbar — la barra que ve cada ocupante. colour admite PINK, BLUE, RED, GREEN, YELLOW, PURPLE o WHITE; overlay admite PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12 o NOTCHED_20.
countdown-title — el título y el subtítulo, reenviados cada segundo.
hologram — líneas, escala, orientación, alineación, distancia de visión, desplazamientos y un config.update-interval que va en ticks.

`command-whitelist`

enabled y una lista de nombres de comando. Mira Comandos.

`kit-creator`

Tres bloques de título — name-input-title, rename-input-title e icon-input-title.

Estos tres no hacen nada

Las peticiones por chat que muestra el creador de kits están escritas dentro del plugin. Los tres bloques se escriben en config.yml y no se leen nunca.

`messages.yml`

Un prefix y doce secciones. Cada línea admite %prefix%, y la mayoría admiten uno o dos de %world%, %player%, %region%, %name%, %slot%, %max% y %percent%.

Sección	Cubre
`world`	Creado, guardado, borrado, importado, no encontrado
`queue`	Entrar, salir, emparejar, teletransportar, sin kit, sin sitio seguro, el anuncio de entrada
`tpa`	Enviada, recibida, aceptada, rechazada, caducada y los seis rechazos
`back`	Sin posición, teletransportando
`lobby`	Lobby puesto, sala del creador puesta, sin poner
`kitroom`	Sin espacio, y las líneas de crear, borrar y cambiar icono de una categoría
`kit-creator`	Entrar, guardar, renombrar, borrar, el icono y el límite de ranuras
`predefined-kit`	Guardar, renombrar, borrar, copiar, los dos rechazos y la ranura inválida
`rekit`	Aplicado, sin kit, fuera de un mundo
`tp-region`	Sin kit favorito, teletransportado, la varita, y las líneas de crear, guardar y borrar
`general`	No disponible, comando bloqueado
`screens`	La etiqueta `PREGEN %percent%` de la lista de mundos

Una línea puede empezar por una etiqueta de efecto como [sound:ENTITY_VILLAGER_NO|1.0|1.0], varias separadas por ;. La etiqueta es una instrucción y no llega nunca a la pantalla. Los colores son tokens de paleta — {primary}, {success}, {error}, {warning}, {info}, {highlight}, {muted}, {letters}, {accent}, {secondary} — resueltos desde el colors.yml compartido de ExyliaLib.

Dos etiquetas no están en el archivo y no se pueden cambiar: los cuatro estados de mundo de las pantallas de administración, y el par Activo / Inactivo del botón de favorito en Kit options.

back.outside-world y queue.select-kit se generan en el archivo pero no se mandan nunca.

`scoreboards.yml`

Un marcador, sandbox, para quien esté en un mundo sandbox. title es una lista: varias entradas se animan una por refresco, una sola se queda quieta. Se dibujan como mucho quince líneas.

plugins/ExyliaSandBox/scoreboards.yml

scoreboards:
  sandbox:
    enabled: true
    title: ["{primary}&lSANDBOX"]
    lines:
      - ""
      - " {muted}❙ {letters}World: {highlight}%world%"
      - " {muted}❙ {letters}Players: {success}%players%"
      - ""
      - " {muted}❙ {letters}Kills: {success}%kills%"
      - " {muted}❙ {letters}Deaths: {error}%deaths%"
      - " {muted}❙ {letters}KDR: {highlight}%kdr%"
      - " {muted}❙ {letters}Playtime: {info}%sandbox_playtime%"
      - ""
      - " {muted}❙ {letters}Border: {info}%border%"
      - ""
      - " {highlight}exylia.net"
    update:
      interval: 10
      smart: true
      cache: true

update.interval va en ticks, no en segundos. smart manda solo las líneas que cambiaron. Los nombres disponibles dentro de esas líneas están en la página de Placeholders.

Recargar

/sandbox reload, y RECARGAR CONFIGS en el panel, vuelven a leer los tres archivos y recompilan los menús. La base de datos no se toca.

¿Falta algo en esta página? Dínoslo en Discord