Contenido generado con IA — puede contener errores.

ExyliaKillEffect/ReferenciaActualizada en v1.10.0

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.

Página 14 de 2216 min de lectura
       - PLAYER    - MANNEQUIN    - ZOMBIE             

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#

yaml
language: default

De 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.yml

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 entra con /killeffectsadmin reload.

Los servidores que venían de 1.5.0 conservan sus cambios

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#

yaml
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.

yaml
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
ClavePor defectoQué hace
modebothplayer, weapon o both.
consume-tokentrueSi la ficha se gasta al atarla.
consume-removertrueSi el removedor se gasta al quitar un efecto.
hide-without-permissionfalseSi 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.

yaml
effects:
  all-mobs: false
  allowed-mobs:
    - PLAYER
    - MANNEQUIN
    - ZOMBIE
  ground-snap: 4.0
all-mobs en un servidor de granjas

all-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
ClavePor defectoQué hace
all-mobsfalsetrue lanza un efecto en cada baja, muera lo que muera.
allowed-mobsPLAYER, MANNEQUIN, ZOMBIEQué bajas lanzan un efecto mientras all-mobs está apagado.
ground-snap4.0Cuá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.

yaml
trial:
  enabled: true
  chance: 0.5

chance 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#

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 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#

yaml
weapon-lore:
  enabled: true

Si 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.

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

style 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.

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: 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.

yaml
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: INVENTORY

Ata 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
ClavePor defectoQué hace
enabledtrueApagada, el botón de la caja lo dice en vez de abrir.
start-keys0Llaves que recibe un jugador la primera vez que se le ve.
duplicate-refund1Llaves devueltas por un efecto que ya se tenía.
rewardUNLOCKQué 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-once4Cuá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-frames34Cuántas caras recorre el primer rodillo. Tope de 200.
stagger-seconds2.0Cuánto después de parar uno para el siguiente. 0 los para a la vez.
openingINVENTORYCó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-duplicatesonidosBloques 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
ClavePor defectoQué 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.
distance5.0A cuántos bloques delante del jugador se lanza el efecto.
settle-ticks / linger-ticks / max-ticks4 / 20 / 600La espera tras el teletransporte, cuánto se mantiene el escenario después y lo máximo que puede durar.
modeTELEPORTTELEPORT o MANNEQUIN. Se cambia con /killeffectsadmin preview mode.
mannequin.locations[]Dónde están los maniquíes.
mannequin.trial-seconds30Cuánto dura el préstamo. Una barra de jefe lo cuenta.
mannequin.radius12.0Alejarse más que esto de todos los maniquíes termina el préstamo antes.
mannequin.vanish-on-hittrueSi 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-scale1.0El 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.

yaml
showcase:
  locations: []
  pause-seconds: 3.0
  radius: 24.0
  effects: []
Todas las claves de showcase
ClavePor defectoQué hace
locations[]Dónde se reproducen en bucle, cada una escrita server,world,x,y,z,yaw,pitch.
pause-seconds3.0El descanso entre que un efecto termina y empieza el siguiente.
radius24.0Cuá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#

yaml
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 arma o al elegirlo en el menú; on-unbind al quitarlo.

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.

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.

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 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.

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 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
ClaveCuándo se envía
boundSe ató un efecto a un arma.
unboundSe desató y se devolvió.
chosenSe eligió un efecto en el menú.
clearedSe quitó el efecto.
not-a-weaponEl objeto no puede llevar un efecto.
wrong-weaponEl efecto no encaja en esa arma.
unknown-effectEl id no nombra nada declarado.
already-boundEl arma ya lleva un efecto.
no-effectEl arma no lleva ninguno.
inventory-fullUn removedor necesita un hueco libre.
no-permissionEl jugador no tiene el efecto.
empty-handUn subcomando de mano con la mano vacía.
given / given-remover / given-keySe dieron fichas, removedores o llaves.
rewards-claimedUn jugador entra y se le entregan las recompensas que le esperaban.
list-header / list-entry / list-empty/killeffectsadmin list.
visibility-setCambió la visibilidad.
refreshedTerminó refresh o validate.
menu-disabledSe abrió el menú en un servidor weapon.
favourite-added / favourite-removed / favourites-cleared / favourites-empty / favourites-clear-promptLa lista de favoritos.
random-chosenSe activó la elección aleatoria.
player-resetEl 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-clearLa confirmación antes de vaciar.
crate-won / crate-duplicateUna caja cayó en algo nuevo, o en algo ya conseguido.
crate-no-keys / crate-busy / crate-empty / crate-disabledLa caja se negó a abrirse.
keys-received / keys-taken / keys-givenLas llaves cambiaron de manos.
unlock-granted / unlock-already / unlock-revokedSubcomandos unlocks.
crate-block-* / crate-blocks-*Subcomandos crate block.
preview-location-setSe movió el escenario de previsualización.
preview-unavailable / preview-unavailable-adminSe pidió una previsualización sin escenario fijado.
preview-no-mannequin / preview-no-mannequin-adminSe pidió una previsualización en modo mannequin sin ningún maniquí colocado.
preview-trial / preview-trial-barEmpezó 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-clearedSubcomandos preview mode y preview mannequin.
feature-lockedUna función que el rango del jugador no incluye: su nodo de permiso está denegado.
trial-playedTerminó un efecto de prueba.
showcase-* / showcases-*Subcomandos showcase.

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 %weapons% a qué encaja.
weapon-loreLas líneas bajo un arma atada. %effect% es el nombre del efecto.
menuCó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.
spatialCada 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.
particlesCómo se llama cada modo de visibilidad: name-all, name-none, name-self-only, name-others-only.
placeholdersnone, 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