Referencia

Configuración

Cada bloque de config.yml, con sus valores por defecto.

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.

`behaviour`

behaviour:
  mode: both
  consume-token: true
  consume-remover: true
  require-permission: true
  hide-without-permission: false

Clave	Por defecto	Qué hace
`mode`	`both`	`player`, `weapon` o `both`. Ver Modos y fichas.
`consume-token`	`true`	Si la ficha se gasta al atarla.
`consume-remover`	`true`	Si el removedor se gasta al quitar un efecto.
`require-permission`	`true`	Si lanzar un efecto necesita su nodo. Los comandos y la API nunca se limitan por esto.
`hide-without-permission`	`false`	Si los efectos bloqueados se esconden en el menú en vez de mostrarse bloqueados.

`effects`

Qué golpes lanzan algo.

effects:
  all-mobs: false
  allowed-mobs:
    - PLAYER
    - MANNEQUIN
    - ZOMBIE

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.

`token-item`, `remover-item` y `key-item`

token-item:
  material: FIREWORK_STAR
  name: "{primary}&lHIT EFFECT &8» %effect%"
  lore:
    - "{secondary}Information:"
    - " {letters_black}▎ {letters}Drop this onto a weapon to"
    - " {letters_black}▎ {letters}{highlight}bind the effect {letters}to it. The weapon"
    - " {letters_black}▎ {letters}keeps everything it had."
    - ""
    - "{secondary}Fits:"
    - " {letters_black}▎ {info}%weapons%"
    - ""
    - "{warning}➥ Drop onto a weapon to bind"
    - ""
  glow: true
 
remover-item:
  material: SCRAPE_POTTERY_SHERD
  name: "{primary}&lEFFECT REMOVER"
  glow: true
 
key-item:
  material: TRIPWIRE_HOOK
  name: "{primary}&lCRATE KEY"
  glow: true

%effect% es el nombre del efecto y %weapons% a qué encaja. material solo se usa cuando el efecto no trae icono propio — normalmente la ficha se dibuja con el material del efecto.

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: true
  lines:
    - "{secondary}Hit Effect:"
    - " {letters_black}▎ {highlight}%effect%"

Se dibuja bajo el lore propio del arma atada, solo en paquetes. El objeto nunca lleva estas líneas.

menu:
  empty: "{muted}Nothing"
  tab-open: "{success}✔ You are here"
  tab-closed: "{warning}➥ Click to open"
  weapons-any: "Any weapon"
  favourites-name: "Favourites"
  favourites-icon: "AMETHYST_SHARD"
  favourite-on: "{highlight}★ In your favourites"
  favourite-off: "{muted}☆ Not in your favourites"
  random-name: "{highlight}Random"
  random-on: "{success}✔ Every hit is a surprise"
  random-off: "{warning}➥ Click to surprise yourself"

random-name es cómo se llama la elección aleatoria donde sea que se dibuje el efecto que lleva un jugador, placeholders incluidos. random-on y random-off son la línea que muestra el botón mientras es, y mientras no es, la elección que lleva.

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

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`

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

Clave	Por defecto	Qué hace
`enabled`	`true`	Si la caja se abre. Apagada, su botón lo dice.
`start-keys`	`0`	Llaves que recibe un jugador la primera vez que se lo ve.
`duplicate-refund`	`1`	Llaves que se devuelven cuando la caja cae en algo que ya tenía.
`reward`	`UNLOCK`	Qué entrega una ganancia: `UNLOCK`, `ITEM` o `BOTH`.
`blocks`	vacío	Bloques que abren la caja, como `server,world,x,y,z,yaw,pitch`.
`max-at-once`	`4`	Cuántas cajas se pueden abrir de una vez. La pantalla la limita a siete.
`spin-frames`	`34`	Caras por las que pasa el primer carrete. Tope 200, unos once segundos.
`stagger-seconds`	`2.0`	Cuánto después de un carrete se detiene el siguiente. `0` los para juntos.
`on-spin`	note block hat	Suena mientras caen los carretes.
`on-win`	level up	Suena en el momento en que un carrete cae en algo nuevo, una vez por caja.
`on-duplicate`	note block bass	Suena 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.

preview:
  location: ""
  distance: 5.0
  settle-ticks: 4
  linger-ticks: 20
  max-ticks: 600

Una previsualización 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.

Clave	Por defecto	Qué hace
`location`	vacío	Dónde se para el jugador mientras corre la previsualización.
`distance`	`5.0`	A cuántos bloques delante de él se lanza el efecto.
`settle-ticks`	`4`	Cuánto esperar tras el teleport, para que el cliente tenga la posición nueva.
`linger-ticks`	`20`	Cuánto se sostiene el escenario después de que el efecto termina.
`max-ticks`	`600`	Lo máximo que puede durar una previsualización, pase lo que pase.

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.

`feedback`

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

`particles`

particles:
  default-visibility: "ALL"
  name-all: "All"
  name-none: "None"
  name-self-only: "Self Only"
  name-others-only: "Others Only"

default-visibility es con lo que empieza un jugador. Los cuatro nombres son cómo llaman los menús y los placeholders a cada modo.

`placeholders`

placeholders:
  none: "None"

Lo que responde cualquier %exyliahiteffect_...% cuando no hay valor.

`messages`

Todas las líneas que envía el plugin. prefix es {primary}&lE-HITS &8•&r y el resto de mensajes empieza con %prefix%.

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.
`list-header` / `list-entry` / `list-empty`	`/hiteffectsadmin 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`	La lista de favoritos.
`random-chosen`	Se activó la elección aleatoria.
`crate-won` / `crate-duplicate`	La caja cayó en algo nuevo, o en algo que ya tenía.
`crate-no-keys` / `crate-busy` / `crate-empty` / `crate-disabled`	La caja negándose a abrir.
`keys-received` / `keys-taken` / `keys-given`	Cambió el saldo de llaves.
`unlock-granted` / `unlock-already` / `unlock-revoked` / `unlocks-cleared`	Los subcomandos `unlocks`.
`crate-block-` / `crate-blocks-`	Los subcomandos `crate block`.
`preview-location-set`	Se movió el escenario de previsualización.
`preview-unavailable` / `preview-unavailable-admin`	Una previsualización en un servidor sin escenario.

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

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

behaviour

effects

token-item, remover-item y key-item

weapon-lore

menu

tiers

crate

preview

feedback

particles

placeholders

messages