Contenido generado con IA — puede contener errores.

ExyliaEmotes/GuíasActualizada en v1.4.1

Configura la caja

Vincula un bloque que abre la caja de emotes, da llaves, ajusta las probabilidades de cada rareza y vende emotes en la tienda.

Página 8 de 218 min de lectura
  

Al terminar tienes una caja que los jugadores abren con una llave para ganar emotes, suyos para siempre pase lo que pase con su rango. Se gasta una llave, cae un rodillo y lo que toca se desbloquea en la cuenta del jugador. El motor de la caja es de ExyliaLib; ExyliaEmotes le da el catálogo y lee sus ajustes de config.yml y sus textos de messages.yml.

Antes de empezar#

No hace falta nada más: la caja viene activada (crate.enabled: true) y cada jugador recibe una llave la primera vez que se le ve. Los rangos y el dinero están en Permisos y en la economía de ExyliaLib.

Pasos#

Vincula un bloque

Mira el bloque que quieras (a un máximo de seis bloques) y ejecuta /emotesadmin crate block add. Al hacer clic en él se abre la caja. También puedes abrir el panel de admin con /emotesadmin y usar Bloques de caja.

Da una llave

Ejecuta /emotesadmin keys give <jugador> 1 para añadir una llave a su cuenta (funciona sin estar conectado), o /emotesadmin item key <jugador> 1 para entregar una llave como objeto.

Ábrela

El jugador hace clic en el bloque, o ejecuta /emote crate, o hace clic en Caja en el menú de /emote. Elige Abrir 1 y cae el rodillo.

Comprueba que funciona#

Haz clic en el bloque vinculado con una llave en tu cuenta. Deberías ver la pantalla que pregunta cuántas abrir (Abrir 1), luego el rodillo cayendo y una línea en el chat como "Obtuviste Raro WAVE". Ejecuta /emote list para ver lo que ganaste. Un clic izquierdo en el bloque nunca gasta una llave.

Para ir más lejos#

Llaves en la cuenta o en la mano#

La caja acepta dos tipos de llave.

  • En la cuenta es un número en la fila de caja del jugador. No se puede tirar, duplicar ni perder por un inventario lleno. Una tienda, un plugin de votos o de recompensas las da desde la consola: emotesadmin keys give %player% 1. También keys take, keys set y keys check.
  • En la mano es un objeto (/emotesadmin item key <jugador> [1-64]), así que se puede vender, meter en un kit o regalar. Haz clic derecho en un bloque vinculado con una en la mano y se abre al momento: una llave, un rodillo, sin preguntar. Las llaves que no caben en el inventario esperan a la próxima vez que el jugador entre.

Cada jugador empieza con crate.start-keys llaves, una por defecto.

Cambia las probabilidades#

Cada emote tiene una rareza, y tiers en config.yml declara las rarezas. Las cuatro incluidas son Común (60), Raro (25), Épico (12) y Legendario (3). El catálogo incluido tiene 29 emotes comunes, 38 raros, 29 épicos y 11 legendarios. chance es un peso, no un porcentaje: los pesos 60/25/12/3 se comportan igual que 6/2.5/1.2/0.3, y borrar una rareza reparte sus probabilidades entre las demás. Puedes renombrarlas, borrar una o inventar mythic; un emote que nombra una rareza que ya no existe vuelve a la primera y pierde su color, nunca su existencia. Mira las claves de rareza en los detalles de abajo.

Duplicados#

Tocar algo ya desbloqueado devuelve llaves, crate.duplicate-refund de ellas (una por defecto), así que un duplicado es una tirada gratis. Un emote que el jugador solo tiene por permiso no es un duplicado: se desbloquea para siempre, así que sobrevive al rango que lo dio.

Abrirla en 3D#

Con crate.opening: SPATIAL, la pantalla de pregunta sigue igual pero la apertura es la escena de caja de ExyliaLib: una caja en el mundo, un rodillo que frena sobre el premio, la tapa que se abre, el premio con su rareza y si es nuevo o un duplicado, y luego el emote bailado sobre un pedestal con la skin del jugador. Tras la última caja salen ABRIR OTRA (mientras le quede una llave) y LISTO. Las probabilidades y el gasto de llaves son exactamente los mismos, agacharse salta al final, y los clientes anteriores a 1.21.4 reciben siempre los rodillos del inventario. Su aspecto es spatial/crate.yml.

La tienda#

Un emote bloqueado se puede comprar desde el menú. La fila muestra su precio, un clic izquierdo pide confirmar al jugador, y el menú vuelve con el emote desbloqueado, el mismo desbloqueo que escribe una caja.

config.yml
yaml
shop:
  enabled: true
  tier-prices:
    common: 500
    rare: 1500
    epic: 4000
    legendary: 10000

Un precio es un número (500, 2.5k) o {amount: 250, currency: gems}. Un emote de emotes.yml puede fijar su propio price, que gana al de su rareza. Una rareza que no está en tier-prices no se vende. El dinero lo cobra ExyliaEconomy o Vault; sin ninguno, o con la tienda apagada, los emotes bloqueados se ven como siempre.

Da emotes sin caja#

/emotesadmin unlocks grant <jugador> <emote> y /emotesadmin unlocks revoke <jugador> <emote> escriben el mismo desbloqueo que una caja, para un plugin de recompensas o un ticket de soporte. Las llaves y los desbloqueos son datos de la cuenta, así que un borrado de temporada los conserva salvo que se nombre @account. Para quitarle todo a un jugador, ejecuta /exylialib resetplayer <jugador> ExyliaEmotes @account, ver los comandos de ExyliaLib.

Permisos y desbloqueos son dos vías de entrada distintas

Un jugador puede hacer un emote que desbloqueó o uno que le da su rango. Vender una rareza como rango es una línea, exyliaemotes.tier.legendary, y es independiente de lo que haya abierto.

Detalles técnicos: ajustes, rarezas, bloques y la apertura

Ajustes#

yaml
crate:
  enabled: true
  start-keys: 1
  duplicate-refund: 1
  reward: UNLOCK
  blocks: []
  max-at-once: 4
  spin-frames: 34
  stagger-seconds: 2.0
ClavePor defectoQué hace
enabledtrueApagada, la caja lo dice en vez de abrirse.
start-keys1Llaves que recibe un jugador la primera vez que se le ve.
duplicate-refund1Llaves que se devuelven por algo ya tenido.
rewardUNLOCKUNLOCK, ITEM o BOTH. Un emote no tiene objeto que entregar, así que los tres desbloquean: una llave nunca compra nada.
blocks[]Los bloques que abren la caja. Vincúlalos en el juego, no a mano.
max-at-once4Cuántas cajas puede abrir un jugador de una vez. La pantalla admite siete.
spin-frames34Por cuántas caras pasa el primer rodillo antes de parar. Máximo 200, unos once segundos.
stagger-seconds2.0Cuánto después de parar un rodillo para el siguiente. 0 los para juntos.

on-spin, on-win y on-duplicate son bloques de efectos completos de ExyliaLib, ver Configuración. Las claves de la tienda son shop.enabled (por defecto true) y shop.tier-prices (500 / 1500 / 4000 / 10000).

Rarezas#

yaml
tiers:
  common:
    name: "Común"
    material: GRAY_DYE
    color: "{muted}"
    chance: 60.0
    priority: 1
  rare:
    name: "Raro"
    material: LIGHT_BLUE_DYE
    color: "{info}"
    chance: 25.0
    priority: 2
  epic:
    name: "Épico"
    material: PINK_DYE
    color: "{accent}"
    chance: 12.0
    priority: 3
  legendary:
    name: "Legendario"
    material: ORANGE_DYE
    color: "{highlight}"
    chance: 3.0
    priority: 4
ClaveQué hace
nameCómo la llaman los menús y los placeholders.
materialEl objeto con el que se dibuja la rareza.
colorEl color en que se escriben su nombre y sus emotes, ver Colores.
chanceCon qué frecuencia cae la caja en ella, relativa a las demás rarezas.
priorityDónde se sitúa en los menús; menor va antes.

La apertura en el inventario#

  1. Cuántas: lang/<código>/menus/crate.yml. Las opciones se dibujan hasta crate.max-at-once, con un máximo de siete, repartidas como lo estarán los rodillos. Una opción que el jugador no puede pagar muestra cuántas llaves le faltan.
  2. Caen los rodillos: lang/<código>/menus/crate_open.yml. Un rodillo por caja, cada uno termina crate.stagger-seconds después del anterior.
  3. Lo que pasó se queda: nada se borra cuando un rodillo para.
  4. Se paga cuando cada rodillo cae: las llaves se gastan y los premios se deciden antes del primer fotograma, y cada rodillo paga al parar con crate.on-win o crate.on-duplicate. Cerrar la ventana a mitad de caída no cuesta nada.
RechazoClave de mensaje
crate.enabled está apagadocrate-disabled
Faltan llavescrate-no-keys (%amount% es el coste, %keys% lo que tiene)
Su última apertura sigue cayendocrate-busy
El catálogo está vacíocrate-empty

crate-won nombra lo que salió (%emote% o %reward%) y su rareza (%tier%); crate-duplicate usa %refund%; rewards-claimed avisa cuando se entregan las llaves que esperaban.

Llave en objeto y bloques de caja#

La llave en objeto se dibuja con key-item de config.yml (material y brillo) y messages.yml (nombre y lore). Se reconoce por lo que lleva en sus datos, no por su nombre ni material. Las llaves en objeto creadas por versiones que tenían su propia caja siguen abriéndola.

Comandos de bloques de caja: /emotesadmin crate block add, remove, list y clear confirm. Los bloques se escriben en config.yml, no en el mundo, así que un bloque vinculado sobrevive a pegar una esquemática y a una restauración. Mientras está vinculado no se puede romper, explotar ni empujar, y al hacer clic en él ya no hace lo que haría su material.

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