Instala ExyliaArrows
Pon los jars, arranca el servidor y comprueba que el plugin funciona. Incluye los archivos que escribe y las tablas de base de datos que usa.
Al terminar esta página ExyliaArrows funciona en tu servidor, con sus menús y sus 120 efectos escritos en disco y su base de datos lista. No hace falta editar nada para una primera prueba.
Antes de empezar#
Necesitas un servidor Paper (mira los requisitos) y el plugin packetevents. ExyliaLib se instala solo en el primer arranque si falta.
Pasos#
Pon los jars
Copia ExyliaArrows.jar y packetevents en plugins/. ExyliaLib es una dependencia blanda: si no está, el loader la instala en el primer arranque.
Arranca el servidor
El plugin escribe config.yml, effects.yml, database.yml y las carpetas lang/ con los menús y mensajes en inglés, español, portugués, francés, ruso y turco, y crea sus tablas.
Deja que los jugadores abran el menú
Todos pueden ejecutar /arrows por defecto, pero un jugador no tiene ningún efecto hasta que le des uno. Los operadores los tienen todos. Mira Tu primer efecto y Permisos.
Comprueba que funciona#
Ejecuta /arrows como operador. Se abre el menú de efectos. Después ejecuta /arrowsadmin list: muestra todos los efectos que declara el servidor. Si el menú no se abre o no sale nada, mira Problemas comunes.
Ir más lejos#
- Cambia el idioma.
languageenconfig.ymlelige la carpeta dentro delang/.defaultsigue el idioma de ExyliaLib. Mira Configuración. - Elige una base de datos. H2 es la de por defecto y no necesita nada. Para MySQL, MariaDB, PostgreSQL o MongoDB mira Configuración de la base de datos.
- Actualiza. Sustituye el jar y reinicia.
/arrowsadmin reloadvuelve a leerconfig.yml,effects.yml, los mensajes y los menús sin tocar el resto del servidor. No recarga la librería: eso es/exylialib reload.
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 cuidas tú y se lee tal cual está escrito. Una actualización añade los efectos que trae y tu archivo aún no tiene; un valor que cambiaste nunca se toca, y un valor incluido que cambió bajo uno que dejaste intacto aparece en /exylialib updates para que lo apliques o lo conserves.
Archivos que escribe el plugin
| Archivo | Contenido |
|---|---|
config.yml | El idioma, el comportamiento, los proyectiles, las estelas, los materiales de los ítems, las rarezas, la caja, el escenario de vista previa, los escaparates, el feedback, la visibilidad y la tienda. |
lang/<código>/effects.yml | Las seis categorías y los 120 efectos, un catálogo por idioma. Escrito a mano, sin esquema: tus comentarios y tu formato sobreviven a una recarga. Un servidor que tenía effects.yml en la carpeta de datos conserva sus cambios: el archivo se adopta en la carpeta del idioma en el primer arranque. |
lang/<código>/messages.yml | Todos los mensajes, más los nombres y la descripción de los ítems, las líneas del arco y los textos del menú. |
lang/<código>/menus/effects.yml | La pantalla principal: pestañas, cuadrícula, plantillas y botones. |
lang/<código>/menus/crate.yml | La primera pantalla de la caja: cuántas abrir a la vez. |
lang/<código>/menus/crate_open.yml | Los carretes cayendo, una columna por caja. |
spatial/effects.yml | Dónde está cada pieza del selector 3D. |
database.yml | Dónde se guardan los datos. H2 por defecto. |
<código> es el language de config.yml.
Tablas de la base de datos
arrows_players, una fila por jugador:
| Columna | Qué guarda |
|---|---|
uuid | El jugador. |
name | Su último nombre conocido. |
effectId | El efecto que eligió, o vacío. |
particleVisibility | ALL, NONE, SELF_ONLY u OTHERS_ONLY. |
favourites | Los efectos que marcó con estrella, separados por comas y en su orden. |
unlocked / crate_keys | Lo que la caja guardaba aquí hasta la 1.3.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 desde la 1.3.0, sus antiguos crate_keys y unlocked se pasan allí, así que nadie pierde una llave ni un efecto; las columnas antiguas se quedan para que un retroceso las encuentre.
Ambas tablas están clasificadas como datos de cuenta, así que /exylialib wipe y /exylialib resetplayer de ExyliaLib las cubren: así se restablecen la elección, los favoritos, las llaves y los desbloqueos de un jugador.
Los ids se guardan en minúsculas y se leen sin distinguir mayúsculas, así que una fila escrita por una versión anterior sigue funcionando. Un id con estrella que el catálogo ya no declara se conserva en la columna y se omite al dibujar, así que un error al recargar no vacía la lista de nadie.
¿Falta algo en esta página? Dínoslo en Discord