Configuración
Dónde guarda ExyliaKillEffect sus archivos, cómo recargarlos y cada bloque de config.yml y messages.yml con su valor por defecto.
ExyliaKillEffect se configura en plugins/ExyliaKillEffect/config.yml. Los efectos en sí están en effects.yml (Efectos, Secuencias), y cada palabra que lee un jugador está en lang/<code>/. Tras editar, ejecuta /killeffectsadmin 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. Los códigos de color y las {etiquetas} de los mensajes se explican en Colores, y cómo editar un idioma en Mensajes e idiomas.
language#
language: defaultDe qué carpeta de idioma de plugins/ExyliaKillEffect/lang/ se leen los menús y los mensajes. default sigue el language del propio config.yml de ExyliaLib, así que una línea allí cambia todos los plugins de Exylia; en, es, pt, fr, ru o tr fijan solo este plugin. Cada idioma es una carpeta completa que puedes editar:
plugins/ExyliaKillEffect/
config.yml
effects.yml
lang/es/messages.yml
lang/es/menus/effects.yml
lang/es/menus/crate.yml
lang/es/menus/crate_open.ymlEl 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 entra con /killeffectsadmin reload.
En el primer arranque de 1.7.0 los antiguos menus/ se mueven a lang/custom/, los nombres y el lore de los objetos, las líneas del arma, los textos del menú, los nombres de visibilidad y las respuestas de placeholder que guardaba config.yml pasan a lang/custom/messages.yml, y config.yml apunta ahí con language: custom. El antiguo bloque messages: no se traslada: los mensajes de chat editados ahí vuelven a los valores por defecto y hay que editarlos otra vez en messages.yml. Pon language en default o en un código para pasar a las traducciones que vienen.
disabled-worlds y random-worlds#
disabled-worlds: []
random-worlds: []Ambas son listas de nombres de mundo al nivel superior, vacías por defecto, y se comparan sin distinguir mayúsculas.
disabled-worlds: los efectos de muerte nunca suenan ahí.random-worlds: cada muerte lanza un efecto al azar de todo el catálogo, tenga lo que tenga o elija lo que elija el asesino, incluso si no tiene ninguno. Útil para mundos de duelos o arenas.
Un mundo que esté en las dos listas se queda en silencio: manda disabled-worlds.
behaviour#
De dónde sale el efecto que lanza una baja, y qué hacen las fichas.
behaviour:
mode: both
consume-token: true
consume-remover: true
hide-without-permission: false
defaults: []mode es player (solo lo que el jugador eligió en /killeffect), weapon (solo lo atado al arma) o both (el valor por defecto: el efecto del arma y, si no lleva ninguno, la elección del jugador). Ver Modos y fichas.
Elegir un efecto en el menú siempre necesita su nodo o un desbloqueo; una ficha, un arma atada, un comando y la API nunca. Ver Permisos.
Todas las claves de behaviour
| Clave | Por defecto | Qué hace |
|---|---|---|
mode | both | player, weapon o both. |
consume-token | true | Si la ficha se gasta al atarla. |
consume-remover | true | Si el removedor se gasta al quitar un efecto. |
hide-without-permission | false | Si los efectos bloqueados se esconden en el menú en vez de mostrarse bloqueados. |
defaults | [] | El efecto que suena mientras el jugador no ha elegido uno, por rango. Se lee de arriba abajo y gana la primera línea que cumple; cada línea es permission (vacío significa todos, déjala la última) y cosmetic (un id de efecto, random para uno al azar de los que posee, o none). No se desbloquea ni se guarda nada: el menú lo marca como el del rango, y quien se lo quita no suena nada. Se ignora con mode: weapon. Ejemplo: - permission: group.vip / cosmetic: random, y luego - permission: '' / cosmetic: griddy. |
effects#
Qué bajas lanzan algo. Por defecto solo suena el efecto cuando muere un jugador, un maniquí o un zombie.
effects:
all-mobs: false
allowed-mobs:
- PLAYER
- MANNEQUIN
- ZOMBIE
ground-snap: 4.0all-mobs: true significa que cada zombie de una granja lanza una secuencia entera. Los efectos de muerte suelen ser para PvP: deja la lista salvo que quieras una producción en cada mob que cae. En cualquier caso un jugador lanza como mucho tres efectos por segundo; un barrido por una granja reproduce los tres primeros y descarta el resto.
A un jugador que muere en pleno salto o al caer de un borde le pasa en el aire, donde una coreografía dibujada para aterrizar en un suelo no tiene dónde aterrizar. ground-snap busca el suelo esos bloques por debajo y reproduce el efecto ahí. 0 lo reproduce exactamente donde murió.
Todas las claves de effects
| Clave | Por defecto | Qué hace |
|---|---|---|
all-mobs | false | true lanza un efecto en cada baja, muera lo que muera. |
allowed-mobs | PLAYER, MANNEQUIN, ZOMBIE | Qué bajas lanzan un efecto mientras all-mobs está apagado. |
ground-snap | 4.0 | Cuántos bloques se busca el suelo por debajo de la baja. 0 lo apaga. |
trial#
De vez en cuando, la baja de un jugador que no lleva efecto reproduce uno que no tiene: un cosmético se vende mejor en el momento en que se le ve haciendo su trabajo. Viene activado, a una baja de cada doscientas.
trial:
enabled: true
chance: 0.5chance son las probabilidades en cada baja suya, en porcentaje: 0.5 es una de cada doscientas. Solo lo recibe quien no lleva nada, así que nunca pisa lo que alguien eligió o ganó. Cuando el efecto termina se le envía trial-played de messages.yml, que lo lleva a /killeffect. Pon enabled: false para apagarlo.
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 trae icono propio: normalmente la ficha se dibuja con el material del efecto. Cómo se llama cada objeto y qué dice su lore está en messages.yml.
key-item es la llave que se lleva en la mano: click derecho a un bloque de caja y se abre. Ver La caja.
weapon-lore#
weapon-lore:
enabled: trueSi se dibujan las líneas bajo un arma atada. Se dibujan solo en paquetes, así que el objeto nunca las lleva, y las líneas en sí son weapon-lore en messages.yml.
menu#
menu:
favourites-icon: "AMETHYST_SHARD"
style: CLASSICstyle decide qué abre /killeffect: CLASSIC es el menú de inventario, SPATIAL es el selector 3D, dispuesto en spatial/effects.yml. /killeffect 3d y /killeffect classic abren uno u otro diga lo que diga esto. favourites-icon es el material con el que se dibuja la pestaña de favoritos (AMETHYST_SHARD por defecto).
Cómo llama el menú a las cosas está en messages.yml, y la pantalla de inventario en sí es menus/effects.yml; ver El menú y Editar menús.
tiers#
Las rarezas en las 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. Un efecto que nombra una rareza que ya no existe cae en la primera. La referencia completa está en La caja.
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: las probabilidades que muestra el menú se calculan a partir de él, así que borrar una rareza reparte sus probabilidades en vez de dejar un hueco. priority es el lugar que ocupa en los menús, de menor a mayor.
crate#
La caja convierte una llave virtual en un efecto al azar. Viene activada y no da llaves al empezar.
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
opening: INVENTORYAta los bloques de caja en el juego con /killeffectsadmin crate block add en vez de a mano: escribe el bloque al que miras, y un bloque atado no se puede romper, explotar ni empujar.
Todas las claves de crate
| Clave | Por defecto | Qué hace |
|---|---|---|
enabled | true | Apagada, el botón de la caja 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 devueltas por un efecto que ya se tenía. |
reward | UNLOCK | Qué entrega la caja: UNLOCK (desbloqueado en la cuenta), ITEM (solo la ficha, así que ninguna apertura es un duplicado) o BOTH. ITEM y BOTH piden behaviour.mode en weapon o both. |
blocks | [] | Los bloques que abren la caja, cada uno escrito server,world,x,y,z,yaw,pitch. |
max-at-once | 4 | Cuántas cajas puede abrir un jugador de una vez, hasta siete. Quien tenga exyliakilleffect.crate.max.<n> puede abrir <n>, el más alto que tenga. |
spin-frames | 34 | Cuántas caras recorre el primer rodillo. Tope de 200. |
stagger-seconds | 2.0 | Cuánto después de parar uno para el siguiente. 0 los para a la vez. |
opening | INVENTORY | Cómo se muestra una apertura. INVENTORY: los rodillos de menus/crate_open.yml. SPATIAL: una caja en el mundo delante del jugador, con su aspecto en spatial/crate.yml. Consulta La caja. |
on-spin / on-win / on-duplicate | sonidos | Bloques de efecto completos de ExyliaLib. on-spin suena en cada tick de caída; luego una vez por rodillo al parar, on-win si salió algo nuevo u on-duplicate si ya lo tenías. |
preview#
Cómo ve un jugador un efecto antes de tenerlo: desde el menú, /killeffect preview o la API. Es el bloque de previsualización de ExyliaLib, anidado aquí. Fija el escenario con /killeffectsadmin preview location; sin uno, la previsualización avisa al jugador de que no está disponible. mode es TELEPORT (por defecto: se lleva al jugador al escenario y se le devuelve) o MANNEQUIN (no se mueve a nadie; se le presta el efecto para probarlo en los maniquíes que coloques con /killeffectsadmin preview mannequin add).
Todas las claves de preview
| Clave | Por defecto | Qué hace |
|---|---|---|
location | "" | Dónde se coloca el jugador mientras se lanza la previsualización. Solo se usa la posición: una previsualización siempre mira al norte. |
distance | 5.0 | A cuántos bloques delante del jugador se lanza el efecto. |
settle-ticks / linger-ticks / max-ticks | 4 / 20 / 600 | La espera tras el teletransporte, cuánto se mantiene el escenario después y lo máximo que puede durar. |
mode | TELEPORT | TELEPORT o MANNEQUIN. Se cambia con /killeffectsadmin preview mode. |
mannequin.locations | [] | Dónde están los maniquíes. |
mannequin.trial-seconds | 30 | Cuánto dura el préstamo. Una barra de jefe lo cuenta. |
mannequin.radius | 12.0 | Alejarse más que esto de todos los maniquíes termina el préstamo antes. |
mannequin.vanish-on-hit | true | Si el maniquí golpeado desaparece para ese jugador mientras se lanza el efecto, para que un efecto de muerte se lea como una muerte. |
mannequin.effect-scale | 1.0 | El tamaño con el que se lanza el efecto sobre un maniquí. |
mannequin.skins | [others, viewer] | De quién es la skin del cuerpo que cae: others (otro jugador conectado), viewer (quien lo prueba), defaults (las skins de vanilla). |
showcase#
Sitios que reproducen efectos de muerte solos, una y otra vez, para quien pase por delante: una pieza de lobby más que una baja. Los cuerpos llevan las skins de los jugadores que están cerca, así que el público que mira es el reparto. Sin nadie dentro de radius no se reproduce nada, así que un lobby vacío no cuesta nada. Pon uno donde estás con /killeffectsadmin showcase add.
showcase:
locations: []
pause-seconds: 3.0
radius: 24.0
effects: []Todas las claves de showcase
| Clave | Por defecto | Qué hace |
|---|---|---|
locations | [] | Dónde se reproducen en bucle, cada una escrita server,world,x,y,z,yaw,pitch. |
pause-seconds | 3.0 | El descanso entre que un efecto termina y empieza el siguiente. |
radius | 24.0 | Cuánto tiene que acercarse un jugador para que se reproduzca y lo vea, en bloques. |
effects | [] | Los ids entre los que elige. Vacío elige entre todos los efectos. |
feedback#
feedback:
on-bind:
sound:
name: BLOCK_ENCHANTMENT_TABLE_USE
volume: 1.0
pitch: 1.2
on-unbind:
sound:
name: BLOCK_GRINDSTONE_USESon 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 arma o al elegirlo en el menú; on-unbind al quitarlo.
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.
shop#
Un efecto bloqueado se puede comprar directamente desde el menú con moneda. La fila dibuja su precio y un click izquierdo pide al jugador que confirme antes de cobrar nada. Viene activada, pero necesita una economía para cobrar.
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 no aparece 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 en effects.yml puede poner su propio price, que gana al de su rareza. El dinero lo cobra ExyliaEconomy o Vault (Economía); sin ninguno instalado, o con la tienda apagada, los efectos bloqueados se ven exactamente como siempre.
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 de 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 globalmente siempre cuenta. Una compra pagada con una de las global-currencies se guarda globalmente sea cual sea el scope. Reinicia el servidor para aplicar un cambio. El almacenamiento se explica en Base de datos. Nuevo en v1.10.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/<code>/messages.yml. prefix es {primary}&lE-KILLS {letters_black}•<reset> y el resto de mensajes empieza con %prefix%. Placeholders en los mensajes: %effect%, %amount%, %id%, %visibility%, %player%, %location% y %prefix%.
Claves de mensajes
| Clave | Cuándo se envía |
|---|---|
bound | Se ató un efecto a un arma. |
unbound | Se desató y se devolvió. |
chosen | Se eligió un efecto en el menú. |
cleared | Se quitó el efecto. |
not-a-weapon | El objeto no puede llevar un efecto. |
wrong-weapon | El efecto no encaja en esa arma. |
unknown-effect | El id no nombra nada declarado. |
already-bound | El arma ya lleva un efecto. |
no-effect | El arma 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. |
rewards-claimed | Un jugador entra y se le entregan las recompensas que le esperaban. |
list-header / list-entry / list-empty | /killeffectsadmin list. |
visibility-set | Cambió la visibilidad. |
refreshed | Terminó refresh o validate. |
menu-disabled | Se abrió el menú en un servidor weapon. |
favourite-added / favourite-removed / favourites-cleared / favourites-empty / favourites-clear-prompt | La lista de favoritos. |
random-chosen | Se activó la elección aleatoria. |
player-reset | El staff reinició la elección de un jugador: vuelve al efecto de su rango, si lo hay. |
confirm-player-clear / confirm-crate-blocks-clear / confirm-showcases-clear | La confirmación antes de vaciar. |
crate-won / crate-duplicate | Una caja cayó en algo nuevo, o en algo ya conseguido. |
crate-no-keys / crate-busy / crate-empty / crate-disabled | La caja se negó a abrirse. |
keys-received / keys-taken / keys-given | Las llaves cambiaron de manos. |
unlock-granted / unlock-already / unlock-revoked | Subcomandos unlocks. |
crate-block-* / crate-blocks-* | Subcomandos crate block. |
preview-location-set | Se movió el escenario de previsualización. |
preview-unavailable / preview-unavailable-admin | Se pidió una previsualización sin escenario fijado. |
preview-no-mannequin / preview-no-mannequin-admin | Se pidió una previsualización en modo mannequin sin ningún maniquí colocado. |
preview-trial / preview-trial-bar | Empezó una prueba en los maniquíes, y la barra de jefe que la cuenta. %seconds% es lo que queda. |
preview-mode-set / preview-mannequin-* / preview-mannequins-cleared | Subcomandos preview mode y preview mannequin. |
feature-locked | Una función que el rango del jugador no incluye: su nodo de permiso está denegado. |
trial-played | Terminó un efecto de prueba. |
showcase-* / showcases-* | Subcomandos showcase. |
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 %weapons% a qué encaja. |
weapon-lore | Las líneas bajo un arma atada. %effect% es el nombre del efecto. |
menu | Cómo llama el menú a las cosas: empty, tab-open, tab-closed, weapons-any, weapon-names, favourites-name, favourite-on, favourite-off, random-name, random-on, random-off. |
spatial | Cada palabra que dibuja el selector 3D: sus botones, la tarjeta, las ayudas, las pestañas y la visita guiada, más spot-* para los subcomandos spatial. |
particles | Cómo se llama cada modo de visibilidad: name-all, name-none, name-self-only, name-others-only. |
placeholders | none, lo que responde cualquier %exyliakilleffect_...% cuando no hay valor, y unknown, lo que responde uno que nombra algo que ya no existe. |
menu.weapon-names es cómo se escribe un arma allí donde se dibuja %weapons%, por familia (sword, axe, trident, mace, bow, crossbow, melee, ranged) o por id de objeto (netherite_sword). Lo que falte se deletrea a partir de su id.
¿Falta algo en esta página? Dínoslo en Discord