Contenido generado con IA — puede contener errores.

ExyliaEmotes/ReferenciaActualizada en v1.5.0

Configuración

Cada bloque de config.yml y cada línea de messages.yml, con sus valores por defecto.

Página 14 de 2116 min de lectura
            

Casi todo lo que cambias en ExyliaEmotes son unas pocas líneas de config.yml. Esta página dice dónde está cada archivo, cómo aplicar un cambio y después lista todas las claves con su valor por defecto.

Dónde están los archivos#

Todo está en plugins/ExyliaEmotes/:

  • config.yml: los ajustes de esta página.
  • lang/<código>/messages.yml: cada línea que envía el plugin. Colores y placeholders: Colores, Mensajes e idiomas.
  • lang/<código>/emotes.yml: el catálogo de emotes, uno por idioma. Ver Emotes.
  • lang/<código>/menus/ y lang/<código>/screens/: los menús, ver El menú y Editar menús.
  • spatial/emotes.yml: el diseño del selector 3D.

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.

Aplicar un cambio#

Edita el archivo y ejecuta /emotesadmin reload. También puedes cambiar config.yml en el juego, desde el botón Ajustes del panel de /emotesadmin, o desde el navegador con el editor web de ExyliaLib. ownership necesita reiniciar.

Lo que más se cambia#

  • Cooldown entre emotes: behaviour.cooldown (por defecto 3s).
  • Que caminar no termine un emote: behaviour.cancel-on-move.
  • Limitar los emotes a ciertos mundos: behaviour.worlds.
  • Abrir el selector 3D en vez del menú de inventario: menu.style: SPATIAL.
  • Llaves, probabilidades y precios de la caja: crate.start-keys, tiers.*.chance, shop.tier-prices. Ver La caja.
  • Idioma: language, justo debajo.

Las claves completas van plegadas a continuación.

Todas las claves, valores y mensajes

language#

yaml
language: default

default sigue el language fijado en el propio config.yml de ExyliaLib, así que una línea ahí cambia todos los plugins de Exylia; en, es, pt, fr, ru o tr fijan solo este plugin. Cada idioma es una carpeta completa bajo lang/ que puedes editar. 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.

Los servidores que usaban 1.0 conservan sus cambios

En el primer arranque tras actualizar, el antiguo messages.yml y menus/ pasan a lang/custom/ y config.yml apunta a ellos con language: custom, así que no se pierde nada de lo que el servidor editó. Los textos del menú, el nombre y el lore del objeto llave y los valores de reserva de los placeholders que antes tenía config.yml pasan a messages.yml. Pon language en default o en un código para usar las traducciones incluidas.

behaviour#

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

yaml
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: []
ClavePor defectoQué hace
require-permissiontrueSi hacer un emote exige tenerlo. Solo /emotesadmin play se lo salta.
hide-without-permissionfalseSi un emote que el jugador no tiene se oculta en el menú en vez de mostrarse bloqueado.
cooldown3sCuánto tiene que esperar el mismo jugador para hacer cualquier otro emote. Escrito como 3s, 1m30s. 0s lo desactiva. Un rango puede esperar menos con exyliaemotes.cooldown.<segundos>.
cancel-on-movetrueSi caminar termina un emote.
move-tolerance0.6Cuánto puede desplazarse un jugador antes de que salte cancel-on-move, en bloques. Nunca menos de 0.05: un cliente envía pequeñas correcciones aunque esté quieto.
cancel-on-damagetrueSi recibir un golpe termina un emote, incluido otro jugador dando un puñetazo al cuerpo.
block-in-combattrueSi un emote se rechaza mientras el jugador está marcado en combate, por el plugin de combate con el que esté conectado ExyliaLib.
endless-limit5mLo máximo que dura un emote sin fin antes de terminar solo. Nunca menos de un segundo. Un rango puede bailar más con exyliaemotes.endless.<segundos>.
worlds[]Los mundos en los que se pueden hacer emotes, sin distinguir mayúsculas. Vacío significa todos.
Deja cancel-on-damage activado

Un jugador que hace un emote está congelado y no puede ver quién tiene al lado. El emote no le protege, así que lo mínimo que puede hacer es quitarse de en medio cuando empieza a doler.

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#

yaml
camera:
  enabled: true
  hide-body: true
ClavePor defectoQué hace
enabledtrueSi al jugador se le muestra su propio emote desde fuera. Desactivado, cada línea [CAMERA] se quita al compilar el catálogo: el emote se sigue reproduciendo para todos a su alrededor, él simplemente no lo ve.
hide-bodytrueSi el jugador real se oculta mientras su cuerpo hace el emote. Desactivado, el jugador y su cuerpo están en el mismo sitio a la vez.

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#

yaml
duet:
  invite: 20s
  max-distance: 3.0
ClavePor defectoQué hace
invite20sCuánto dura una invitación antes de caducar. Nunca menos de un segundo.
max-distance3.0A qué distancia pueden estar los dos jugadores, en bloques, tanto al invitar como al empezar.

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.

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.
styleCLASSICLo que abre /emote. CLASSIC: el menú de inventario. SPATIAL: el selector 3D, con su diseño en spatial/emotes.yml. /emote 3d y /emote classic abren uno u otro diga lo que diga esto.

Cómo llama el menú a las cosas está en messages.yml, bajo menu — ver más abajo. La pantalla en sí es lang/<código>/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.

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.

crate#

yaml
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
      volume: 0.7
      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
      volume: 0.7
      pitch: 0.8
  opening: INVENTORY
ClavePor defectoQué hace
enabledtrueDesactivada, la caja lo dice en vez de abrirse.
start-keys1Llaves que recibe un jugador la primera vez que se le ve.
duplicate-refund1Llaves devueltas por un emote ya desbloqueado.
rewardUNLOCKUNLOCK, ITEM o BOTH. Un emote no tiene objeto, así que los tres lo desbloquean.
blocks[]Los bloques que abren la caja, como server,world,x,y,z,yaw,pitch. Vincúlalos con /emotesadmin crate block add.
max-at-once4Cuántas cajas puede abrir un jugador de una vez, hasta siete.
spin-frames34Cuántas caras recorre el primer rodillo. Tope de 200, unos once segundos.
stagger-seconds2.0Cuánto después de parar un rodillo para el siguiente. 0 los para a la vez.
on-spinUna nota de hi-hatSe reproduce en cada tick en que un rodillo sigue cayendo.
on-winUn orbe de experienciaSe reproduce en el momento en que un rodillo para en algo nuevo, una vez por caja.
on-duplicateUna nota graveSe reproduce en su lugar cuando ese rodillo paró en algo ya desbloqueado.
openingINVENTORYCómo se muestra una apertura. INVENTORY: los rodillos caen por menus/crate_open.yml. SPATIAL: una caja en el mundo delante del jugador — ver La caja.

key-item#

Cómo se ve una llave de caja que se puede tener en la mano. Su nombre y su lore son key-item en messages.yml.

yaml
key-item:
  material: TRIPWIRE_HOOK
  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ú.

yaml
preview:
  location: ""
  distance: 5.0
  settle-ticks: 4
  linger-ticks: 20
  max-ticks: 600
ClavePor defectoQué hace
locationVacíoDónde está el jugador mientras se reproduce una previsualización. Se fija con /emotesadmin preview location. Solo se usa la posición: una previsualización siempre mira al norte.
distance5.0A cuántos bloques delante del jugador se reproduce el emote. Nunca menos de 1.
settle-ticks4Cuánto esperar tras el teletransporte antes de reproducir. También lee una duración escrita: 1s, 500ms.
linger-ticks20Cuánto se mantiene el escenario tras terminar el emote.
max-ticks600Lo máximo que puede durar una previsualización, pase lo que pase.

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#

yaml
showcase:
  locations: []
  pause-seconds: 3.0
  radius: 24.0
  emotes: []
ClavePor defectoQué hace
locations[]Dónde se reproducen emotes en bucle. Se fijan con /emotesadmin showcase add.
pause-seconds3.0El descanso entre que termina un emote y empieza el siguiente.
radius24.0A qué distancia tiene que estar un jugador para que un showcase se reproduzca y lo vea, en bloques.
emotes[]Los ids de los que elige un showcase. Vacío elige de todos. Los duetos nunca se eligen.

Ver Showcases.

feedback#

yaml
feedback:
  on-play:
    sound:
      name: BLOCK_AMETHYST_BLOCK_CHIME
      volume: 0.7
      pitch: 1.4
  on-cancel:
    sound:
      name: ITEM_BUNDLE_REMOVE_ONE
      volume: 0.7
      pitch: 0.8
  on-invite:
    sound:
      name: BLOCK_NOTE_BLOCK_BELL
      volume: 0.7
      pitch: 1.6
ClaveSe reproduce
on-playPara el jugador en el momento en que empieza su emote — para los dos, en un dueto.
on-cancelPara quienes lo hacían cuando un emote termina antes de tiempo. No cuando llega al final.
on-invitePara quien es invitado a un dueto.

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 corto a volumen 0.7, en la categoría PLAYERS, que oye el jugador al que va dirigido.

Sonidos más bajos al actualizar

Actualizar desde 1.3 reescribe un sonido que sigue exactamente como venía (mismo nombre, volumen 1.0) al nuevo valor por defecto: volumen 0.7, el level-up de on-win pasa a ser un orbe de experiencia y la piedra de afilar de on-cancel un saco. Un sonido que el servidor eligió o ajustó se deja como está.

shop#

Un emote bloqueado se puede comprar desde el menú. Ver La caja.

yaml
shop:
  enabled: true
  tier-prices:
    common: 500
    rare: 1500
    epic: 4000
    legendary: 10000
ClavePor defectoQué hace
enabledtrueSi un emote bloqueado con precio se puede comprar desde el menú.
tier-prices500 / 1500 / 4000 / 10000Lo que cuesta un emote según su rareza, en la moneda por defecto, cuando no fija un price propio. Una rareza que no aparece no está a la venta. Un precio es un número (500, 2.5k) o {amount: 500, currency: gems} para otra moneda.

ownership#

Dónde cuenta lo que un jugador desbloquea aquí, para redes con varios servidores. Reinicia el servidor para aplicar un cambio. Nuevo en v1.5.0

yaml
ownership:
  scope: global
  global-currencies: []
ClavePor defectoQué hace
scopeglobalglobal: un desbloqueo cuenta en todos los servidores. server: solo en este. default: los servidores del grupo de red de este servidor. O escribe el nombre de un grupo. Lo desbloqueado globalmente siempre cuenta.
global-currenciesningunaMonedas cuyas compras cuentan en todos los servidores, sea cual sea el scope.

Un servidor solo puede ignorar esto.

messages.yml#

lang/<código>/messages.yml. Cada línea que envía el plugin. prefix es {primary}&lEMOTES {letters_black}•<reset> y todos los demás mensajes empiezan por %prefix%.

ClaveSe envía cuandoPlaceholders
playingEmpezó un emote.%emote%, %id%, %player%
unknown-emoteEl id no nombra nada, o el emote no reproduce nada.%emote%, %id%
no-permissionEl jugador no lo tiene.%emote%, %id%
on-cooldownCorre un cooldown.%emote%, %time%
already-playingEstá haciendo uno.
in-combatEstá marcado en combate.
wrong-worldLos emotes están desactivados en su mundo.
needs-partnerSe pidió un dueto sin nombrar a nadie.%emote%, %id%
invite-sentA quien invita.%player%, %emote%
invite-receivedAl invitado, con los botones Accept y Decline.%player%, %emote%
invite-expiredLa invitación caducó, o quien invitó se fue.
invite-declinedA quien invitó, cuando se rechazó.%player%
invite-noneAceptar o rechazar sin nada pendiente.
invite-selfInvitarse a uno mismo.
partner-too-farLa pareja está demasiado lejos, o en otro mundo.%player%
partner-busyLa pareja está haciendo algo, o se fue.%player%
partner-cannotLa pareja no puede hacerlo, por cualquier motivo.%player%
list-header / list-entry / list-empty/emote list.%id%, %emote%
favourite-added / favourite-removedMarcar y desmarcar.%emote%
favourites-cleared / favourites-emptyVaciar la lista corta, o encontrarla ya vacía.
crate-won / crate-duplicateUn rodillo cayó en algo nuevo, o ya desbloqueado.%emote%, %tier%, %refund%
crate-no-keysNo hay suficientes llaves.%amount%, %keys%
crate-busy / crate-empty / crate-disabledLa caja se negó a abrirse.
given-keyA un jugador que recibe llaves en forma de objeto.%amount%
rewards-claimedAl entrar, cuando le esperaban llaves en forma de objeto.%amount%
keys-received / keys-takenA un jugador cuyas llaves de la cuenta cambiaron.%amount%
keys-givenAl admin, tras cualquier subcomando keys.%player%, %amount%
unlock-granted / unlock-already / unlock-revokedSubcomandos unlocks.%emote%, %player%
crate-block-added / crate-block-removedSe vinculó o desvinculó un bloque.%location%
crate-block-already / crate-block-missingYa lo estaba, o nunca lo estuvo.
crate-block-noneNo se está mirando ningún bloque a menos de seis bloques.
crate-blocks-header / crate-blocks-entry / crate-blocks-emptycrate block list.%location%
crate-blocks-clearedcrate block clear.%amount%
preview-location-setSe movió el escenario de previsualización.%location%
preview-unavailable / preview-unavailable-adminSe pidió una previsualización antes de fijar un escenario; la segunda solo a admins.
showcase-added / showcase-removedSe puso o se quitó un showcase.%location%
showcase-missingNo hay ningún showcase a menos de cinco bloques.
showcases-header / showcases-entry / showcases-emptyshowcase list.%location%
showcases-clearedshowcase clear.%amount%
favourites-clear-promptLa confirmación que se pide antes de que el menú vacíe la lista.
confirm-crate-blocks-clear / confirm-showcases-clearUn clear escrito sin confirm: lo que quitaría.%command%

El mismo archivo guarda los textos que una plantilla dibuja en cada fila, el nombre y el lore del objeto llave, y lo que responden los placeholders cuando no tienen nada que decir:

yaml
menu:
  tab-open: "{success}✔ You are here"
  tab-closed: "{warning}➥ Click to open"
  favourites-name: "Favourites"
  favourite-on: "{highlight}★ In your favourites"
  favourite-off: "{muted}☆ Not in your favourites"
  kind-solo: "Solo"
  kind-duet: "With a friend"
  emoting-now: "Emoting now"
key-item:
  name: "{primary}&lEMOTE KEY"
  lore: [...]
placeholders:
  none: "None"
  unknown: "Unknown"
spatial:
  catalog: { ... }
ClaveQué es
menu.tab-open / menu.tab-closed%category_status% en la pestaña que se está mirando, y en las demás.
menu.favourites-nameCómo se llama la pestaña de favoritos.
menu.favourite-on / menu.favourite-off%emote_favourite% para un emote marcado y uno sin marcar.
menu.kind-solo / menu.kind-duet%emote_kind% para un emote de un jugador y uno de dos.
menu.emoting-nowCómo llama el panel de administración al número de jugadores que hacen un emote ahora mismo.
key-item.name / key-item.loreCómo se llama y se describe una llave en la mano.
placeholders.noneUn placeholder de jugador pedido sin jugador, y playing_id / playing_name cuando no se está haciendo nada.
placeholders.unknownUn placeholder emote_<id>_<campo> que nombra un emote o un campo que no existe.

spatial tiene lo que dice el selector 3D: spatial.catalog son sus botones, líneas de ayuda y textos de la visita, y spot-placed, spot-removed, spot-missing y tour-reset responden a los comandos /emotesadmin spatial. spatial.about-line ({letters_black}%line%) es una línea de la descripción del escenario central, %emote_about_1% a %emote_about_3%, con el texto ya cortado en %line%. De header-title a nothing-selected rellenan los placeholders que dibujaba el diseño anterior a la 1.4.0; el diseño incluido ya no los usa, y siguen para un servidor cuyo propio spatial/emotes.yml aún los use.

Tres claves nunca se envían

cancelled, camera-unavailable y refreshed están en el archivo pero nada las envía: un emote cortado lo dice con el sonido on-cancel, y /emotesadmin reload informa con la línea de recarga propia de ExyliaLib.

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.

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