Referencia

Configuración

config.yml clave a clave, tiers.yml y los archivos de animación, el archivo de mensajes y sus idiomas, y los archivos de menús.

Todo se genera en plugins/ExyliaCrates/ en el primer arranque, con comentarios. Edita los archivos de ahí, nunca las copias del jar, y ejecuta /cratesadmin reload. config.yml, tiers.yml y los archivos de animación también se pueden editar dentro del juego desde Ajustes en la lista de cajas (ver Cajas) o en el navegador con /exylialib editor ExyliaCrates.

Las cajas en sí no están en ningún archivo. Cajas, llaves, bloques, saldos e historial viven en la base de datos y se editan desde los menús.

Archivo	Qué guarda
`config.yml`	Lo que comparten todas las cajas del servidor. Abajo.
`tiers.yml`	Las rarezas. Ver Recompensas y rarezas.
`animations/<id>.yml`	Uno por animación. Ver Animaciones.
`database.yml`	La conexión a la base de datos de ExyliaLib.
`lang/<idioma>/messages.yml`	Cada línea que envía el plugin, y los textos con los que se rellenan sus pantallas.
`lang/<idioma>/menus/user/*.yml`	Las tres pantallas de jugador.
`lang/<idioma>/menus/admin/*.yml`	Las diez pantallas de staff.

config.yml

settings:
  wand-material: BLAZE_ROD
  default-key-material: TRIPWIRE_HOOK
  max-multi-open: 10
  history-retention-days: 30
  broadcast-enabled: true
  watch-radius: 24.0
  click-speed-up: 4.0
hologram:
  enabled: true
  offset-y: 1.6
idle:
  interval-seconds: 8
  radius: 24.0
  height: 1.3
  scale: 0.6
  glow: ''
  effects: []
keys:
  received:
    title:
      text: '{primary}&l+%amount% KEYS'
      subtitle: '{letters}%crate%'
      fade-in: 0.1
      stay: 1.6
      fade-out: 0.5
      time-style: auto
    sound:
      name: ENTITY_EXPERIENCE_ORB_PICKUP
      volume: 0.9
      pitch: 1.4
      category: MASTER
    particle:
      name: END_ROD
      count: 12
      spread: 0.4
      speed: 0.02

settings

Clave	Por defecto	Significado
`wand-material`	`BLAZE_ROD`	Material de la varita que coloca y quita bloques de caja. Uno desconocido vuelve a `BLAZE_ROD`.
`default-key-material`	`TRIPWIRE_HOOK`	De qué está hecho un ítem de llave hasta que la llave tiene un icono propio.
`max-multi-open`	`10`	Máximo de aperturas que paga un clic agachado, un shift + clic o `/crates open <crate> true`. También cuántas veces se abre así una caja gratis. El `exyliacrates.multiopen.<n>` más alto de un jugador lo sustituye para él.
`history-retention-days`	`30`	Días que una apertura se queda en el historial. `0` las conserva para siempre. Las filas viejas se borran un minuto después de arrancar y cada seis horas.
`broadcast-enabled`	`true`	Anunciar al servidor cuando alguien gana una recompensa cuya rareza se anuncia.
`watch-radius`	`24.0`	Bloques de distancia desde los que se puede ver una apertura compartida. Los jugadores dentro la ven desde donde están, y entran y salen de ella.
`click-speed-up`	`4.0`	Cuántas veces más rápido se reproduce una apertura cuando quien abre hace clic. `1` lo desactiva.

hologram

Clave	Por defecto	Significado
`enabled`	`true`	Mostrar un holograma sobre cada bloque de caja. Sus líneas son `hologram-lines` en `messages.yml`.
`offset-y`	`1.6`	Altura sobre el bloque. Cada caja puede mover su holograma desde ahí en Presencia.

Las dos se leen cuando se dibuja un bloque de caja: al arrancar y cuando se edita la caja. Un reload por sí solo no vuelve a dibujar los hologramas que ya están en pie.

idle

Lo que hace cada bloque de caja mientras nadie lo abre.

Clave	Por defecto	Significado
`interval-seconds`	`8`	Segundos por pasada del bucle en reposo: lo que tarda una vuelta del icono flotante, y cada cuánto se reproducen los `effects`. `0` desactiva el bucle, icono incluido.
`radius`	`24.0`	Bloques a los que tiene que estar un jugador para que se le dibuje el icono.
`height`	`1.3`	Altura sobre el bloque a la que gira el icono, antes del desplazamiento propio de la caja.
`scale`	`0.6`	Tamaño del icono, 1 es el tamaño de un ítem tirado.
`glow`	`''`	Contorno del icono: un token de paleta como `{primary}` o un color hexadecimal, o vacío para ninguno.
`effects`	`[]`	Líneas de efecto que se reproducen en cada caja una vez por pasada, en la notación de secuencias de ExyliaLib.

keys

Clave	Significado
`received`	El efecto que se le reproduce a un jugador cada vez que le llegan llaves: dadas, concedidas por la API, o anunciadas al entrar tras sumarse mientras estaba fuera. `%amount%` es cuántas y `%crate%` las cajas que abre la llave. Cualquiera de `title`, `action-bar`, `boss-bar`, `sound` y `particle`; quita una parte para saltarla. Ver Efectos.

Mensajes e idiomas

lang/<idioma>/messages.yml guarda cada línea que envía el plugin. El plugin trae en, es, fr, pt, ru y tr, y sigue el idioma configurado en el config.yml de ExyliaLib; el config.yml de aquí no tiene una clave language propia. Una clave que falte en un archivo traducido usa el inglés.

Una línea puede empezar con [sound:NOMBRE|volumen|tono], que reproduce un sonido y nunca llega a la pantalla. %prefix% se sustituye por la línea prefix. Los colores usan tokens de paleta, así que cambiar los colores del servidor nunca obliga a editar este archivo.

Además de las líneas de chat, el archivo guarda:

Clave	Qué es
`hologram-lines`	El holograma sobre cada caja, de arriba abajo.
`default-key-name`	El nombre que recibe una llave nueva.
`key-lore`	El lore de cada ítem de llave.
`wand-name`, `wand-lore`	La varita de cajas.
`reveal-self`, `reveal-other`, `reveal-count`	La etiqueta sobre un premio revelado: para quien gana, para los demás, y el contador bajo un premio de apertura múltiple.
`pick-title`, `pick-subtitle`	El título de Elige una carta mientras el jugador elige.
`speed-up-hint`	Encima de la barra rápida cuando empieza una apertura animada. Vacío para ninguno.
`announcements-name`, `announcements-description`	El canal Premios de cajas en la pantalla de Anuncios de `/settings`.
`prompts`	Lo que preguntan los editores de cajas y llaves, y las etiquetas de sus formularios.
`screens`	Textos con los que se rellenan las pantallas: el nombre y la descripción de cada animación por id, los estados del selector, el aviso de vista previa, la rareza de una recompensa sin rareza, Bloqueada, la línea de rareza del editor de recompensas, los dos públicos y las palabras de la pantalla de costes.
`pity-none`, `pity-next`, `pity-left`, `pity-every`	Cómo se escribe la garantía en las pantallas.

Los placeholders que admite cada línea están en Placeholders.

Menús

Carpeta	Qué hay	Actualizaciones
`lang/<idioma>/menus/user/`	`crates.yml` (la lista de cajas de `/crates`), `preview.yml` (el contenido de una caja) y `history.yml` (el historial, de los dos tipos).	Puedes editarlos. Una actualización solo añade los archivos que faltan; cuando una versión tiene que cambiar un diseño sube el `menu-version` del archivo, lo sustituye y guarda el tuyo al lado como `<nombre>.yml.v<versión anterior>`.
`lang/<idioma>/menus/admin/`	`crate_list`, `crate_setup` y sus secciones `crate_setup_general`, `_cost`, `_rewards`, `_opening`, `_presence`, `crate_setup_animations`, `key_list`, `key_setup`. La lista de cajas lleva el botón Ajustes (`exyliacrates:settings`).	Se reescriben desde el jar en cada arranque; las ediciones ahí se pierden.

Cada archivo lista en el comentario de arriba los valores con los que se rellena. Cada botón ejecuta una acción del espacio de nombres exyliacrates: exyliacrates:crate_open <crate> [all], exyliacrates:crate_preview <crate>, exyliacrates:crate_history [crate], y las de staff que usan los archivos de admin. Un archivo de menú que no se puede leer se avisa en consola y no se registra, en lugar de registrarse vacío.

Un reload recompila los menús. También se recompilan con /exylialib reload, para que un cambio de paleta les llegue.

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