Contenido generado con IA — puede contener errores.

Instalación

Suelta dos jars, arranca el servidor y tendrás un menú funcionando. Los archivos que escribe y las tablas que usa.

Página 2 de 215 min de lectura

Dos jars y un reinicio dejan /hiteffect funcionando con 90 efectos. Solo falta que los jugadores tengan uno.

Antes de empezar#

Necesitas Paper 1.21.1 o superior (Folia 1.21.4 o superior) y el jar de packetevents. La lista completa está en Introducción.

Instálalo#

Suelta los jars

ExyliaHitEffect.jar y packetevents en plugins/. ExyliaLib es depend suave — el loader la instala en el primer arranque si no está.

Arranca el servidor

Escribe config.yml, effects.yml, database.yml y las carpetas de lang/ con los menús y los mensajes en inglés, español, portugués, francés, ruso y turco, y crea sus tablas.

Da los permisos

El menú, las previsualizaciones, los favoritos, el aleatorio, la visibilidad, la tienda y la caja vienen abiertos para todos; lo que aún falta es que los jugadores tengan al menos un efecto, por un rango, la caja o la tienda. Ver Permisos.

Comprueba que funciona#

  1. La consola no muestra errores de ExyliaHitEffect y plugins/ExyliaHitEffect/ ya tiene config.yml, database.yml y una carpeta lang/.
  2. En el juego, /hiteffect abre el menú.
  3. Dale a alguien un efecto (un permiso de rango o una llave de caja) y golpea a un mob: el efecto suena sobre él. El recorrido completo es Tu primer efecto de golpe.

Ir más lejos#

Editar en el juego#

Cada ajuste de config.yml se puede cambiar desde un menú: el botón SETTINGS del panel de admin (/hiteffectsadmin) abre las pantallas de ajustes de ExyliaLib para este plugin. effects.yml se ofrece ahí también, y en el navegador con el editor web de ExyliaLib (/exylialib editor ExyliaHitEffect). En el juego basta con exyliahiteffect.admin; el editor web pide además exylialib.editor de ExyliaLib (op por defecto) para el catálogo. Una edición del catálogo se comprueba antes con el propio cargador del plugin: un cambio que le costaría al archivo una categoría o un efecto se rechaza entero, y una vez aplicado los efectos, la caja, los showcases y cualquier selector 3D abierto lo recogen sin reload.

Actualizar#

Reemplaza el jar y reinicia. /hiteffectsadmin reload relee config.yml, effects.yml, los mensajes, los menús y la disposición del selector 3D sin tocar el resto del servidor — a propósito no recarga la librería, que es para lo que está /exylialib reload.

Archivos que escribe
ArchivoContenido
config.ymlEl idioma, el comportamiento, los materiales de los objetos, la caja, la tienda, los showcases, el feedback y la visibilidad.
lang/<code>/effects.ymlLas seis categorías y los 90 efectos. Escrito a mano, sin esquema: tus comentarios y tu formato sobreviven a un reload.
lang/<code>/messages.ymlTodos los mensajes, más los nombres y el lore de los objetos, las líneas del arma y los textos del menú.
lang/<code>/menus/effects.ymlLa pantalla: pestañas, rejilla, plantillas y botones.
lang/<code>/screens/effects.ymlLas palabras de la pantalla que dibuja el estilo de menú en pantalla. El diseño está en screens/effects.html y screens/theme.css.
lang/<code>/menus/crate.ymlLa primera pantalla de la caja: cuántas abrir a la vez.
lang/<code>/menus/crate_open.ymlLos rodillos cayendo, una columna por caja.
spatial/effects.ymlDónde está cada pieza del selector 3D.
spatial/crate.ymlEl aspecto de la apertura 3D de la caja, con crate.opening: SPATIAL.
spatial/spots.ymlLos selectores 3D colocados en el mundo con /hiteffectsadmin spatial place.
database.ymlDónde se guardan las elecciones. H2 por defecto.
effects.yml es tuyo

config.yml se escribe desde un esquema, así que una clave desconocida se descarta y los comentarios se regeneran. effects.yml no: es un catálogo que cura el dueño del servidor y se lee tal como está escrito.

Las tablas

hiteffect_players, una fila por jugador:

ColumnaQué guarda
uuidEl jugador.
nameSu último nombre conocido.
hitEffectEl efecto que eligió, o vacío.
particleVisibilityALL, NONE, SELF_ONLY u OTHERS_ONLY.
favouritesLos efectos marcados, separados por comas, en su propio orden.
unlocked / crate_keysLo que la caja guardaba aquí antes de 1.4.0. Se lee una vez por jugador y no se vuelve a escribir.
created_at / updated_atCuándo se creó la fila y cuándo se escribió por última vez.

Las llaves de la caja y los efectos que un jugador ganó o compró viven en exylia_crate_players de ExyliaLib, en la misma base de datos, una fila por jugador y plugin. La primera vez que se ve a un jugador tras actualizar se trasladan sus antiguos crate_keys y unlocked, así que nadie pierde una llave ni un efecto; las columnas viejas se quedan donde están para que una vuelta atrás las encuentre.

Los ids se guardan en minúscula y se leen sin importar mayúsculas, así que una fila escrita por una versión antigua — que los guardaba en mayúscula — sigue resolviendo.

Las dos tablas están clasificadas como datos @account, así que /exylialib wipe y /exylialib resetplayer de ExyliaLib las cubren. Un reinicio de temporada (@season) no las toca: nombra @account para quitarle a un jugador sus efectos, llaves y desbloqueos.

Un id marcado que el catálogo ya no declara se conserva en la columna y se descarta al dibujarlo, así que una errata en un reload no vacía la lista de nadie.

¿Falta algo en esta página? Dínoslo en Discord