Contenido generado con IA — puede contener errores.

ExyliaArrows/EmpezarActualizada en v1.7.1

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.

Página 2 de 224 min de lectura

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. language en config.yml elige la carpeta dentro de lang/. default sigue 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 reload vuelve a leer config.yml, effects.yml, los mensajes y los menús sin tocar el resto del servidor. No recarga la librería: eso es /exylialib reload.
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 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
ArchivoContenido
config.ymlEl 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.ymlLas 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.ymlTodos 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.ymlLa pantalla principal: pestañas, cuadrícula, plantillas y botones.
lang/<código>/menus/crate.ymlLa primera pantalla de la caja: cuántas abrir a la vez.
lang/<código>/menus/crate_open.ymlLos carretes cayendo, una columna por caja.
spatial/effects.ymlDónde está cada pieza del selector 3D.
database.ymlDó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:

ColumnaQué guarda
uuidEl jugador.
nameSu último nombre conocido.
effectIdEl efecto que eligió, o vacío.
particleVisibilityALL, NONE, SELF_ONLY u OTHERS_ONLY.
favouritesLos efectos que marcó con estrella, separados por comas y en su orden.
unlocked / crate_keysLo 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_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 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