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.
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énkeys take,keys setykeys 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.
shop:
enabled: true
tier-prices:
common: 500
rare: 1500
epic: 4000
legendary: 10000Un 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.
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#
crate:
enabled: true
start-keys: 1
duplicate-refund: 1
reward: UNLOCK
blocks: []
max-at-once: 4
spin-frames: 34
stagger-seconds: 2.0| Clave | Por defecto | Qué hace |
|---|---|---|
enabled | true | Apagada, la caja lo dice en vez de abrirse. |
start-keys | 1 | Llaves que recibe un jugador la primera vez que se le ve. |
duplicate-refund | 1 | Llaves que se devuelven por algo ya tenido. |
reward | UNLOCK | UNLOCK, 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-once | 4 | Cuántas cajas puede abrir un jugador de una vez. La pantalla admite siete. |
spin-frames | 34 | Por cuántas caras pasa el primer rodillo antes de parar. Máximo 200, unos once segundos. |
stagger-seconds | 2.0 | Cuá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#
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| Clave | Qué hace |
|---|---|
name | Cómo la llaman los menús y los placeholders. |
material | El objeto con el que se dibuja la rareza. |
color | El color en que se escriben su nombre y sus emotes, ver Colores. |
chance | Con qué frecuencia cae la caja en ella, relativa a las demás rarezas. |
priority | Dónde se sitúa en los menús; menor va antes. |
La apertura en el inventario#
- Cuántas:
lang/<código>/menus/crate.yml. Las opciones se dibujan hastacrate.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. - Caen los rodillos:
lang/<código>/menus/crate_open.yml. Un rodillo por caja, cada uno terminacrate.stagger-secondsdespués del anterior. - Lo que pasó se queda: nada se borra cuando un rodillo para.
- 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-winocrate.on-duplicate. Cerrar la ventana a mitad de caída no cuesta nada.
| Rechazo | Clave de mensaje |
|---|---|
crate.enabled está apagado | crate-disabled |
| Faltan llaves | crate-no-keys (%amount% es el coste, %keys% lo que tiene) |
| Su última apertura sigue cayendo | crate-busy |
| El catálogo está vacío | crate-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