El menú
Una pantalla: las pestañas, la rejilla, los favoritos y todas las plantillas de menus/effects.yml.
/hiteffect abre una sola ventana de 54 huecos. Nada de aquí toca un arma — un efecto llega a un
arma por su ficha, que es lo que un servidor vende.
Con behaviour.mode: weapon nada de esta pantalla se leería nunca, así que el menú responde
menu-disabled en vez de abrir una ventana que no cambia nada.
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 efectos de la categoría abierta, paginados en 47 y 52. |
Los botones fijos: YOUR EFFECT en el hueco 4 (clic para quitarse el efecto), EFFECT CRATE en
8, PARTICLE VISIBILITY en 48, RANDOM EFFECT en 49 y CLOSE en 50.
La pestaña de favoritos
La primera pestaña es siempre la lista del propio jugador — no es una categoría de effects.yml,
porque contiene efectos distintos para cada uno. 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 el efecto para marcarlo. Una estrella que desaparece el día que caduca un rango le quitaría al jugador la lista que armó. |
| Su orden, no el tuyo | Los marcados quedan en el orden en que se marcaron. No se reordena nada. |
| Los bloqueados se ven | En esta pestaña un efecto bloqueado se dibuja incluso en un servidor que los esconde en todas las demás. |
| Vaciarla | Shift clic en la pestaña mientras está abierta, o /hiteffect 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 falló al cargar.
La elección aleatoria
El botón del hueco 49 no es un efecto: dice "sorprendeme". Quien lo lleva lanza un efecto distinto en
cada golpe, sacado en el momento de entre los que tiene — nada se recuerda entre golpes, así que es una
sorpresa cada vez y no un orden barajado. Su línea es menu.random-on mientras es la elección que
lleva y menu.random-off mientras no lo es.
La caja
El botón del hueco 8 abre menus/crate.yml: una llave entra, un efecto sale, con las probabilidades
que dicta la rareza. Dibuja cuántas llaves tiene el jugador y cuánto del catálogo lleva abierto. Ver
La caja.
Qué hace un clic
| Clic | Sobre una fila de la rejilla |
|---|---|
| Izquierdo | Pone el efecto — o lo quita, si ya es el que lleva. |
| Derecho | Lo previsualiza: el jugador sube a un trozo de cielo vacío, el efecto se lanza solo para él y vuelve donde estaba. También se pueden previsualizar los bloqueados. |
| Shift | Lo marca o lo desmarca. |
Orden y filas bloqueadas
Primero se dibujan los efectos que el jugador puede usar y después los bloqueados — así lo que puede
usar nunca queda detrás de una página de filas que no. Con
behaviour.hide-without-permission: true los bloqueados desaparecen de la rejilla, salvo en la
pestaña de favoritos.
Plantillas
Cada lista elige una plantilla por fila. item_template es el estado normal y debe ir primera.
| Sección | Plantilla | Cuándo se usa |
|---|---|---|
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, con otra abierta. | |
favourites_open_template | La de favoritos mientras está abierta — la única que lleva la acción de vaciar la lista. | |
grid | item_template | Un efecto que el jugador tiene. |
selected_template | El efecto que lleva puesto. | |
locked_template | Un efecto que no tiene. | |
empty_template | En la pestaña de favoritos cuando no hay nada marcado. |
Placeholders
Son los tokens propios del menú, que se rellenan mientras se dibuja 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 visible de la pestaña. |
%category_material% | categories | El material con el que se dibuja su icono. |
%category_total% | categories | Cuántos efectos tiene la pestaña. |
%category_owned% | categories | Cuántos de esos tiene el jugador. |
%category_status% | categories | menu.tab-open o menu.tab-closed, según sea la pestaña que se está mirando. |
%effect_id% | grid | El id del efecto. |
%effect_name% | grid | Su nombre visible, con sus colores. |
%effect_material% | grid | El material con el que se dibuja. |
%effect_description% | grid | Su descripción de effects.yml. |
%effect_weapons% | grid | A qué se puede atar, en palabras. |
%effect_favourite% | grid | menu.favourite-on o menu.favourite-off, según esté marcado o no. |
%effect_tier% | grid | El nombre de la rareza, en el color de la rareza. |
%effect_tier_id% | grid | El id de la rareza. |
%effect_tier_color% | grid | Ese color por separado. |
%current_effect% | En cualquier sitio | El efecto que lleva puesto, menu.random-name en aleatorio, o menu.empty. |
%random_status% | En cualquier sitio | menu.random-on o menu.random-off. |
%favourites_count% | En cualquier sitio | Cuántos efectos tiene marcados. |
%keys% | En cualquier sitio | Llaves de caja que tiene. |
%unlocked_count% | En cualquier sitio | Cuántos efectos ganó en la caja. |
%catalogue_count% | En cualquier sitio | Cuántos efectos declara el servidor. |
%particle_visibility% | En cualquier sitio | El modo de visibilidad actual del jugador, con el nombre que diga particles.name-*. |
%visibility_all% | En cualquier sitio | El nombre del modo «todos», para un botón que lo ofrezca. |
%visibility_none% | En cualquier sitio | El nombre del modo «nadie». |
%visibility_self_only% | En cualquier sitio | El nombre del modo «solo yo». |
%visibility_others_only% | En cualquier sitio | El nombre del modo «solo los demás». |
Acciones
| Acción | Qué hace |
|---|---|
hiteffect:open | Abre la pantalla. |
hiteffect:category <id> | Cambia de pestaña. favourites es un id válido. |
hiteffect:choose <id> | Pone un efecto, o lo quita si ya lo lleva. |
hiteffect:clear | Quita el efecto. |
hiteffect:favourite <id> | Marca o desmarca. |
hiteffect:favourites_clear | Vacía la lista. |
hiteffect:preview <id> | Previsualiza un efecto y reabre el menú después. |
hiteffect:visibility | Avanza un paso en la visibilidad de quien mira. |
hiteffect:random | Activa la elección aleatoria. |
hiteffect:crate | Abre la caja. |
hiteffect:crate_open <cantidad> | Gasta esa cantidad de llaves y abre esa cantidad de carretes. |
Textos
Las pocas cadenas que una plantilla dibuja para todas las filas viven en config.yml, porque ningún
archivo puede escribirlas fila por fila:
menu:
empty: "{muted}Nothing"
tab-open: "{success}✔ You are here"
tab-closed: "{warning}➥ Click to open"
weapons-any: "Any weapon"
favourites-name: "Favourites"
favourites-icon: "AMETHYST_SHARD"
favourite-on: "{highlight}★ In your favourites"
favourite-off: "{muted}☆ Not in your favourites"
random-name: "{highlight}Random"
random-on: "{success}✔ Every hit is a surprise"
random-off: "{warning}➥ Click to surprise yourself"Cualquier forma en que la fila de un jugador puede cambiar — su propio clic, un comando, un admin o un rango que se le acabó — redibuja las ventanas que tenga abiertas. No hay que cerrar y reabrir nada.
¿Falta algo en esta página? Dínoslo en Discord