Configurar

El menú

Una pantalla: las pestañas, la cuadrícula, los favoritos y cada plantilla que declara menus/emotes.yml.

/emote abre una ventana de 54 huecos, menus/emotes.yml. Hacer clic en un emote es la actuación, no un ajuste: la ventana se cierra y el emote empieza donde está el jugador.

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: YOUR EMOTES en el hueco 3 (cuántos tiene y ha marcado, y cómo parar uno), EMOTE CRATE en el 5, CLOSE 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.

La pestaña de favoritos

La primera pestaña es siempre la lista corta del propio jugador. No es una categoría de emotes.yml, porque tiene emotes distintos para cada jugador; se nombra y se dibuja con menu.favourites-name y menu.favourites-icon de config.yml.

Regla	Detalle
Marcar es gratis	No hace falta tener un emote para marcarlo. Una lista corta es tanto lo que alguien está ahorrando para conseguir como lo que ya tiene.
Su orden, no el tuyo	Los emotes marcados se quedan en el orden en que se marcaron. No se reordena nada.
Las filas bloqueadas se ven	En esta pestaña un emote bloqueado se dibuja incluso en un servidor que oculta los bloqueados en todas las demás.
Vaciarla	Shift clic en la pestaña mientras está abierta, o `/emote favourites clear`.

Una lista vacía dibuja empty_template para que la pestaña se lea como vacía y no como una pantalla que no cargó.

Qué hace un clic

Clic	Emote individual que tiene	Dueto	Emote bloqueado
Izquierdo	Cierra la ventana y lo hace.	Nada — la fila dice que se use `/emote play <id> <jugador>`.	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 se ejecute /emotesadmin preview location responde preview-unavailable, y a un admin le dice qué comando lo fija.

Orden y filas bloqueadas

Primero se dibujan los emotes que el jugador tiene, luego los bloqueados — así lo que puede usar nunca queda detrás de una página de filas que no puede. Con behaviour.hide-without-permission: true los bloqueados desaparecen de la cuadrícula, salvo en la pestaña de favoritos. Con behaviour.require-permission: false no hay nada bloqueado.

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.
	`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.
`%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`	Vacía la lista corta.
`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 `menus/crate.yml`.

Textos

Las pocas cadenas que una plantilla dibuja en cada fila viven en config.yml:

config.yml

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 ventana sigue a la fila

Marcar 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