Comandos

La librería registra un solo comando, /exylialib, sin alias. Los subcomandos se autocompletan. Cada uno tiene su propio permiso para que un servidor pueda dar uno sin los demás; todos son de op por defecto.

/settings es el otro comando de la librería, y está apagado hasta que se activa settings.command.enabled en config.yml. Abre la pantalla donde los jugadores ajustan las preferencias que registra cada plugin de Exylia, y necesita exylialib.settings, que todos los jugadores tienen por defecto.

El panel de estado

/exylialib a secas muestra todo sobre la librería en este servidor en un panel:

• Librería — versión, plataforma, si la auto-actualización está activa y cada cuánto mira, depuración, texto en versalitas.
• Red — si Redis está activo, el id de este servidor en él, y el puente con el proxy: un ping enviado ahora y cronometrado, así que un proxy que se fue se ve caído. Un proxy que no contesta sale como sin respuesta, con la causa habitual (falta ExyliaProxyUtils, o está en otro Redis o con otro prefijo). Jugadores en la red cuando el puente contesta.
• Módulos — scoreboards, hologramas y efectos activos, cuántos plugins usan menús y regiones, acciones registradas, archivos de config cargados.
• Base de datos — el motor, y una línea por plugin con su propio estado, para que la base inalcanzable de un plugin no quede escondida tras otras nueve sanas.
• Plugins dependientes — cada plugin que usa la librería, con su versión.

Sin Redis el panel llega al momento; con él, en cuanto contesta el proxy o a los cinco segundos.

Mover y borrar datos

export nombra las tablas que encontró antes de empezar. Un plugin solo aparece cuando ya pidió su primera tabla, así que uno que registra alguna de forma perezosa exporta menos de las que tiene — lee los nombres.

import se niega a escribir en tablas que ya tienen filas, y devuelve el comando exacto que sí pasaría. force fusiona: las filas cuya clave está en el volcado se sobrescriben, las que no están se quedan donde están.

wipe se ejecuta dos veces. La primera no borra nada: lista lo que se iría y da un código de seis dígitos. El mismo comando con ese código en 60 segundos — mismo emisor, misma petición — escribe primero un volcado y solo entonces borra; si el volcado falla, no se borra nada. Reinicia después: hasta entonces el plugin sigue teniendo las filas en memoria, y sus escrituras en las tablas vaciadas se ignoran para que no vuelvan. Un volcado se restaura con /exylialib import <plugin> <archivo> true.

Borrar por tipo

Cada tabla que declara un plugin dice qué guarda, así que un borrado elige tipos en vez de nombres de tabla:

Dos presets nombran los conjuntos habituales: @season (progreso, mundo y caché) y @players (progreso y caché). Ninguno toca nunca las tablas @setup ni @unspecified; esas solo se van cuando se nombran, por tipo, por tabla o con all. <plugin> <tabla|all> sigue funcionando como antes, y all all es cada tabla de cada plugin.

/exylialib wipe all @season            # una temporada nueva, todos los plugins
/exylialib wipe ExyliaClans @world     # el estado de mundo de un plugin

En el juego, /exylialib wipe a secas abre lo mismo en pantallas: eliges un preset, dejas fuera plugins, ves las filas que quitaría cada tipo y confirmas tecleando WIPE. Las pantallas también pueden borrar los archivos vanilla de los jugadores (playerdata, stats, advancements) en el siguiente arranque.

Reiniciar a un jugador

resetplayer borra las filas de un jugador sin reiniciar el servidor. Solo participan las tablas que nombran la columna del jugador; las demás se saltan, y la vista previa dice cuántas.

/exylialib resetplayer Steve                       # todos los plugins, los tipos por defecto
/exylialib resetplayer Steve ExyliaPracticeCore    # un plugin
/exylialib resetplayer Steve all @progress @account

• Sin tipos, un reinicio borra progreso, mundo y caché. Nombrar tipos reemplaza ese conjunto: @account y @history solo se borran si se nombran, y @setup y @unspecified se rechazan.
• Los presets no sirven aquí: nombra los tipos uno a uno.
• Se confirma como wipe: la primera vez muestra lo que se va y un código, la misma línea con el código lo ejecuta.
• Un jugador conectado en otro servidor se rechaza. Al jugador se le expulsa y se le mantiene fuera de la red mientras dura, primero se escribe un volcado, y puede volver a entrar en cuanto termina.
• Borrar los archivos vanilla del jugador solo lo ofrecen las pantallas.

Registro del staff

Cada plugin de Exylia puede registrar lo que hace el staff — quién hizo qué a quién, dónde, y qué items se movieron — en su propia base de datos. /exylialib logs los lee todos juntos:

/exylialib logs Steve                  # todo lo que hizo Steve o se le hizo
/exylialib logs * ExyliaMarket         # cada entrada del mercado
/exylialib logs Steve * trade          # los intercambios de Steve, en cualquier plugin

* (o all) significa sin filtro. Un jugador recibe un menú con una entrada por acción y los items que movió; la consola recibe las líneas más nuevas como texto. La retención, el intervalo de escritura, los límites de filas y lo que nunca se registra están en el bloque logs de config.yml.

Recompensas pendientes

Las recompensas que un plugin aún no pudo entregar esperan en su almacén de pendientes hasta que el jugador las reclama. /exylialib pendingrewards lista a quién se le debe qué, en todos los plugins. Un jugador recibe un menú, directo a los lotes de un jugador si se da un nombre: clic izquierdo entrega un lote a su dueño (que tiene que estar conectado), shift-clic derecho lo cancela (lo pregunta dos veces). La consola recibe un resumen. Cada entrega y cancelación se escribe en la consola del servidor.

Avisos al entrar

A un admin se le avisa al entrar cuando hay algo que hacer:

• con exylialib.admin, cuando hay actualizaciones de plugins preparadas esperando un reinicio;
• con exylialib.updates, cuando hay valores por defecto cambiados esperando en /exylialib updates, una vez por tanda.