Elige cómo escogen los jugadores un efecto
Abre el menú de efectos, cambia al selector 3D y deja que los jugadores marquen favoritos, filtren, usen el aleatorio y compren efectos.
/hiteffect abre un menú donde los jugadores se ponen, previsualizan, marcan como favoritos y compran efectos de golpe. Puedes elegir entre una ventana de inventario y un selector 3D en el mundo.
Antes de empezar#
El menú solo abre si los jugadores pueden elegir efectos en él. Con behaviour.mode: weapon avisa de que está desactivado en vez de abrir: mira Modos y fichas. Los jugadores también necesitan un efecto que ponerse, mira Tu primer efecto de golpe.
Pasos#
Abre el menú
Ejecuta /hiteffect. Verás la ventana de inventario: las categorías a la izquierda y los efectos de la categoría abierta en la cuadrícula.
Ponte, previsualiza o marca un efecto
Clic izquierdo en un efecto para ponértelo (otro clic izquierdo para quitarlo). Clic derecho para previsualizarlo. Mayús + clic para marcarlo como favorito.
Prueba el selector 3D
Ejecuta /hiteffect 3d. Abre el selector 3D diga lo que diga el ajuste. /hiteffect classic abre la ventana de inventario.
Elige cuál se abre por defecto
En plugins/ExyliaHitEffect/config.yml pon menu.style en CLASSIC (el valor por defecto) o SPATIAL y ejecuta /hiteffectsadmin reload.
Comprueba que funciona#
Ejecuta /hiteffect, haz clic izquierdo en un efecto y golpea a un jugador o a un zombi: el efecto se ve en el cuerpo del golpeado. Con menu.style: SPATIAL, /hiteffect abre el selector 3D, y un jugador con un cliente anterior a 1.21.4 recibe la ventana de inventario.
Ir más allá#
El selector 3D#
El mismo catálogo dibujado en el mundo delante del jugador. Las categorías van arriba como pestañas, el efecto que se mira se nombra sobre un pedestal donde un maniquí recibe los golpes, y los efectos se colocan en arco alrededor.
| Pieza | Qué hace |
|---|---|
| El arco | Mira un efecto para leer sobre él, haz clic para probarlo en el maniquí. Probar no cuesta nada ni cambia nada todavía. |
| EQUIPAR | Pone el efecto probado en los golpes del jugador. En un efecto bloqueado que se vende dice COMPRAR, luego CONFIRMAR con el precio, y el segundo clic paga y lo equipa. |
| Los iconos | Favorito, quitar, deshacer, aleatorio, repetir, la caja, ayuda y salir. |
| Las pestañas | Filtran por categoría, con los favoritos (★) y todos los efectos a la vez. |
Sigue las mismas reglas que el menú de inventario, así que ambos nunca discrepan sobre lo que tiene el jugador. Sin exyliahiteffect.preview, hacer clic en un efecto lo elige igual, pero el maniquí no se mueve. Sin exyliahiteffect.favourites la pestaña ★ se niega en ambas pantallas. La primera vez se muestra una guía corta; el icono ? la repite, y /hiteffectsadmin spatial tour <jugador> se la repite a alguien.
Para dejar un selector en el mundo, párate donde debe ir y ejecuta /hiteffectsadmin spatial place. Mueve sus piezas con /hiteffectsadmin spatial edit. Mira Comandos.
El selector 3D necesita un cliente 1.21.4 o superior. Un jugador con un cliente más antiguo recibe el menú de inventario, sin nada que configurar.
¿Hay un estilo "pantalla"?#
No en el ajuste de este plugin: menu.style solo acepta CLASSIC y SPATIAL. ExyliaHitEffect sí incluye una versión a pantalla completa del menú de efectos (screens/effects.html), que el estilo de menú SCREEN de ExyliaLib dibuja para los jugadores cuyo cliente puede mostrar pantallas. Ese estilo se elige en ExyliaLib, no aquí: mira Pantallas y Menús. Si el archivo de la pantalla no se puede leer, se mantiene el menú de inventario.
Favoritos#
La primera pestaña es la lista corta del propio jugador. Marcar es gratis: no hace falta tener un efecto para marcarlo, así que si caduca un rango no se pierde la lista. Las estrellas se quedan en el orden en que se pusieron. Los favoritos bloqueados se dibujan igualmente en esta pestaña, aunque el servidor oculte los bloqueados en el resto. Para vaciarla, Mayús + clic en la pestaña abierta (pide confirmación) o /hiteffect favourites clear. Los jugadores necesitan exyliahiteffect.favourites.
Mostrar solo lo que tienen#
El botón Filtro (arriba de la ventana) alterna la cuadrícula entre todos los efectos y solo los que el jugador tiene. La elección se recuerda igual que la pestaña abierta. Para quitar los bloqueados de la cuadrícula a todos, pon behaviour.hide-without-permission: true (por defecto false); la pestaña de favoritos los sigue mostrando.
Efecto aleatorio#
El botón Efecto aleatorio hace que cada golpe use un efecto distinto, elegido entre los que el jugador tiene. Los jugadores necesitan exyliahiteffect.random.
Deja que compren efectos bloqueados#
Con shop.enabled activado y una economía instalada, un efecto bloqueado con precio muestra su precio y un clic izquierdo pide confirmación, cobra y lo desbloquea. Sin exyliahiteffect.buy el jugador ve el efecto bloqueado sin precio. Fija precios y monedas en Configuración; las economías están en Economía de ExyliaLib.
Cambia el aspecto del menú#
La ventana es plugins/ExyliaHitEffect/lang/<código>/menus/effects.yml: títulos, iconos y lore usan los colores de ExyliaLib, y los textos se traducen por idioma, mira Mensajes e idiomas. Tus cambios se conservan al actualizar. Las reglas generales de los archivos de menú están en Menús. El diseño 3D es spatial/effects.yml y sus textos están bajo spatial en messages.yml.
Detalles técnicos
Botones fijos: Tu efecto en el slot 3 (clic para quitártelo), Filtro en 4, Caja en 5, Visibilidad de partículas en 48, Cerrar en 49, Efecto aleatorio en 50. Las categorías están en los slots 9,18,27,36 (paginadas en 0 y 45), la cuadrícula en 11-16,20-25,29-34,38-43 (paginada en 47 y 52). Un efecto que el jugador usa porque se lo da su rango lleva menu.default-marker (mira behaviour.defaults en Configuración). Los efectos que puede usar se dibujan primero y luego los bloqueados. El menú redibuja las ventanas abiertas cuando cambia la fila del jugador (su clic, un comando, un admin o un rango caducado).
Además, no figuran en las tablas de abajo: los placeholders %effect_default%, %current_default% y %filter_status%, la plantilla none_owned_template (lo que muestra una pestaña cuando el filtro no deja nada) y la acción hiteffect:filter.
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_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. |
%effect_price% | grid | Por cuánto se vende, con su moneda. Vacío cuando no está a la venta. |
%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:buy <id> | Pide al jugador que confirme y compra un efecto bloqueado que la tienda vende. |
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 messages.yml, porque ningún
archivo de menú puede escribirlas fila por fila:
menu:
empty: '{muted}Nada'
tab-open: '{success}✔ Estás aquí'
tab-closed: '{info}{icon:click} Clic para abrir'
weapons-any: Cualquier arma
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 golpe 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'¿Falta algo en esta página? Dínoslo en Discord