Personaliza el menú
Cambia el menú clásico de /arrows: pestañas, cuadrícula, botones y favoritos, en menus/effects.yml.
/arrows abre una ventana de 54 huecos titulada ESTELAS DE FLECHA: pestañas de categoría a la izquierda, los efectos de la pestaña abierta en una cuadrícula y botones arriba y abajo. Al terminar esta página sabrás qué hace cada botón y cómo cambiar la disposición, ocultar los efectos bloqueados o venderlos.
Este es el menú clásico, el que abre /arrows mientras menu.style es CLASSIC (el de por defecto). Con SPATIAL abre en su lugar el selector 3D, y un jugador con un cliente anterior a 1.21.4 sigue recibiendo esta pantalla.
Con behaviour.mode: bow nada de esta pantalla se leería nunca, así que el menú avisa de que está desactivado en vez de abrir una ventana que no cambia nada. Mira Ata efectos a arcos.
Qué ven los jugadores#
- Pestañas. La primera pestaña es siempre la de Favoritos del jugador, y después una por categoría.
- Cuadrícula. Los efectos de la pestaña abierta. Primero los que el jugador puede usar y después los bloqueados.
- Fila de arriba. Tu efecto (clic para quitar el efecto), Filtro (alterna entre todos los efectos y solo los que el jugador tiene) y Caja (abre la caja).
- Fila de abajo. Visibilidad de partículas (recorre a quién ve), Cerrar y Efecto aleatorio (cada disparo suena con un efecto distinto de los que tiene).
| Clic sobre un efecto | Qué hace |
|---|---|
| Izquierdo | Pone el efecto, o lo quita si ya lo lleva. En un efecto bloqueado a la venta, lo compra. |
| Derecho | Lo previsualiza: el jugador va al escenario de vistas previas, el efecto suena solo para él y vuelve donde estaba. También se pueden previsualizar los bloqueados. |
| Shift | Lo marca como favorito o le quita la marca. |
Antes de empezar#
Fija el escenario de vistas previas con /arrowsadmin preview location, o el clic derecho dirá que las vistas previas no están configuradas. Mira Tu primer efecto.
Pasos#
Abre el archivo del menú
Abre plugins/ExyliaArrows/lang/<código>/menus/effects.yml, donde <código> es el language de tu config.yml. El archivo es tuyo para cambiarle el estilo.
Cambia lo que quieras
Edita títulos, iconos, los nombres de los botones o los huecos de las listas de abajo. Cada botón es una entrada con un slot, un material, un nombre y acciones.
Recarga
Ejecuta /arrowsadmin reload y después /arrows.
Comprueba que funciona#
Abre /arrows. Tu cambio se ve en pantalla. Si una entrada está mal, la consola dice cuál. Una versión nueva solo añade lo que le falta a tu archivo; cuando tiene que cambiar la disposición sube menu-version al principio del archivo, lo sustituye y guarda el tuyo anterior al lado.
Ir más lejos#
Oculta los efectos bloqueados#
Pon behaviour.hide-without-permission: true en config.yml. Los efectos bloqueados desaparecen de la cuadrícula, salvo en la pestaña de favoritos.
Vende los efectos bloqueados#
Con shop.enabled activo y un plugin de economía instalado, un efecto bloqueado que tiene precio se dibuja con su precio. Un clic izquierdo pide confirmación al jugador, le cobra y lo desbloquea para siempre, y el menú vuelve con la fila ya suya. Quien no tenga exyliarrows.buy ve la fila bloqueada, sin precio. Los precios se ponen en Configuración; mira también Configura la caja y la tienda.
Favoritos#
La pestaña de favoritos es la lista corta del jugador, dibujada con menu.favourites-icon en config.yml y llamada menu.favourites-name en messages.yml.
- Marcar es gratis: no hace falta tener un efecto para marcarlo, así que una marca no desaparece el día que caduca un rango.
- Los efectos se quedan en el orden en que se marcaron.
- Un efecto bloqueado se dibuja en esta pestaña aunque el servidor oculte los bloqueados en el resto.
- Un jugador vacía la lista con Shift + clic en la pestaña abierta (pide confirmar antes) o con
/arrows favourites clear.
Cambia los textos#
Las pocas cadenas que una plantilla dibuja para todas las filas viven en messages.yml, bajo menu:
menu:
empty: "{muted}Nada"
tab-open: "{success}✔ Estás aquí"
tab-closed: "{info}{icon:click} Clic para abrir"
bows-any: "Cualquier arco"
favourites-name: "Favoritos"
favourite-on: "{highlight}★ En tus favoritos"
favourite-off: "{muted}☆ No está en tus favoritos"
random-name: "{highlight}Aleatorio"
random-on: "{success}✔ Cada disparo es una sorpresa"
random-off: "{accent}{icon:click} Clic para sorprenderte"
default-marker: "{muted}Predeterminado de tu rango"
filter-all: "{info}Todos los efectos"
filter-owned: "{success}Solo los que tienes"Los colores y los mensajes funcionan como en el resto de Exylia, mira Colores y Mensajes e idiomas.
Cualquier forma en que puede cambiar la elección de un jugador (su propio clic, un comando, un admin o un rango que se acabó) redibuja las ventanas que tenga abiertas. No hay que cerrar y reabrir nada.
Huecos, plantillas, placeholders y acciones
| 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. |
Botones fijos: Tu efecto en el hueco 3, Filtro en 4, Caja en 5, Visibilidad de partículas en 48, Cerrar en 49, Efecto aleatorio en 50. none_owned_template es lo que muestra una pestaña cuando el filtro la deja vacía, y empty_template se dibuja en la pestaña de favoritos cuando no hay nada marcado. El botón Caja abre menus/crate.yml.
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. | |
purchasable_template | Un efecto que no tiene y que la tienda vende, mientras una economía pueda cobrar su precio. | |
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_bows% | grid | A qué se puede atar, en palabras. |
%effect_tier_id% | grid | El id de su rareza. |
%effect_tier% | grid | El nombre de la rareza, en el color de la rareza. |
%effect_tier_color% | grid | Ese color por separado. |
%price% | purchasable_template | Lo que cuesta, con su moneda. |
%effect_favourite% | grid | menu.favourite-on o menu.favourite-off, según esté marcado o no. |
%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 desbloqueó, en la caja o en la tienda. |
%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-* en messages.yml. |
%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 |
|---|---|
arrows:open | Abre la pantalla. |
arrows:category <id> | Cambia de pestaña. favourites es un id válido. |
arrows:choose <id> | Pone un efecto, o lo quita si ya lo lleva. |
arrows:clear | Quita el efecto. |
arrows:random | Activa la elección aleatoria, o la quita si ya está activa. |
arrows:favourite <id> | Marca o desmarca. |
arrows:favourites_clear | Vacía la lista. |
arrows:preview <id> | Previsualiza un efecto y reabre el menú después. |
arrows:visibility | Avanza un paso en la visibilidad de quien mira. |
arrows:buy <id> | Pide confirmación al jugador y compra un efecto bloqueado que la tienda vende. |
Un efecto que suena solo porque lo da el rango del jugador (behaviour.defaults) se dibuja como el
puesto, con la marca menu.default-marker, y nunca como bloqueado o a la venta. Al hacer clic se quita.
Donde el estilo de menú del servidor es SCREEN (el screens.yml de ExyliaLib), /arrows abre el mismo
selector como pantalla nativa (screens/effects.html, junto con la caja y sus carretes) con una ventana
en vivo que lanza la estela bajo el cursor. Si la pantalla no carga, se abre este menú de cofre.
¿Falta algo en esta página? Dínoslo en Discord