Contenido generado con IA — puede contener errores.

ExyliaHitEffect/ReferenciaActualizada en v1.7.0

Configuración

Dónde guarda ExyliaHitEffect sus archivos, cómo recargarlos y cada bloque de config.yml y messages.yml con su valor por defecto.

Página 13 de 2115 min de lectura
      - PLAYER    - MANNEQUIN    - ZOMBIE             

ExyliaHitEffect se configura en plugins/ExyliaHitEffect/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 /hiteffectsadmin reload: relee solo los archivos de este plugin, no los de ExyliaLib. También puedes cambiar cualquier clave con el botón SETTINGS de /hiteffectsadmin, sin abrir el archivo (Instalación). 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.

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. Guarda cómo se comporta el plugin; cada palabra que lee un jugador está en lang/<code>/messages.yml, al final de esta página.

language#

yaml
language: default

De qué carpeta de plugins/ExyliaHitEffect/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/ExyliaHitEffect/
  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 /hiteffectsadmin reload.

Los servidores que venían de 1.2.0 conservan sus menús

En el primer arranque de 1.4.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. Las líneas de chat del antiguo bloque messages de config.yml no se trasladan: vuelve a aplicar en messages.yml las que hubieras editado. Pon language en default o en un código para pasar a las traducciones que vienen.

behaviour#

yaml
behaviour:
  mode: both
  consume-token: true
  consume-remover: true
  hide-without-permission: false
  defaults: []
ClavePor defectoQué hace
modebothplayer, weapon o both. Ver Modos y fichas.
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: CRIT_SPARK.

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.

effects#

Qué golpes lanzan algo.

yaml
effects:
  all-mobs: false
  allowed-mobs:
    - PLAYER
    - MANNEQUIN
    - ZOMBIE
  disabled-worlds: []

disabled-worlds lista los mundos donde los efectos de golpe nunca se reproducen. Viene vacía; los nombres se comparan sin distinguir mayúsculas.

all-mobs en un servidor de granjas

all-mobs: true significa que cada zombie de una granja lanza un efecto en cada golpe que recibe. Los efectos de golpe suelen ser para PvP: deja la lista salvo que quieras chispas en cada mob que pegues. En cualquier caso un jugador lanza como mucho cinco efectos por segundo; un barrido entre varios reproduce los cinco primeros y descarta el resto.

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 — 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
ClavePor defectoQué hace
favourites-iconAMETHYST_SHARDEl material con el que se dibuja la pestaña de favoritos.
styleCLASSICQué abre /hiteffect. CLASSIC: el menú de inventario. SPATIAL: el selector 3D, colocado según spatial/effects.yml. /hiteffect 3d siempre abre el 3D, /hiteffect classic el de inventario.

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

tiers#

Las rarezas en las que se ordenan los efectos, y con qué frecuencia sale cada una de una 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 }

La clave es el id de rareza que effects.yml escribe como tier. Agregá, renombrá o borrá las que quieras — nada está fijo en el código, y chance es un peso, no un porcentaje. El detalle completo está en La caja.

crate#

yaml
crate:
  enabled: true
  start-keys: 0
  duplicate-refund: 1
  reward: UNLOCK
  blocks: []
  max-at-once: 4
  spin-frames: 34
  stagger-seconds: 2.0
  opening: INVENTORY
  on-spin:
    sound:
      name: BLOCK_NOTE_BLOCK_HAT
      pitch: 1.6
  on-win:
    sound:
      name: ENTITY_EXPERIENCE_ORB_PICKUP
      volume: 0.7
      pitch: 1.2
  on-duplicate:
    sound:
      name: BLOCK_NOTE_BLOCK_BASS
      pitch: 0.8
ClavePor defectoQué hace
enabledtrueSi la caja se abre. Apagada, su botón lo dice.
start-keys0Llaves que recibe un jugador la primera vez que se lo ve.
duplicate-refund1Llaves que se devuelven cuando la caja cae en algo que ya tenía.
rewardUNLOCKQué entrega una ganancia: UNLOCK, ITEM o BOTH.
blocksvacíoBloques que abren la caja, como server,world,x,y,z,yaw,pitch.
max-at-once4Cuántas cajas se pueden abrir de una vez. La pantalla la limita a siete. Quien tiene exyliahiteffect.crate.multi.<n> puede abrir <n>, el más alto.
spin-frames34Caras por las que pasa el primer carrete. Tope 200, unos once segundos.
stagger-seconds2.0Cuánto después de un carrete se detiene el siguiente. 0 los para juntos.
openingINVENTORYCómo se muestra una apertura. INVENTORY: los carretes caen por menus/crate_open.yml. SPATIAL: una caja en el mundo delante del jugador, según spatial/crate.yml. Ver La caja.
on-spinnote block hatSuena mientras caen los carretes.
on-winexperience orbSuena en el momento en que un carrete cae en algo nuevo, una vez por caja.
on-duplicatenote block bassSuena en cambio cuando ese carrete cayó en algo que ya se tenía.
Atá los bloques en el juego

/hiteffectsadmin crate block add escribe el bloque que estás mirando. Un bloque atado no se puede romper, volar ni empujar mientras esté en la lista — que es lo que editar esta clave a mano no te da.

preview#

Dónde se muestran las previsualizaciones. En el selector 3D y en la vista previa de la caja, un efecto de golpe se repite cada segundo, así que se ve como una ráfaga de golpes y no uno con pausa. Nuevo en v1.7.0

yaml
preview:
  location: ""
  distance: 5.0
  settle-ticks: 4
  linger-ticks: 20
  max-ticks: 600
  mode: TELEPORT
  mannequin:
    locations: []
    trial-seconds: 30
    radius: 12.0
    vanish-on-hit: false
    effect-scale: 1.0
    skins: [others, viewer]

mode elige una de dos formas. TELEPORT lleva al jugador al escenario, lanza el efecto delante de él donde solo él lo ve, y lo devuelve exactamente a donde estaba; hasta que location esté puesta, no hay previsualización y se dice. Ponela en el juego con /hiteffectsadmin preview location, no a mano. MANNEQUIN no mueve a nadie: al jugador se le presta el efecto durante trial-seconds y golpea los maniquíes todas las veces que quiera, con el efecto sonando solo en ellos. Se cambia con /hiteffectsadmin preview mode y se colocan con /hiteffectsadmin preview mannequin add.

ClavePor defectoQué hace
locationvacíoDónde se para el jugador mientras corre la previsualización.
distance5.0A cuántos bloques delante de él se lanza el efecto.
settle-ticks4Cuánto esperar tras el teleport, para que el cliente tenga la posición nueva.
linger-ticks20Cuánto se sostiene el escenario después de que el efecto termina.
max-ticks600Lo máximo que puede durar una previsualización, pase lo que pase.
modeTELEPORTTELEPORT o MANNEQUIN.
mannequin.locations[]Dónde están los maniquíes. Se ponen en el juego.
mannequin.trial-seconds30Cuánto tiempo se presta el efecto que se previsualiza.
mannequin.radius12.0Una vez que el jugador llegó a un maniquí, alejarse más que esto de todos termina el préstamo antes, en bloques.
mannequin.vanish-on-hitfalseSi un maniquí golpeado desaparece para ese jugador mientras suena el efecto.
mannequin.effect-scale1.0Lo grande que suena el efecto en un maniquí, como múltiplo de su tamaño escrito.
mannequin.skins[others, viewer]Qué skin lleva el maniquí, la primera fuente que tenga una: others, viewer o defaults.
Dos jugadores pueden compartir un escenario

Todos los que están en el escenario están ocultos entre sí, y cada efecto se envía a un solo jugador, así que una sola ubicación sirve para el servidor entero.

showcase#

Sitios que reproducen efectos de golpe solos, una y otra vez, para quien pase por delante: una pieza central del lobby en vez de una pelea. Dos cuerpos se colocan a cada lado del punto, de través a hacia donde mirabas al ponerlo, y uno golpea al otro tres veces, con el efecto cayendo en cada golpe. Llevan las skins de los jugadores que están cerca, así que el público que mira es el reparto.

yaml
showcase:
  locations: []
  pause-seconds: 3.0
  radius: 24.0
  only: []
ClavePor defectoQué hace
locations[]Dónde se reproducen efectos en bucle. Se fijan con /hiteffectsadmin showcase add.
pause-seconds3.0El descanso entre que termina un efecto y empieza el siguiente.
radius24.0Lo cerca que tiene que estar un jugador para que un showcase se reproduzca y se vea, en bloques.
only[]Los ids de efecto entre los que elige un showcase. Vacío elige entre todos.
effect-scale1.0Qué tan grande reproduce un showcase cada efecto, como múltiplo de su tamaño escrito.

Sin nadie dentro de radius no se reproduce nada, así que un lobby vacío no cuesta nada. Un jugador con visibilidad NONE o SELF_ONLY no ve los showcases: no son el golpe propio de nadie.

feedback#

yaml
feedback:
  on-bind:
    sound:
      name: ENTITY_EXPERIENCE_ORB_PICKUP
      volume: 0.7
      pitch: 1.4
  on-unbind:
    sound:
      name: ITEM_BUNDLE_REMOVE_ONE
      volume: 0.7
      pitch: 0.8

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

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.

yaml
shop:
  enabled: true
  tier-prices:
    common: 500
    rare: 1500
    epic: 4000
    legendary: 10000
ClavePor defectoQué hace
enabledtrueSi un efecto bloqueado se puede comprar desde el menú.
tier-prices500 / 1500 / 4000 / 10000Lo 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; 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. Nuevo en v1.7.0

messages.yml#

Todas las líneas que envía el plugin, y cada palabra que dibuja un objeto o el menú, en lang/<code>/messages.yml. prefix es {primary}&lE-HITS {letters_black}•<reset> y el resto de mensajes empieza con %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/hiteffectsadmin 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-emptyLa lista de favoritos.
random-chosenSe activó la elección aleatoria.
crate-won / crate-duplicateLa caja cayó en algo nuevo, o en algo que ya tenía.
crate-no-keys / crate-busy / crate-empty / crate-disabledLa caja negándose a abrir.
keys-received / keys-taken / keys-givenCambió el saldo de llaves.
unlock-granted / unlock-already / unlock-revokedLos subcomandos unlocks.
feature-lockedUna función que el rango del jugador no incluye: su nodo está denegado.
crate-block-* / crate-blocks-*Los subcomandos crate block.
preview-location-setSe movió el escenario de previsualización.
preview-unavailable / preview-unavailable-adminUna previsualización en un servidor sin escenario.
preview-mode-setpreview mode cambió cómo se muestran las previsualizaciones.
preview-trial / preview-trial-barEmpezó una previsualización con maniquí, y la barra de jefe que la cuenta.
preview-no-mannequin / preview-no-mannequin-adminUna previsualización con maniquí sin ningún maniquí colocado.
preview-mannequin-added / preview-mannequin-removed / preview-mannequin-missing / preview-mannequins-clearedLos subcomandos preview mannequin.
showcase-* / showcases-*Los subcomandos showcase.
confirm-player-clear / confirm-crate-blocks-clear / confirm-showcases-clearUn borrado de admin que pide repetir el comando.
favourites-clear-promptLa confirmación antes de vaciar los favoritos.
player-resetUn admin restableció la elección de un jugador.

Placeholders en los mensajes: %effect%, %amount%, %id%, %visibility%, %player%, %keys%, %location%, %mode%, %seconds% 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 %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.
particlesCómo se llama cada modo de visibilidad: name-all, name-none, name-self-only, name-others-only.
spatialCada palabra del selector 3D: sus botones, pistas, líneas de la tarjeta, pestañas y recorrido guiado (bajo spatial.stage), más las respuestas de spatial place / remove / tour.
placeholdersnone, lo que responde cualquier %exyliahiteffect_...% 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