Referencia

Configuración

Cada bloque de config.yml, con sus valores por defecto.

config.yml se escribe desde un esquema: los comentarios se regeneran en cada arranque, las claves desconocidas se descartan y una clave que borres vuelve con su valor por defecto.

`behaviour`

behaviour:
  mode: both
  consume-token: true
  consume-remover: true
  require-permission: true
  hide-without-permission: false

Clave	Por defecto	Qué hace
`mode`	`both`	`player`, `bow` o `both`. Ver Modos y fichas.
`consume-token`	`true`	Si la ficha se gasta al atarla.
`consume-remover`	`true`	Si el removedor se gasta al quitar un efecto.
`require-permission`	`true`	Si lanzar un efecto necesita su nodo. Los comandos y la API nunca se limitan por esto.
`hide-without-permission`	`false`	Si los efectos bloqueados se esconden en el menú en vez de mostrarse bloqueados.

`projectiles`

Qué proyectiles lanzados llevan efecto.

projectiles:
  all-types: true
  default-allowed-types:
    - ARROW
    - SPECTRAL_ARROW
    - TRIDENT
    - EGG
    - SNOWBALL
    - WIND_CHARGE
    - ENDER_PEARL

Clave	Por defecto	Qué hace
`all-types`	`true`	Cualquier proyectil lanzado lleva el efecto.
`default-allowed-types`	siete tipos	Solo se lee con `all-types` en `false` y cuando el efecto no declara `projectiles` propios.

`trail`

trail:
  default-interval: 1
  max-duration: 10
  max-active: 200

Clave	Por defecto	Qué hace
`default-interval`	`1`	Ticks entre pasos de estela para un efecto sin `trail-interval` propio.
`max-duration`	`10`	Segundos que puede vivir una estela antes de cancelarse — una flecha perdida en un chunk descargado dibujaría para siempre.
`max-active`	`200`	Cuántas estelas pueden dibujarse a la vez en todo el servidor. Los disparos que pasen del límite siguen lanzando su launch y su impacto; simplemente no dejan estela. `0` quita el límite.

max-active existe por las ráfagas de ballesta

Una estela es una tarea repetida y una ráfaga de paquetes por tick. Un lobby lleno disparando ballestas es el caso para el que está el techo, y perder una estela se nota mucho menos que perder el tick rate.

`token-item`, `remover-item` y `key-item`

token-item:
  material: FIREWORK_STAR
  name: "{primary}&lARROW EFFECT &8» %effect%"
  lore:
    - "{secondary}Information:"
    - " {letters_black}▎ {letters}Drop this onto a bow to"
    - " {letters_black}▎ {letters}{highlight}bind the effect {letters}to it. The bow"
    - " {letters_black}▎ {letters}keeps everything it had."
    - ""
    - "{secondary}Fits:"
    - " {letters_black}▎ {info}%bows%"
    - ""
    - "{warning}➥ Drop onto a bow to bind"
    - ""
  glow: true
 
remover-item:
  material: SCRAPE_POTTERY_SHERD
  name: "{primary}&lEFFECT REMOVER"
  glow: true
 
key-item:
  material: TRIPWIRE_HOOK
  name: "{primary}&lCRATE KEY"
  glow: true

%effect% es el nombre del efecto y %bows% a qué encaja. material solo se usa cuando el efecto no trae icono propio — normalmente la ficha se dibuja con el material del efecto.

key-item es la llave que se lleva en la mano: click derecho a un bloque de caja y se abre. Ver La caja.

`bow-lore`

bow-lore:
  enabled: true
  lines:
    - "{secondary}Arrow Effect:"
    - " {letters_black}▎ {highlight}%effect%"

Se dibuja bajo el lore propio del arco atada, solo en paquetes. El objeto nunca lleva estas líneas.

`tiers`

Las rarezas en las que se ordenan los efectos, y cada cuánto sale cada una de una caja. Añade, renombra o borra las que quieras — la clave es el id que effects.yml escribe como tier.

tiers:
  common:
    name: "Common"
    material: GRAY_DYE
    color: "{muted}"
    chance: 60.0
    priority: 1
  rare:
    name: "Rare"
    material: LIGHT_BLUE_DYE
    color: "{info}"
    chance: 25.0
    priority: 2
  epic:
    name: "Epic"
    material: PINK_DYE
    color: "{accent}"
    chance: 12.0
    priority: 3
  legendary:
    name: "Legendary"
    material: ORANGE_DYE
    color: "{highlight}"
    chance: 3.0
    priority: 4

Clave	Por defecto	Qué hace
`name`	por rareza	Cómo la llaman los menús y los placeholders.
`material`	por rareza	El objeto con el que se dibuja en la caja.
`color`	por rareza	El color en el que se escriben su nombre y sus efectos.
`chance`	`60`, `25`, `12`, `3`	Un peso, no un porcentaje: las probabilidades salen de los pesos, así que borrar una rareza reparte sus tiradas.
`priority`	`1`-`4`	Dónde va en los menús; lo más bajo va primero.

Cada rareza es además un nodo de permiso, exyliarrows.tier.<id>. Ver Rarezas y el caja.

`crate`

crate:
  enabled: true
  start-keys: 0
  duplicate-refund: 1
  reward: UNLOCK
  blocks: []
  max-at-once: 4
  spin-frames: 34
  stagger-seconds: 2.0
  on-spin:
    sound:
      name: BLOCK_NOTE_BLOCK_HAT
      pitch: 1.6
  on-win:
    sound:
      name: ENTITY_PLAYER_LEVELUP
      pitch: 1.2
  on-duplicate:
    sound:
      name: BLOCK_NOTE_BLOCK_BASS
      pitch: 0.8

Clave	Por defecto	Qué hace
`enabled`	`true`	Si la caja se puede abrir. Apagado, su botón lo dice en vez de abrir.
`start-keys`	`0`	Llaves que se le dan a un jugador la primera vez que se le ve, al crear su fila.
`duplicate-refund`	`1`	Llaves que se devuelven cuando una caja cae en un efecto que ya tenía.
`reward`	`UNLOCK`	Qué entrega la caja. `UNLOCK` deja el efecto en la cuenta, `ITEM` entrega solo su ficha, `BOTH` hace las dos. `ITEM` y `BOTH` quieren `behaviour.mode` en `bow` o `both`.
`blocks`	vacío	Los bloques que abren la caja al hacerles clic. Átalos con `/arrowsadmin crate block add`, no a mano.
`max-at-once`	`4`	Cuántas cajas se pueden abrir de una vez. La pantalla de apertura cabe siete.
`spin-frames`	`34`	Cuántas caras recorre el primer carrete antes de parar. Tope de 200, unos once segundos.
`stagger-seconds`	`2.0`	Cuánto tarda un carrete en parar después del anterior. `0` los para juntos.
`on-spin` / `on-win` / `on-duplicate`	sonidos	Bloques de efecto completos de ExyliaLib: título, action bar, boss bar, sonido, partícula y firework. `on-win` y `on-duplicate` suenan una vez por carrete, al parar.

`preview`

Dónde suenan /arrows preview y el clic derecho del menú. Al jugador se le lleva al escenario, el efecto suena delante de él donde solo él lo ve, y vuelve exactamente a donde estaba.

preview:
  location: ""
  distance: 5.0
  settle-ticks: 4
  linger-ticks: 20
  max-ticks: 600

Clave	Por defecto	Qué hace
`location`	vacío	Dónde se pone el jugador, como `server,world,x,y,z,yaw,pitch`. Se fija en el juego con `/arrowsadmin preview location`.
`distance`	`5.0`	A qué distancia delante de él suena el efecto, en bloques.
`settle-ticks`	`4`	Cuánto esperar tras moverlo, para que el cliente tenga la posición nueva antes de la primera partícula.
`linger-ticks`	`20`	Cuánto se mantiene el escenario después de terminar el efecto.
`max-ticks`	`600`	Lo máximo que puede durar una vista previa, pase lo que pase.

No hay vistas previas hasta fijar el escenario

No hay valor por defecto sensato — adivinarlo mete al jugador dentro del terreno. Hasta rellenar location, /arrows preview y el clic derecho del menú lo dicen en vez de lanzar nada.

menu:
  empty: "{muted}Nothing"
  tab-open: "{success}✔ You are here"
  tab-closed: "{warning}➥ Click to open"
  bows-any: "Any bow"
  favourites-name: "Favourites"
  favourites-icon: "AMETHYST_SHARD"
  favourite-on: "{highlight}★ In your favourites"
  favourite-off: "{muted}☆ Not in your favourites"
  random-name: "{highlight}Random"
  random-on: "{success}✔ Every shot is a surprise"
  random-off: "{warning}➥ Click to surprise yourself"

random-name es cómo se llama la elección aleatoria allá donde se dibuje el efecto que lleva un jugador; random-on y random-off son la línea que muestra su botón.

Las pantallas en sí son menus/effects.yml, menus/crate.yml y menus/crate_open.yml — ver El menú y Rarezas y la caja.

`feedback`

feedback:
  on-bind:
    sound:
      name: BLOCK_ENCHANTMENT_TABLE_USE
      volume: 1.0
      pitch: 1.2
  on-unbind:
    sound:
      name: BLOCK_GRINDSTONE_USE

Son bloques de efecto completos de ExyliaLib: título, action bar, boss bar, sonido, partícula y firework están disponibles en cada uno. on-bind suena al atar un efecto a un arco o al elegirlo en el menú.

`particles`

particles:
  default-visibility: "ALL"
  name-all: "All"
  name-none: "None"
  name-self-only: "Self Only"
  name-others-only: "Others Only"

default-visibility es con lo que empieza un jugador. Los cuatro nombres son cómo llaman los menús y los placeholders a cada modo.

`placeholders`

placeholders:
  none: "None"

Lo que responde cualquier %exyliarrows_...% cuando no hay valor.

`messages`

Todas las líneas que envía el plugin. prefix es {primary}&lE-ARROWS &8•&r y el resto de mensajes empieza con %prefix%.

Clave	Cuándo se envía
`bound`	Se ató un efecto a un arco.
`unbound`	Se desató y se devolvió.
`chosen`	Se eligió un efecto en el menú.
`cleared`	Se quitó el efecto.
`not-a-bow`	El objeto no puede llevar un efecto.
`wrong-bow`	El efecto no encaja en esa arco.
`unknown-effect`	El id no nombra nada declarado.
`already-bound`	El arco ya lleva un efecto.
`no-effect`	El arco no lleva ninguno.
`inventory-full`	Un removedor necesita un hueco libre.
`no-permission`	El jugador no tiene el efecto.
`empty-hand`	Un subcomando de mano con la mano vacía.
`given` / `given-remover` / `given-key`	Se dieron fichas, removedores o llaves.
`list-header` / `list-entry` / `list-empty`	`/arrowsadmin list`.
`visibility-set`	Cambió la visibilidad.
`refreshed`	Terminó `refresh` o `validate`.
`menu-disabled`	Se abrió el menú en un servidor `bow`.
`favourite-added` / `favourite-removed` / `favourites-cleared` / `favourites-empty`	La lista de favoritos.
`random-chosen`	Se puso que cada disparo saque un efecto distinto.
`crate-won` / `crate-duplicate` / `crate-no-keys`	Una caja cayó en algo nuevo, en algo que ya tenía, o no se pudo pagar.
`crate-busy` / `crate-empty` / `crate-disabled`	Ya hay una caja cayendo, no hay nada que entregar, o está apagado.
`keys-received` / `keys-taken` / `keys-given`	Cambiaron de manos unas llaves.
`unlock-granted` / `unlock-already` / `unlock-revoked` / `unlocks-cleared`	`/arrowsadmin unlocks`.
`crate-block-added` / `crate-block-removed` / `crate-block-already` / `crate-block-missing` / `crate-block-none`	`/arrowsadmin crate block`.
`preview-location-set` / `preview-unavailable` / `preview-unavailable-admin`	El escenario de vistas previas.

Placeholders en los mensajes: %effect%, %amount%, %id%, %visibility%, %keys%, %player%, %location% y %prefix%.

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

behaviour

projectiles

trail

token-item, remover-item y key-item

bow-lore

tiers

crate

preview

menu

feedback

particles

placeholders

messages