Contenido generado con IA — puede contener errores.

ExyliaArrows/ReferenciaActualizada en v1.8.0

Configuración

Dónde guarda ExyliaArrows sus archivos, lo que más cambian los dueños (idioma, mundos, estelas, caja, tienda) y cada clave de config.yml con su valor por defecto.

Página 14 de 2217 min de lectura
  - lobby       - ARROW    - SPECTRAL_ARROW    - TRIDENT              

Casi todo ExyliaArrows se ajusta en plugins/ExyliaArrows/config.yml. Cómo se ven los efectos está en effects.yml (Secuencias), y cada palabra que lee un jugador está en lang/<código>/. Tras un cambio, ejecuta /arrowsadmin reload; relee solo los archivos de este plugin, no los de ExyliaLib.

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.

plugins/ExyliaArrows/
  config.yml                    comportamiento y límites (esta página)
  effects.yml                   los efectos
  lang/<código>/messages.yml    cada mensaje, nombre de objeto y palabra del menú
  lang/<código>/effects.yml     nombres y descripciones de efectos traducidos
  lang/<código>/menus/          effects.yml, crate.yml, crate_open.yml
  spatial/                      el selector 3D y la apertura 3D de la caja

language#

De qué carpeta bajo lang/ se leen los menús y los mensajes. Con default, el valor por defecto, sigue el language del config.yml de ExyliaLib, así que una línea allí cambia todos los plugins de Exylia. Pon en, es, pt, fr, ru o tr para cambiar solo este plugin. El inglés es la base sobre la que se ponen los demás, así que una línea aún sin traducir llega en inglés. Un language cambiado se aplica con /arrowsadmin reload. Para editar un idioma, mira Mensajes e idiomas.

Los servidores que usaban 1.3.0 conservan sus cambios

En el primer arranque de 1.4.0 o posterior los menus/ antiguos pasan a lang/custom/, cada mensaje, nombre y lore de objeto, palabra del menú y respuesta de placeholder que antes guardaba config.yml pasa a lang/custom/messages.yml, y config.yml apunta a ella con language: custom, así que no se pierde nada de lo que el servidor editó. Pon language en default o en un código para pasar a las traducciones incluidas.

disabled-worlds#

Mundos donde los efectos de flecha nunca se reproducen: ni lanzamiento, ni estela, ni impacto. Los nombres se comparan sin distinguir mayúsculas. Por defecto es una lista vacía.

yaml
disabled-worlds:
  - lobby

Para apagar los efectos en una zona en vez de en un mundo entero, deniega la flag de WorldGuard arrows-effects en una región.

behaviour#

De dónde sale el efecto de un disparo y qué hacen las fichas.

yaml
behaviour:
  mode: both
  consume-token: true
  consume-remover: true
  hide-without-permission: false
  defaults: []

mode es player (lo que el jugador eligió en /arrows), bow (lo atado al arco) o both (el efecto del propio arco, y la elección del jugador para un arco sin ninguno). Mira Ata efectos a arcos.

Efectos por defecto según el rango#

defaults es el efecto que lanza un jugador mientras no haya elegido uno, según su rango:

yaml
behaviour:
  defaults:
    - permission: group.vip
      cosmetic: random
    - permission: ''
      cosmetic: ember_trail

Se lee de arriba abajo: gana la primera línea para la que el jugador cumple, y un permission vacío significa todos, así que deja esa línea la última. cosmetic es el id de un efecto, random (un efecto aleatorio de los que tiene) o none (ese grupo no recibe nada). No se desbloquea ni se guarda nada: el menú lo dibuja como el efecto en marcha, marcado como el predeterminado de su rango, y se comprueba en cada disparo. Un jugador que elige otra cosa lanza eso; quien quita el efecto en el menú o con /arrows clear no lanza nada. Se ignora con mode en bow.

Elegir un efecto en el menú siempre pide su nodo o un desbloqueo; una ficha, un arco atado, un comando y la API nunca. Mira Permisos.

Todas las claves de behaviour
ClavePor defectoQué hace
modebothplayer, bow o both.
consume-tokentrueSi la ficha se gasta al atarla.
consume-removertrueSi el removedor se gasta al desatar.
hide-without-permissionfalseSi los efectos bloqueados se ocultan en el menú en vez de mostrarse bloqueados.
defaults[]El efecto que lanza un jugador mientras no haya elegido uno, según el rango.

projectiles#

Qué proyectiles lanzados llevan un efecto. Por defecto solo flechas, flechas espectrales y tridentes, salvo que el efecto nombre sus propios projectiles.

yaml
projectiles:
  all-types: false
  default-allowed-types:
    - ARROW
    - SPECTRAL_ARROW
    - TRIDENT

all-types: true hace que cualquier proyectil lanzado lleve el efecto, incluidas las bolas de nieve, huevos, pociones y cañas de pescar que un jugador puede lanzar cada tick. default-allowed-types solo se lee con all-types en false y cuando el efecto no nombra projectiles propios. Son los valores que escribe una instalación nueva; un servidor que ya tenía el archivo conserva el suyo.

Sea cual sea el permitido, el destello de lanzamiento de un jugador suena como mucho una vez cada 150 ms: una ballesta multidisparo dispara tres en el mismo tick, y un destello para la ráfaga es todo lo que se puede ver.

trail#

Cuántas estelas pueden dibujarse a la vez y durante cuánto tiempo.

yaml
trail:
  default-interval: 1
  max-duration: 10
  max-active: 200
  max-active-per-player: 10

Los disparos que pasan de max-active siguen reproduciendo su lanzamiento e impacto; simplemente no dejan estela. Pon un límite en 0 para quitarlo.

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 existe el techo, y perder una estela se nota mucho menos que perder ticks por segundo.

Todas las claves de trail
ClavePor defectoQué hace
default-interval1Ticks entre pasos de la estela para un efecto sin trail-interval.
max-duration10Segundos que puede vivir una estela antes de cancelarse, para que una flecha perdida en un chunk descargado no dibuje para siempre.
max-active200Cuántas estelas pueden dibujarse a la vez en todo el servidor. 0 quita el límite.
max-active-per-player10Cuántas de ellas puede tener dibujándose un mismo jugador. 0 lo quita.

token-item, remover-item y key-item#

yaml
token-item:
  material: FIREWORK_STAR
  glow: true
 
remover-item:
  material: SCRAPE_POTTERY_SHERD
  glow: true
 
key-item:
  material: TRIPWIRE_HOOK
  glow: true

material solo se usa cuando el efecto no fija un icono propio; una ficha normalmente se dibuja con el material del propio efecto. Cómo se llama cada objeto y qué dice su lore está en messages.yml. key-item es la llave que lleva el jugador: clic derecho en un bloque de caja con una y se abre. Mira Configura la caja y la tienda.

bow-lore#

yaml
bow-lore:
  enabled: true

Si se dibujan las líneas bajo un arco atado. Se dibujan solo en paquetes, así que el objeto nunca las lleva. Las líneas son bow-lore en messages.yml.

tiers#

Las rarezas en que se ordenan los efectos y con qué frecuencia 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, y cada rareza es también un nodo de permiso, exyliarrows.tier.<id>. Un efecto que nombra una rareza que ya no existe pasa a la primera.

yaml
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

chance es un peso, no un porcentaje: los porcentajes se calculan a partir de los pesos, así que borrar una rareza reparte sus probabilidades entre las demás. Mira Configura la caja y la tienda.

Todas las claves de cada rareza
ClavePor defectoQué hace
namesegún la rarezaCómo la llaman los menús y los placeholders.
materialsegún la rarezaSe sigue leyendo del archivo, pero la caja vive en ExyliaLib desde 1.4.0 y no lo recibe.
colorsegún la rarezaEl color de su nombre y de sus efectos. Mira Colores.
chance60, 25, 12, 3Un peso.
priority1 a 4Su posición en los menús; el menor va primero.

crate#

La caja: una llave virtual, un efecto aleatorio. Las llaves se guardan en la cuenta del propio jugador, así que no se pueden tirar ni perder por un inventario lleno.

yaml
crate:
  enabled: true
  start-keys: 0
  duplicate-refund: 1
  reward: UNLOCK
  blocks: []
  max-at-once: 4
  opening: INVENTORY

reward es lo que entrega una caja: UNLOCK deja el efecto en la cuenta, ITEM entrega solo su ficha, BOTH hace las dos cosas. ITEM y BOTH piden behaviour.mode en bow o both. Vincula los bloques de caja con /arrowsadmin crate block add en vez de a mano. opening es INVENTORY (los carretes caen por un menú) o SPATIAL (una caja en el mundo delante del jugador); mira La apertura en 3D.

Todas las claves de crate
ClavePor defectoQué hace
enabledtrueSi la caja se puede abrir. Apagada, su botón lo dice en vez de abrir.
start-keys0Llaves que recibe un jugador la primera vez que se le ve.
duplicate-refund1Llaves que se devuelven cuando una caja cae en un efecto que ya tiene.
rewardUNLOCKUNLOCK, ITEM o BOTH.
blocksvacíoLos bloques que abren la caja al hacer clic, como server,world,x,y,z,yaw,pitch. Un bloque vinculado no se puede romper, explotar ni empujar mientras esté en la lista.
max-at-once4Cuántas cajas se pueden abrir de una vez. La pantalla de apertura admite siete. Un jugador con exyliarrows.crate.multi.<n> puede abrir <n>, el más alto que tenga.
spin-frames34Cuántas caras recorre el primer carrete antes de parar. Máximo 200, unos once segundos.
stagger-seconds2.0Cuánto después de parar un carrete para el siguiente. 0 los para a la vez.
on-spin, on-win, on-duplicateun sonido cada unoBloques de efecto completos de ExyliaLib (título, action bar, boss bar, sonido, partícula, cohete). on-spin suena cada tick que cae un carrete; on-win y on-duplicate suenan una vez por carrete, al caer.
openingINVENTORYINVENTORY o SPATIAL. Agacharse salta al final y entrega el premio al instante.

Sonidos por defecto: on-spin es BLOCK_NOTE_BLOCK_HAT (volumen 0.6, tono 1.6), on-win es ENTITY_PLAYER_LEVELUP (0.7, 1.2), on-duplicate es BLOCK_NOTE_BLOCK_BASS (0.7, 0.8).

preview#

Dónde reproducen un efecto /arrows preview y el clic derecho del menú. El jugador se mueve al escenario, el efecto se reproduce delante de él donde solo él lo ve, y vuelve exactamente a donde estaba.

yaml
preview:
  location: ""
Las vistas previas no funcionan hasta fijar un escenario

No hay un valor razonable por defecto, porque uno adivinado deja al jugador dentro del terreno. Colócate donde deban reproducirse las vistas previas y ejecuta /arrowsadmin preview location. Hasta entonces, /arrows preview y el clic derecho del menú lo dicen en vez de reproducir nada.

Todas las claves de preview
ClavePor defectoQué hace
locationvacíoDónde se coloca el jugador, como server,world,x,y,z,yaw,pitch.
distance5.0A cuántos bloques delante de él se reproduce el efecto.
settle-ticks4Cuánto esperar tras el movimiento, para que el cliente tenga la nueva posición antes de la primera partícula.
linger-ticks20Cuánto se mantiene el escenario cuando el efecto termina.
max-ticks600Lo máximo que puede durar una vista previa, pase lo que pase.

Las claves de ticks también aceptan una duración escrita como 1s o 500ms. La sección también tiene mode (por defecto TELEPORT) y un bloque mannequin, que ExyliaLib comparte entre los plugins cosméticos; ExyliaArrows no tiene comando para colocar maniquíes, así que déjalos como están.

yaml
menu:
  favourites-icon: "AMETHYST_SHARD"
  style: CLASSIC

style es lo que abre /arrows: CLASSIC es el menú de inventario, SPATIAL es el selector 3D, con la disposición de spatial/effects.yml. /arrows 3d siempre abre el 3D. favourites-icon es el material con que se dibuja la pestaña de favoritos. Cómo llama el menú a las cosas está en messages.yml, y las pantallas son menus/effects.yml, menus/crate.yml y menus/crate_open.yml bajo lang/<código>/. Mira El menú y Editar menús.

feedback#

yaml
feedback:
  on-bind:
    sound:
      name: ENTITY_EXPERIENCE_ORB_PICKUP
      volume: 0.7
      pitch: 1.2
  on-unbind:
    sound:
      name: ITEM_BUNDLE_REMOVE_ONE
      volume: 0.7
      pitch: 1.0

Bloques de efecto completos de ExyliaLib: en cada uno puedes usar título, action bar, boss bar, sonido, partícula y cohete. on-bind suena cuando un efecto se ata a un arco o se elige en el menú, on-unbind cuando se quita.

Desde 1.7.0 los sonidos rutinarios son más cortos y suaves. Un servidor que aún tiene los valores antiguos pasa a los nuevos al actualizar; un sonido que elegiste tú se deja como está.

particles#

yaml
particles:
  default-visibility: "ALL"

La visibilidad con la que empieza un jugador: ALL, NONE, SELF_ONLY u OTHERS_ONLY. Cómo llaman los menús y los placeholders a cada modo está en messages.yml.

showcase#

Lugares que reproducen efectos de flecha solos, una y otra vez, para quien pase: un centro de mesa de lobby más que un disparo. Dos cuerpos con las skins de jugadores cercanos se miran a nueve bloques de distancia, uno tensa un arco y el otro recibe la flecha, dos veces por turno. El lanzamiento suena en el arco, la estela a lo largo del arco de vuelo y el impacto donde cae.

yaml
showcase:
  locations: []

Fija las ubicaciones en el juego con /arrowsadmin showcase add, mirando hacia donde estará el público: la pareja se coloca a tu izquierda y derecha para que el arco se vea de lado. Solo se eligen efectos que viajan en una flecha y dibujan estela o impacto. No hay flecha real ni nadie recibe daño: el vuelo se simula y se dibuja en paquetes, y las líneas que actúan sobre un jugador real ([COMMAND], [POTION], [TITLE], [ACTION_BAR], [MESSAGE], [CAMERA]) se quitan de lo que reproduce una vitrina. Con nadie dentro de radius no se reproduce nada, así que un lobby vacío no cuesta nada.

Todas las claves de showcase
ClavePor defectoQué hace
locations[]Dónde están las vitrinas, como server,world,x,y,z,yaw,pitch.
pause-seconds3.0El descanso entre que acaba un turno y empieza el siguiente.
radius24.0A qué distancia debe estar un jugador para que una vitrina se reproduzca y se vea, en bloques.
only[]Los ids de efecto entre los que elige una vitrina. Vacío elige entre todos.
effect-scale1.0Qué tamaño tiene cada efecto: cada desplazamiento, movimiento, cuerpo y dispersión de partículas se multiplica por ese valor.

shop#

Un efecto bloqueado se puede comprar desde el menú con moneda. La fila dibuja su precio y un clic izquierdo pide confirmación antes de cobrar nada. Un jugador sin exyliarrows.buy no ve el precio, ni en el menú clásico ni en el selector 3D.

yaml
shop:
  enabled: true
  tier-prices:
    common: 500
    rare: 1500
    epic: 4000
    legendary: 10000

tier-prices es lo que cuesta un efecto según su rareza, en la moneda por defecto. Una rareza que falte no está a la venta. Un precio es un número (500, 2.5k) o un bloque que nombra una moneda: {amount: 50, currency: gems}. Un efecto de effects.yml puede fijar su propio price, que gana al de su rareza. El dinero lo cobra ExyliaEconomy o Vault; sin ninguno instalado, o con la tienda apagada, los efectos bloqueados se ven como siempre. Mira Economía.

Un efecto comprado queda desbloqueado en la cuenta, igual que uno ganado en la caja: sobrevive a un rango y no se puede intercambiar. Una compra que no se pudo entregar devuelve el dinero. La confirmación y cada respuesta que envía son líneas propias de ExyliaLib, bajo purchase en el messages.yml de ExyliaLib, compartidas por todos los plugins cosméticos.

ownership#

Dónde cuenta lo que un jugador desbloquea aquí, para redes con varios servidores.

yaml
ownership:
  scope: global
  global-currencies: []

scope es global (un desbloqueo cuenta en todos los servidores, el valor por defecto), server, default (el grupo de red de este servidor) o el nombre de un grupo. Lo desbloqueado de forma global siempre cuenta. Una compra pagada con una de las global-currencies se guarda como global sea cual sea el scope. Reinicia el servidor para aplicar un cambio. Nuevo en v1.8.0

messages.yml#

Todas las líneas que envía el plugin, y cada palabra que dibuja un objeto o el menú, están en lang/<código>/messages.yml. prefix es {primary}&lE-ARROWS {letters_black}•<reset> y el resto de mensajes empieza con %prefix%. Los códigos de color y las {etiquetas} se explican en Colores.

Claves de mensajes
ClaveCuándo se envía
boundSe ató un efecto a un arco.
unboundSe desató y se devolvió.
chosenSe eligió un efecto en el menú.
clearedSe quitó el efecto.
not-a-bowEl objeto no puede llevar un efecto.
wrong-bowEl efecto no encaja en ese arco.
unknown-effectEl id no nombra nada declarado.
already-boundEl arco ya lleva un efecto.
no-effectEl arco no lleva ninguno.
inventory-fullUn removedor necesita un hueco libre.
no-permissionEl jugador no tiene el efecto.
feature-lockedSu rango no incluye una función: su nodo está denegado.
empty-handUn subcomando de mano con la mano vacía.
given, given-remover, given-keySe dieron fichas, removedores o llaves.
rewards-claimedSe entregaron al entrar objetos que no cabían y estaban esperando.
list-header, list-entry, list-empty/arrowsadmin list.
visibility-setCambió la visibilidad.
refreshedTerminó refresh o validate.
menu-disabledSe abrió el menú en un servidor bow.
favourite-added, favourite-removed, favourites-cleared, favourites-emptyLa lista de favoritos.
random-chosenSe puso que cada disparo saque un efecto distinto.
crate-won, crate-duplicate, crate-no-keysUna caja cayó en algo nuevo, en algo que ya tenía, o no se pudo pagar.
crate-busy, crate-empty, crate-disabledYa hay una caja cayendo, no hay nada que entregar, o está apagada.
keys-received, keys-taken, keys-givenCambiaron de manos unas llaves.
unlock-granted, unlock-already, unlock-revoked/arrowsadmin unlocks.
crate-block-*, crate-blocks-*/arrowsadmin crate block.
preview-location-set, preview-unavailable, preview-unavailable-adminEl escenario de vistas previas.
showcase-*, showcases-*/arrowsadmin showcase.
favourites-clear-prompt, confirm-*La confirmación antes de vaciar favoritos, el efecto de un jugador, los bloques de caja o las vitrinas.
player-resetSe le dice al jugador cuando el staff restablece su elección: vuelve al predeterminado de su rango, si lo hay.

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

Debajo de los mensajes, las palabras que se dibujan en vez de enviarse:

ClaveQué es
token-item, remover-item, key-itemEl name y el lore de cada objeto. En la ficha, %effect% es el nombre del efecto y %bows% a qué encaja.
bow-loreLas líneas bajo un arco atado. %effect% es el nombre del efecto.
menuCómo llama el menú a las cosas: empty, tab-open, tab-closed, bows-any, bow-names, favourites-name, favourite-on, favourite-off, random-name, random-on, random-off, default-marker, filter-all, filter-owned.
particlesCómo se llama cada modo de visibilidad: name-all, name-none, name-self-only, name-others-only.
spatialTodos los textos que dibuja el selector 3D: sus botones, la ficha del efecto, la línea de ayuda, las pestañas, la visita guiada y las líneas spot-* de /arrowsadmin spatial. El archivo de disposición solo los coloca.
placeholdersnone, lo que responde cualquier %exyliarrows_...% cuando no hay valor, y unknown, lo que responde uno que nombra algo que ya no existe.

menu.bow-names es cómo se escribe un arco allá donde se dibuje %bows%, por familia (bow, crossbow, trident, ranged) o por id de objeto. Lo que falte se escribe a partir de su id.

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