Personaliza el menú
Cambia el nombre de los botones, oculta lo que los jugadores no tienen y entiende la pestaña de favoritos del menú de emotes.
Al terminar, la ventana de /emote se ve y se lee como quieres: tus propios nombres de botón, los emotes bloqueados ocultos o visibles, y la pestaña de favoritos explicada a tus jugadores. Este es el menú clásico de cofre (el que abre /emote con menu.style: CLASSIC, el valor por defecto, y el que abre siempre /emote classic). El mismo catálogo también puede estar de pie en el mundo: ver El selector 3D.
Antes de empezar#
Necesitas el plugin instalado y un emote concedido, ver Tu primer emote. Para colores y degradados en los nombres, ver Colores; para las carpetas de idioma, Mensajes e idiomas; y para cómo se construyen en general los menús de ExyliaLib, Menús.
Pasos#
Abre el archivo del menú
En plugins/ExyliaEmotes/lang/<código>/menus/, abre emotes.yml, donde <código> es el idioma de tu servidor (en, es). Contiene toda la ventana de 54 huecos.
Cambia un botón
Busca el botón, por ejemplo crate (se llama Caja en español, Crate en inglés), y edita su name: y su lore:. Funcionan las etiquetas de color como {highlight}.
Recarga
Ejecuta /emotesadmin reload. Vuelve a leer config.yml, messages.yml, emotes.yml y los menús.
Comprueba que funciona#
Ejecuta /emote. La ventana se abre con tus textos nuevos. Las pestañas van a la izquierda, los emotes en el centro y los botones Tus emotes (arriba, hueco 3), Filtro (hueco 4), Caja (hueco 5) y Cerrar (abajo). Si no cambia, mira en la consola si hay un error del menú y consulta Problemas comunes.
Para ir más lejos#
Qué hace un clic#
Un clic en la fila de un emote hace una cosa u otra según el clic y según lo que tenga el jugador.
| Clic | Emote que tiene | Dueto | Emote bloqueado |
|---|---|---|---|
| Izquierdo | Cierra la ventana y lo hace. | Nada: la fila dice que se use /emote play <id> <jugador>. | Lo compra, tras una confirmación, si tiene precio. Si no, nada. |
| Derecho | Lo previsualiza. | Lo previsualiza. | Lo previsualiza. |
| Shift | Lo marca o lo desmarca. | Lo marca o lo desmarca. | Lo marca o lo desmarca. |
Una previsualización reproduce el emote en el escenario de previsualización del servidor y vuelve a abrir el menú después. Hasta que ejecutes /emotesadmin preview location donde quieras el escenario, responde que la previsualización no está disponible.
Oculta los emotes que los jugadores no tienen#
Primero se dibujan los emotes que el jugador tiene, luego los bloqueados. En config.yml, behaviour.hide-without-permission: true quita los bloqueados de la cuadrícula, salvo en la pestaña de favoritos. behaviour.require-permission: false no bloquea nada, así que todos tienen todo. El botón Filtro también deja a cada jugador alternar una pestaña entre todos los emotes y solo los suyos.
La pestaña de favoritos#
La primera pestaña es la lista corta de cada jugador. Marcar es gratis y no hace falta tener el emote, así que sirve también de lista de deseos. Los emotes se quedan en el orden en que se marcaron, y los bloqueados se ven aquí aunque los ocultes en las demás. Para vaciarla, shift clic en la pestaña mientras está abierta (pide confirmación) o /emote favourites clear. Su nombre es menu.favourites-name de messages.yml y su icono, menu.favourites-icon de config.yml.
La pantalla nativa#
Donde se aplica el estilo de pantalla de ExyliaLib, /emote, la caja y los rodillos se abren como una sola pantalla nativa (screens/emotes.html, screens/theme.css) en lugar del cofre. Tus propias reglas van en custom.css y los textos se cambian en lang/<código>/screens/emotes.yml. Si un archivo de pantalla no se puede leer, se mantiene el menú de cofre. /exylialib screens check lista lo que falla.
Una estrella, una llave entregada o un desbloqueo de un admin redibuja la pantalla de emotes si el jugador la tiene abierta.
Detalles técnicos: secciones, plantillas, placeholders, acciones, textos
Las dos listas#
| Sección | Huecos | Qué contiene |
|---|---|---|
categories | 9,18,27,36 | Las pestañas a la izquierda, paginadas con los botones de los huecos 0 y 45. |
grid | 11-16,20-25,29-34,38-43 | Los emotes de la pestaña abierta, paginados en los huecos 47 y 52. |
Los botones fijos: Tus emotes en el hueco 3 (cuántos tiene y ha marcado, y cómo parar uno),
Caja en el 5, Filtro en el 4, Cerrar en el 49.
El menú se abre en la pestaña en la que el jugador lo dejó, o en la primera si esa ya no existe. Solo se dibuja pestaña para una categoría que tenga al menos un emote.
Plantillas#
Cada lista elige una plantilla por fila. item_template es el estado normal y tiene que ir primero.
| Sección | Plantilla | Se usa cuando |
|---|---|---|
categories | item_template | Hay otra pestaña abierta. |
open_template | Es la pestaña que se está mirando. | |
favourites_template | La pestaña de favoritos, mientras hay otra abierta. | |
favourites_open_template | La pestaña de favoritos mientras está abierta — la única con la acción de vaciar la lista. | |
grid | item_template | Un emote individual que el jugador tiene. |
duet_template | Un dueto que el jugador tiene. No tiene acción de clic izquierdo: una fila no tiene a quién nombrar. | |
locked_template | Un emote que no tiene. | |
purchasable_template | Un emote que no tiene y que vende la tienda. Dibuja %price% y lo compra con clic izquierdo. | |
empty_template | Se dibuja en la pestaña de favoritos cuando no hay nada marcado. |
Placeholders#
Son los tokens propios del menú, que se rellenan al dibujar la pantalla. No son placeholders de PlaceholderAPI y solo funcionan dentro de este archivo.
| Placeholder | Dónde | Qué dibuja |
|---|---|---|
%category_id% | categories | El id de la pestaña — favourites en la de favoritos. |
%category_name% | categories | El nombre de la pestaña. |
%category_material% | categories | El material con que se dibuja su icono. |
%category_total% | categories | Cuántos emotes tiene la pestaña; en favoritos, cuántos hay marcados. |
%category_owned% | categories | Cuántos de ellos tiene el jugador. |
%category_status% | categories | menu.tab-open o menu.tab-closed. |
%emote_id% | grid | El id del emote. |
%emote_name% | grid | Su nombre, con sus colores. |
%emote_material% | grid | El material con que se dibuja. |
%emote_description% | grid | Su descripción de emotes.yml. |
%emote_kind% | grid | menu.kind-solo o menu.kind-duet. |
%emote_favourite% | grid | menu.favourite-on o menu.favourite-off. |
%emote_tier% | grid | El nombre de la rareza, en su color. |
%emote_tier_id% | grid | El id de la rareza. |
%emote_tier_color% | grid | Ese color solo. |
%price% | purchasable_template | Lo que cuesta el emote. |
%favourites_count% | En cualquier sitio | Cuántos emotes tiene marcados. |
%owned_count% | En cualquier sitio | Cuántos emotes puede hacer, por permiso o desbloqueo. |
%keys% | En cualquier sitio | Las llaves de caja que tiene. |
%unlocked_count% | En cualquier sitio | Cuántos emotes ha ganado en la caja. |
%catalogue_count% | En cualquier sitio | Cuántos emotes declara el servidor. |
Acciones#
| Acción | Qué hace |
|---|---|
emote:open | Abre la pantalla. |
emote:category <id> | Cambia de pestaña. favourites es un id válido. |
emote:play <id> | Cierra la ventana y hace el emote. Un dueto responde needs-partner. |
emote:favourite <id> | Marca o desmarca. |
emote:favourites_clear | Pide confirmación y luego vacía la lista corta. |
emote:buy <id> | Pide al jugador que confirme, cobra el precio y desbloquea el emote. |
emote:preview <id> | Previsualiza un emote y vuelve a abrir el menú después. |
emote:crate | Abre la caja. |
emote:crate_open <cantidad> | Gasta esa cantidad de llaves y suelta esa cantidad de rodillos. La usa lang/<código>/menus/crate.yml. |
Textos#
Las pocas cadenas que una plantilla dibuja en cada fila viven en messages.yml, así que cada idioma tiene las suyas:
menu:
tab-open: '{success}✔ Estás aquí'
tab-closed: '{info}{icon:click} Clic para abrir'
favourites-name: Favoritos
favourite-on: '{highlight}★ En tus favoritos'
favourite-off: '{muted}☆ No está en tus favoritos'
kind-solo: En solitario
kind-duet: Con un amigoMarcar un favorito, recibir una llave, un desbloqueo concedido por un admin — cada cambio en los favoritos, las llaves o los desbloqueos de un jugador redibuja la pantalla de emotes si la tiene abierta.
¿Falta algo en esta página? Dínoslo en Discord