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.
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
hidePlayerde 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 defectoengine: commandsejecuta comandos, y los valores por defecto son los nombres de comando que usan LiteBans y AdvancedBan. LibertyBans y BanManager no están ensoftdepend; el módulo las reconoce igualmente. Conobserveactivado, 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.ymlde 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.
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:
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/.
| Archivo | Contenido |
|---|---|
config.yml | El idioma, los interruptores de módulos, la puerta de comandos y disabled-commands. |
modules/<id>/config.yml | Uno por módulo, solo sus ajustes. |
lang/<language>/messages.yml | Las líneas del núcleo: prefijo, sin permiso, recarga, lista de módulos, puerta, Redis. |
lang/<language>/modules/<id>/messages.yml | Uno por cada módulo que envía mensajes. |
lang/<language>/modules/staffmode/hotbar.yml | La hotbar de staff. |
lang/<language>/modules/scoreboard/config.yml | Los 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.json | La última configuración que envió Exylia Staff Web, cuando la red está vinculada y la web gestiona archivos. |
database.yml | Motor 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.
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