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.
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 cajalanguage#
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.
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.
disabled-worlds:
- lobbyPara 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.
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:
behaviour:
defaults:
- permission: group.vip
cosmetic: random
- permission: ''
cosmetic: ember_trailSe 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
| Clave | Por defecto | Qué hace |
|---|---|---|
mode | both | player, bow o both. |
consume-token | true | Si la ficha se gasta al atarla. |
consume-remover | true | Si el removedor se gasta al desatar. |
hide-without-permission | false | Si 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.
projectiles:
all-types: false
default-allowed-types:
- ARROW
- SPECTRAL_ARROW
- TRIDENTall-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.
trail:
default-interval: 1
max-duration: 10
max-active: 200
max-active-per-player: 10Los disparos que pasan de max-active siguen reproduciendo su lanzamiento e impacto; simplemente no dejan estela. Pon un límite en 0 para quitarlo.
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
| Clave | Por defecto | Qué hace |
|---|---|---|
default-interval | 1 | Ticks entre pasos de la estela para un efecto sin trail-interval. |
max-duration | 10 | Segundos que puede vivir una estela antes de cancelarse, para que una flecha perdida en un chunk descargado no dibuje para siempre. |
max-active | 200 | Cuántas estelas pueden dibujarse a la vez en todo el servidor. 0 quita el límite. |
max-active-per-player | 10 | Cuántas de ellas puede tener dibujándose un mismo jugador. 0 lo quita. |
token-item, remover-item y key-item#
token-item:
material: FIREWORK_STAR
glow: true
remover-item:
material: SCRAPE_POTTERY_SHERD
glow: true
key-item:
material: TRIPWIRE_HOOK
glow: truematerial 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#
bow-lore:
enabled: trueSi 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.
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: 4chance 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
| Clave | Por defecto | Qué hace |
|---|---|---|
name | según la rareza | Cómo la llaman los menús y los placeholders. |
material | según la rareza | Se sigue leyendo del archivo, pero la caja vive en ExyliaLib desde 1.4.0 y no lo recibe. |
color | según la rareza | El color de su nombre y de sus efectos. Mira Colores. |
chance | 60, 25, 12, 3 | Un peso. |
priority | 1 a 4 | Su 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.
crate:
enabled: true
start-keys: 0
duplicate-refund: 1
reward: UNLOCK
blocks: []
max-at-once: 4
opening: INVENTORYreward 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
| Clave | Por defecto | Qué hace |
|---|---|---|
enabled | true | Si la caja se puede abrir. Apagada, su botón lo dice en vez de abrir. |
start-keys | 0 | Llaves que recibe un jugador la primera vez que se le ve. |
duplicate-refund | 1 | Llaves que se devuelven cuando una caja cae en un efecto que ya tiene. |
reward | UNLOCK | UNLOCK, ITEM o BOTH. |
blocks | vacío | Los 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-once | 4 | Cuá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-frames | 34 | Cuántas caras recorre el primer carrete antes de parar. Máximo 200, unos once segundos. |
stagger-seconds | 2.0 | Cuánto después de parar un carrete para el siguiente. 0 los para a la vez. |
on-spin, on-win, on-duplicate | un sonido cada uno | Bloques 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. |
opening | INVENTORY | INVENTORY 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.
preview:
location: ""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
| Clave | Por defecto | Qué hace |
|---|---|---|
location | vacío | Dónde se coloca el jugador, como server,world,x,y,z,yaw,pitch. |
distance | 5.0 | A cuántos bloques delante de él se reproduce el efecto. |
settle-ticks | 4 | Cuánto esperar tras el movimiento, para que el cliente tenga la nueva posición antes de la primera partícula. |
linger-ticks | 20 | Cuánto se mantiene el escenario cuando el efecto termina. |
max-ticks | 600 | Lo 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.
menu#
menu:
favourites-icon: "AMETHYST_SHARD"
style: CLASSICstyle 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#
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.0Bloques 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#
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.
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
| Clave | Por defecto | Qué hace |
|---|---|---|
locations | [] | Dónde están las vitrinas, como server,world,x,y,z,yaw,pitch. |
pause-seconds | 3.0 | El descanso entre que acaba un turno y empieza el siguiente. |
radius | 24.0 | A 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-scale | 1.0 | Qué 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.
shop:
enabled: true
tier-prices:
common: 500
rare: 1500
epic: 4000
legendary: 10000tier-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.
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
| 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 ese 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. |
feature-locked | Su rango no incluye una función: su nodo está denegado. |
empty-hand | Un subcomando de mano con la mano vacía. |
given, given-remover, given-key | Se dieron fichas, removedores o llaves. |
rewards-claimed | Se entregaron al entrar objetos que no cabían y estaban esperando. |
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á apagada. |
keys-received, keys-taken, keys-given | Cambiaron 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-admin | El 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-reset | Se 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:
| Clave | Qué es |
|---|---|
token-item, remover-item, key-item | El name y el lore de cada objeto. En la ficha, %effect% es el nombre del efecto y %bows% a qué encaja. |
bow-lore | Las líneas bajo un arco atado. %effect% es el nombre del efecto. |
menu | Có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. |
particles | Cómo se llama cada modo de visibilidad: name-all, name-none, name-self-only, name-others-only. |
spatial | Todos 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. |
placeholders | none, 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