Contenido generado con IA — puede contener errores.

ExyliaStaff/EmpezarActualizada en v1.8.0

Instalación

Instala ExyliaStaff en Paper o Folia, elige los plugins opcionales, comprueba que arrancó y apunta el plugin a una base de datos compartida.

Página 2 de 385 min de lectura

Al terminar esta página ExyliaStaff está funcionando, sus módulos están encendidos y sabes dónde vive su base de datos.

Antes de empezar#

  • Paper 1.21.1 o posterior, o Folia, con Java 21.
  • ExyliaLib, que instala el loader. ExyliaStaff siempre se compila contra la última versión de ExyliaLib, así que actualiza las dos a la vez.

Plugins opcionales, todos en softdepend de plugin.yml salvo que se indique:

  • PacketEvents para las partes dibujadas con paquetes. Sin él el plugin carga igualmente: el modo staff, la visión x-ray y revelar quedan apagados, el vanish usa hidePlayer de Bukkit, el freeze usa comprobaciones de movimiento, y las repeticiones se guardan pero no pueden verse.
  • ExyliaLink para aprobar desde Discord las entradas del staff, ver Doble factor.
  • PlaceholderAPI para usar los placeholders del plugin fuera de él.
  • LuckPerms, o cualquier plugin de permisos, para los nodos de rango exyliastaff.vanish.level.<n>.
  • LiteBans, AdvancedBan, LibertyBans o BanManager, salvo que sanciones las aplique él mismo con engine: exylia. Con el valor por defecto engine: commands ejecuta comandos, y los valores por defecto son los nombres de comando que usan LiteBans y AdvancedBan. LibertyBans y BanManager no están en softdepend; el módulo las reconoce igualmente. Con observe activado, lo que hacen estos plugins se registra en el historial.
  • GrimAC, Vulcan o Matrix para reenviar sus alertas a Exylia Staff Web.
  • Redis, configurado en el database.yml de ExyliaLib, para las partes entre servidores: chat de staff, chat de red, alertas, la lista de staff y el estado de vanish en el siguiente servidor. Sin Redis cada canal sigue entregando en el servidor local.
ExyliaLib figura como soft

plugin.yml nombra a ExyliaLib bajo softdepend a propósito: el loader que instala ExyliaLib tiene que cargar primero para que esa instalación ocurra. El plugin sigue necesitándola para funcionar.

Pasos#

Copia los jars

Copia el jar del loader de ExyliaStaff en la carpeta plugins/ del servidor, junto con los plugins opcionales que quieras.

Arranca el servidor

El primer arranque genera config.yml, una carpeta por módulo bajo modules/, los menús y mensajes bajo lang/, y las tablas de la base de datos.

Concede el nodo de staff

exyliastaff.staff es lo que convierte a un jugador en staff para todos los módulos. Sin él nadie ve a los jugadores en vanish, recibe alertas ni puede entrar en modo staff. Dalo a tu equipo en tu plugin de permisos y sigue Primeros pasos.

Comprueba que funciona#

En la consola deberías ver una línea Module enabled: <id> por cada módulo encendido, y al final ExyliaStaff enabled with N/27 modules. Un módulo que lanzó un error al activarse se informa ahí con su motivo y aparece como failed en /staffadmin modules; el siguiente arranque lo reintenta.

En el juego, como operador, ejecuta /staffadmin modules: cada módulo muestra un estado. Después, como jugador con exyliastaff.staff, ejecuta /staff (el modo staff necesita PacketEvents) y aparece la hotbar de staff. Si algo falla, mira Problemas comunes.

Base de datos#

Por defecto el plugin usa H2: un archivo dentro de la carpeta del plugin, sin servidor, sin instalación y sin mantenimiento. Para compartir sesiones, reportes, sanciones y el registro entre servidores, apunta todos los servidores a la misma base de datos:

plugins/ExyliaStaff/database.yml
yaml
database:
  type: mysql
  mysql:
    host: 127.0.0.1
    port: 3306
    database: minecraft
    username: root
    password: ""

Motores soportados: h2, mysql, mariadb, postgresql y mongodb. El archivo es de ExyliaLib; su referencia completa, incluido el bloque redis, está en la página de base de datos de la librería.

El vínculo con Exylia Staff Web, las repeticiones, la cola de restauración y las sesiones de doble factor se leen en toda la red desde esta base de datos, otro motivo más para compartirla entre todos los servidores.

Cada tabla declara lo que guarda, así que /exylialib resetplayer y /exylialib wipe de ExyliaLib cubren los datos del plugin. Ver Comandos.

Tablas que crea el plugin

staff_prefs, staff_sessions, staff_vanish, staff_freeze, staff_reports, staff_helpop, staff_mining, staff_punishments, staff_punishment_requests, staff_log_sessions, staff_log_daily, staff_audit, staff_notes, staff_restores, staff_restore_queue, staff_restore_log, staff_replays, staff_replay_data, staff_replay_chunks, staff_revoked_items, staff_revoked_hits, staff_alts y staff_2fa, más web_link, web_lease, web_outbox y web_commands_done para Exylia Staff Web. Los snapshots de inventario del modo staff y del freeze usan la tabla exylia_snapshots de la librería.

Archivos generados

Todos viven en plugins/ExyliaStaff/.

ArchivoContenido
config.ymlEl idioma, los interruptores de módulos, la puerta de comandos y disabled-commands.
modules/<id>/config.ymlUno por módulo, solo sus ajustes.
lang/<language>/messages.ymlLas líneas del núcleo: prefijo, sin permiso, recarga, lista de módulos, puerta, Redis.
lang/<language>/modules/<id>/messages.ymlUno por cada módulo que envía mensajes.
lang/<language>/modules/staffmode/hotbar.ymlLa hotbar de staff.
lang/<language>/modules/scoreboard/config.ymlLos tres sidebars: modo staff, congelado, congelando.
lang/<language>/menus/<id>/Las pantallas de staff de cada módulo.
lang/<language>/menus/admin/El panel y la lista de módulos que abre /staffadmin. Se reescriben desde el jar en cada arranque y recarga.
web/managed.jsonLa última configuración que envió Exylia Staff Web, cuando la red está vinculada y la web gestiona archivos.
database.ymlMotor de base de datos y Redis, escrito por ExyliaLib.

Todos los archivos bajo lang/ salvo menus/admin/ son tuyos para editar, en todos los idiomas: ver Idiomas.

Actualizar#

Sustituye el jar y reinicia. Tus ediciones se conservan: una versión nueva solo añade las claves y los archivos que te faltan, y un valor por defecto que cambió en algo que nunca editaste espera en /exylialib updates.

Actualizar desde la 1.3 o anterior

El primer arranque de la 1.4.0 mueve tu messages.yml, cada modules/<id>/messages.yml, los sidebars, la hotbar y menus/ a lang/custom/ y fija language: custom, así que nada cambia en pantalla. Cambia a en, es, pt, fr, ru o tr para usar los archivos incluidos. Ver Idiomas.

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