Instalación
Suelta dos jars, arranca el servidor y tendrás un menú funcionando. Los archivos que escribe y las tablas que usa.
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#
- La consola no muestra errores de ExyliaHitEffect y
plugins/ExyliaHitEffect/ya tieneconfig.yml,database.ymly una carpetalang/. - En el juego,
/hiteffectabre el menú. - 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
| Archivo | Contenido |
|---|---|
config.yml | El idioma, el comportamiento, los materiales de los objetos, la caja, la tienda, los showcases, el feedback y la visibilidad. |
lang/<code>/effects.yml | Las seis categorías y los 90 efectos. Escrito a mano, sin esquema: tus comentarios y tu formato sobreviven a un reload. |
lang/<code>/messages.yml | Todos 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.yml | La pantalla: pestañas, rejilla, plantillas y botones. |
lang/<code>/screens/effects.yml | Las 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.yml | La primera pantalla de la caja: cuántas abrir a la vez. |
lang/<code>/menus/crate_open.yml | Los rodillos cayendo, una columna por caja. |
spatial/effects.yml | Dónde está cada pieza del selector 3D. |
spatial/crate.yml | El aspecto de la apertura 3D de la caja, con crate.opening: SPATIAL. |
spatial/spots.yml | Los selectores 3D colocados en el mundo con /hiteffectsadmin spatial place. |
database.yml | Dónde se guardan las elecciones. H2 por defecto. |
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:
| Columna | Qué guarda |
|---|---|
uuid | El jugador. |
name | Su último nombre conocido. |
hitEffect | El efecto que eligió, o vacío. |
particleVisibility | ALL, NONE, SELF_ONLY u OTHERS_ONLY. |
favourites | Los efectos marcados, separados por comas, en su propio orden. |
unlocked / crate_keys | Lo 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_at | Cuá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