Contenido generado con IA — puede contener errores.

ExyliaHitEffect/GuíasActualizada en v1.6.1

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.

Página 6 de 219 min de lectura

/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.

PiezaQué hace
El arcoMira un efecto para leer sobre él, haz clic para probarlo en el maniquí. Probar no cuesta nada ni cambia nada todavía.
EQUIPARPone 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 iconosFavorito, quitar, deshacer, aleatorio, repetir, la caja, ayuda y salir.
Las pestañasFiltran 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.

Los clientes antiguos reciben el menú de inventario

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ónPlantillaCuándo se usa
categoriesitem_templateHay otra pestaña abierta.
open_templateEs la pestaña que se está mirando.
favourites_templateLa pestaña de favoritos, con otra abierta.
favourites_open_templateLa de favoritos mientras está abierta — la única que lleva la acción de vaciar la lista.
griditem_templateUn efecto que el jugador tiene.
selected_templateEl efecto que lleva puesto.
locked_templateUn efecto que no tiene.
purchasable_templateUn efecto que no tiene y que la tienda vende, mientras una economía pueda cobrar su precio.
empty_templateEn 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.

PlaceholderDóndeQué dibuja
%category_id%categoriesEl id de la pestaña — favourites en la de favoritos.
%category_name%categoriesEl nombre visible de la pestaña.
%category_material%categoriesEl material con el que se dibuja su icono.
%category_total%categoriesCuántos efectos tiene la pestaña.
%category_owned%categoriesCuántos de esos tiene el jugador.
%category_status%categoriesmenu.tab-open o menu.tab-closed, según sea la pestaña que se está mirando.
%effect_id%gridEl id del efecto.
%effect_name%gridSu nombre visible, con sus colores.
%effect_material%gridEl material con el que se dibuja.
%effect_description%gridSu descripción de effects.yml.
%effect_weapons%gridA qué se puede atar, en palabras.
%effect_favourite%gridmenu.favourite-on o menu.favourite-off, según esté marcado o no.
%effect_tier%gridEl nombre de la rareza, en el color de la rareza.
%effect_tier_id%gridEl id de la rareza.
%effect_tier_color%gridEse color por separado.
%effect_price%gridPor cuánto se vende, con su moneda. Vacío cuando no está a la venta.
%current_effect%En cualquier sitioEl efecto que lleva puesto, menu.random-name en aleatorio, o menu.empty.
%random_status%En cualquier sitiomenu.random-on o menu.random-off.
%favourites_count%En cualquier sitioCuántos efectos tiene marcados.
%keys%En cualquier sitioLlaves de caja que tiene.
%unlocked_count%En cualquier sitioCuántos efectos ganó en la caja.
%catalogue_count%En cualquier sitioCuántos efectos declara el servidor.
%particle_visibility%En cualquier sitioEl modo de visibilidad actual del jugador, con el nombre que diga particles.name-*.
%visibility_all%En cualquier sitioEl nombre del modo «todos», para un botón que lo ofrezca.
%visibility_none%En cualquier sitioEl nombre del modo «nadie».
%visibility_self_only%En cualquier sitioEl nombre del modo «solo yo».
%visibility_others_only%En cualquier sitioEl nombre del modo «solo los demás».

Acciones#

AcciónQué hace
hiteffect:openAbre 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:clearQuita el efecto.
hiteffect:favourite <id>Marca o desmarca.
hiteffect:favourites_clearVací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:visibilityAvanza un paso en la visibilidad de quien mira.
hiteffect:randomActiva la elección aleatoria.
hiteffect:crateAbre 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:

lang/es/messages.yml
yaml
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