Configuración

config.yml y messages.yml se escriben 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. El catálogo es emotes.yml — ver Emotes — y las pantallas están en menus/.

behaviour

Cuándo puede reproducirse un emote, y qué lo corta.

behaviour:
  require-permission: true
  hide-without-permission: false
  cooldown: 3s
  cancel-on-move: true
  move-tolerance: 0.6
  cancel-on-damage: true
  block-in-combat: true
  endless-limit: 5m
  worlds: []

cancel-on-move gobierna el movimiento que ve el servidor y las teclas de movimiento que recibe como su propio evento de entrada. Una tecla de movimiento leída directamente de la conexión termina el emote diga lo que diga — ver Hacer un emote.

camera

camera:
  enabled: true
  hide-body: true

Con la cámara desactivada el jugador sí puede caminar, que es para lo que está move-tolerance. El log de arranque lo avisa cuando la cámara está desactivada.

duet

duet:
  invite: 20s
  max-distance: 3.0

La distancia no decide dónde quedan los cuerpos: siempre se colocan en la línea entre los dos jugadores, a la distancia gap del propio emote. Ver Duetos.

menu

menu:
  tab-open: "{success}✔ You are here"
  tab-closed: "{warning}➥ Click to open"
  favourites-name: "Favourites"
  favourites-icon: "AMETHYST_SHARD"
  favourite-on: "{highlight}★ In your favourites"
  favourite-off: "{muted}☆ Not in your favourites"
  kind-solo: "Solo"
  kind-duet: "With a friend"

La pantalla en sí es menus/emotes.yml — ver El menú.

tiers

Las rarezas en que se ordenan los emotes, y con qué frecuencia sale cada una de una caja. Añade, renombra o borra cualquiera — la clave es el id que emotes.yml escribe como tier. Referencia completa 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.

crate

crate:
  enabled: true
  start-keys: 1
  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

key-item

Cómo se dibuja una llave de caja que se puede tener en la mano.

key-item:
  material: TRIPWIRE_HOOK
  name: "{primary}&lEMOTE KEY"
  lore:
    - "{secondary}Information:"
    - " {letters_black}▎ {letters}Right click the crate holding this"
    - " {letters_black}▎ {letters}to {highlight}open it {letters}once."
    - ""
    - "{secondary}Note:"
    - " {letters_black}▎ {letters}This one can be traded and dropped."
    - ""
    - "{warning}➥ Right click the crate to open"
    - ""
  glow: true

Una llave se reconoce por lo que lleva en sus datos, así que renombrarla o recolorearla no cambia nada para las llaves que ya están repartidas.

preview

Dónde se puede ver un emote sin hacerlo: /emote preview, y el clic derecho del menú.

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

Vacío significa sin escenario, y las previsualizaciones responden preview-unavailable. Dos jugadores pueden compartirlo a la vez: todos están ocultos para todos, y cada emote se envía a un solo jugador.

showcase

showcase:
  locations: []
  pause-seconds: 3.0
  radius: 24.0
  emotes: []

Ver Showcases.

feedback

feedback:
  on-play:
    sound:
      name: BLOCK_AMETHYST_BLOCK_CHIME
      pitch: 1.4
  on-cancel:
    sound:
      name: BLOCK_GRINDSTONE_USE
      pitch: 0.9
  on-invite:
    sound:
      name: BLOCK_NOTE_BLOCK_BELL
      pitch: 1.6

Estos y los tres bloques de la caja son bloques de efecto completos de ExyliaLib: título, action bar, boss bar, sonido, partícula y fuego artificial están disponibles en cada uno. Todos los incluidos son un solo sonido a volumen 1.0, en la categoría PLAYERS.

placeholders

placeholders:
  none: "None"
  unknown: "Unknown"

messages.yml

Cada línea que envía el plugin. prefix es {primary}&lEMOTES &8•&r y todos los demás mensajes empiezan por %prefix%.

Cada rechazo de un emote rellena %emote%, %id%, %player% y %time% los use o no la línea, así que cualquiera de ellos se puede añadir a cualquier línea de rechazo.