Configuración
config.yml, el idioma, los interruptores de módulo, la puerta de comandos, los comandos desactivados, los ajustes en el juego, los archivos de módulo, los webhooks de Discord, los sidebars, los menús y la base de datos.
Todo se genera en plugins/ExyliaStaff/ en el primer arranque, con comentarios. El núcleo mantiene
config.yml; cada módulo mantiene sus ajustes bajo modules/<id>/, de modo que un dueño que apaga una
función nunca tiene que pasar por encima de sus ajustes para encontrar el interruptor. El texto vive
aparte de los ajustes, bajo lang/<language>/: ver Idiomas. Los colores usan
tokens de paleta como {primary}, {error} o {highlight}, resueltos por la librería. Un mensaje puede
abrir con una etiqueta de efecto, [sound:NAME|volume|pitch], que suena para quien lo recibe y nunca
llega a la pantalla.
/staffadmin reload ejecuta cuatro pasos: configs, modules, admin menus y command gate. La
hotbar se vuelve a leer y a mostrar, los sidebars se reconstruyen, las menas de minería se vuelven a
indexar.
Cada ajuste puede cambiarse también en el juego: ver Ajustes en el juego.
Una red vinculada a Exylia Staff Web puede ceder a la web config.yml y los config.yml de los
módulos. Un archivo gestionado lo indica en su cabecera, y las ediciones en disco se ignoran. Ver
Exylia Staff Web.
config.yml#
language: default
modules:
vanish: true
staff-mode: true
freeze: true
staff-chat: true
global-chat: true
inspect: true
teleport: true
staff-list: true
scoreboard: true
reports: true
helpop: true
mining: true
inventory-restore: true
xray-vision: true
see-invisible: true
punishments: true
staff-log: true
staff-admin: true
afk: true
action-bar: true
item-revocation: false
replays: true
web: true
alts: true
anticheat: true
discord: true
two-factor: true
command-gate:
enabled: true
staff-only-commands:
- tp
- teleport
- tphere
- tpall
- inspect
- invsee
- gamemode
- gm
- gmc
- gms
- gmsp
- fly
- god
- vanish
- freeze
- ss
- echest
- enderchest
- kill
- clear
- give
- xray
- xrayvision
- seeinvis
- seeinvisible
- reveal
bypass-permission: exyliastaff.gate.bypass
hide-from-tab: true
disabled-commands: []Idioma#
default sigue el idioma fijado en el config.yml de ExyliaLib; en, es, pt, fr, ru o tr lo fijan solo
para este plugin. Ver Idiomas.
Módulos#
Un módulo apagado no registra nada: ni comandos, ni listeners, ni tablas. Los ids que usa
/staffadmin module son los nombres en código, que no siempre coinciden con el interruptor:
| Interruptor | Id | Página |
|---|---|---|
vanish | vanish | Vanish |
staff-mode | staffmode | Modo staff |
freeze | freeze | Freeze |
staff-chat, global-chat | staffchat, globalchat | Chat de staff |
inspect | inspect | Inspección |
teleport | teleport | Teletransporte |
staff-list | stafflist | Lista de staff |
scoreboard | scoreboard | Sidebars |
reports, helpop | reports, helpop | Reportes, Helpop |
mining | mining | Minería |
inventory-restore | restore | Restaurar inventario |
xray-vision | xrayvision | Visión x-ray |
see-invisible | reveal | Revelar |
punishments | punishments | Sanciones |
staff-log | stafflog | Registro del staff |
staff-admin | staffadmin | Auditoría y notas |
afk | afk | AFK |
action-bar | actionbar | Barra de acción |
item-revocation | revoke | Revocación de objetos |
replays | replay | Repeticiones |
web, alts, anticheat | web, alts, anticheat | Exylia Staff Web |
discord | discord | Webhooks de Discord |
two-factor | twofactor | Doble factor |
La revocación de objetos es el único módulo apagado por defecto. Un módulo cuya dependencia está apagada
también se queda apagado: la revocación de objetos necesita la restauración de inventario, y alts necesita
web. Un módulo que lanza una excepción al activarse aparece como failed, mantiene sus comandos apagados
y se reintenta en el siguiente arranque. /staffadmin module enable|disable y la lista de módulos del
panel de administración escriben el interruptor aquí, así que sobrevive a un reinicio.
El modo staff, la visión x-ray y revelar necesitan PacketEvents y quedan apagados sin él; vanish, freeze e inspección funcionan sin él, y las repeticiones lo necesitan para poder verse. El modo staff consulta vanish y el scoreboard en cada llamada, así que apagar cualquiera de los dos en caliente simplemente hace que el modo staff deje de ocultar o deje de mostrar un tablero.
Puerta de comandos#
Los comandos de staff-only-commands solo pueden ejecutarse en modo staff. La lista se compara con el
nombre registrado de cada comando y con todos sus alias, de modo que tp también bloquea teleport
cuando es un alias, y con las grafías plugin:name. Fuera del modo staff el comando se cancela con
gate.blocked, se quita de la lista de comandos del cliente y no recibe autocompletado cuando
hide-from-tab está encendido. Los jugadores con bypass-permission nunca son bloqueados. La puerta no
comprueba el permiso propio del comando: solo pregunta si el jugador está en modo staff.
Comandos desactivados#
disabled-commands lista los comandos que este plugin no debe registrar, sin la barra, mientras el resto
de su módulo sigue funcionando. Cada alias cuenta por separado: listar top libera /top para otro
plugin y mantiene /stafftop; listar tp y teleport deja en paz el teletransporte vanilla mientras
/stafftp sigue funcionando.
disabled-commands:
- top
- tp
- teleportLos nombres se descartan antes de que el servidor llegue a verlos, así que reinicia después de cambiar la lista: el nombre liberado pasa entonces al plugin que también lo registra.
Ajustes en el juego#
/staffadmin settings, o Settings en el panel que abre /staffadmin, es un panel de páginas
escritas a mano para lo que un admin realmente ajusta: los interruptores de módulos (agrupados en
Moderation, Communication, Evidence y Network), la puerta de comandos, y las páginas de AFK, minería, vanish,
modo staff, freeze, sanciones, repeticiones, reportes y helpop. Cada tarjeta explica el valor, muestra el
actual y su valor por defecto, y un clic lo edita (shift + clic derecho lo restablece). Un cambio se
escribe directamente en el archivo. Necesita exyliastaff.admin. Cualquier archivo, también los de los
demás módulos, sigue pudiéndose editar en /exylialib config y en el editor web de ExyliaLib.
Un archivo que gestiona Exylia Staff Web queda fuera de ambos, porque la web lo sobrescribe en la siguiente carga.
messages.yml#
Las líneas del núcleo, en lang/<language>/messages.yml.
prefix: '{primary}&lSTAFF {letters_black}•<reset>'
no-permission: '[sound:ENTITY_VILLAGER_NO|1.0|1.0]%prefix% {error}You do not have permission to do that.'
player-only: '%prefix% {error}Only a player can run this command.'
player-not-found: '[sound:ENTITY_VILLAGER_NO|1.0|1.0]%prefix% {error}{highlight}%player% {error}is not online.'
world-not-found: '[sound:ENTITY_VILLAGER_NO|1.0|1.0]%prefix% {error}There is no world named {highlight}%world%{error}.'
module-disabled: '[sound:ENTITY_VILLAGER_NO|1.0|1.0]%prefix% {error}The {highlight}%module% {error}module is off on this server.'
reload:
started: '%prefix% {muted}Reloading…'
done: '[sound:ENTITY_EXPERIENCE_ORB_PICKUP|1.0|1.2]%prefix% {success}Reloaded {highlight}%steps% {success}steps in {highlight}%ms%ms{success}.'
failed: '[sound:ENTITY_VILLAGER_NO|1.0|1.0]%prefix% {error}Reload finished with errors. Check the console.'
modules:
header: '%prefix% {letters}Modules {letters_black}» {highlight}%enabled%{letters_black}/{muted}%total% {letters}running'
line: ' {muted}❙ %color%%module% {letters_black}» %state%'
enabled: '[sound:ENTITY_EXPERIENCE_ORB_PICKUP|1.0|1.2]%prefix% {success}Module {highlight}%module% {success}enabled.'
disabled: '%prefix% {warning}Module {highlight}%module% {warning}disabled.'
enable-failed: '[sound:ENTITY_VILLAGER_NO|1.0|1.0]%prefix% {error}Module {highlight}%module% {error}could not start: it is already on, it failed, or a dependency is off.'
disable-failed: '[sound:ENTITY_VILLAGER_NO|1.0|1.0]%prefix% {error}Module {highlight}%module% {error}is not enabled.'
unknown: '[sound:ENTITY_VILLAGER_NO|1.0|1.0]%prefix% {error}No module named {highlight}%module%{error}.'
managed: '%prefix% {warning}The web panel manages this server''s modules: switch {highlight}%module% {warning}there too, or it returns to the panel''s value on the next restart.'
gate:
blocked: '[sound:ENTITY_VILLAGER_NO|1.0|1.0]%prefix% {error}Enable staff mode before using {highlight}/%command%{error}.'
redis:
server-id: '%prefix% {letters}Server {letters_black}» {highlight}%server%'
active: ' {muted}❙ {letters}Redis {letters_black}» {success}connected'
inactive: ' {muted}❙ {letters}Redis {letters_black}» {muted}off, local bus only'
stats: ' {muted}❙ {letters_black}%stats%'admin-menu guarda las palabras que muestra la lista de módulos del panel de administración: running,
stopped, failed, y enabled o disabled para el interruptor al arrancar. modules.managed se envía
cuando un módulo cambiado en el juego lo gestiona la web.
%prefix% se expande a prefix en todos los mensajes del plugin, los de los módulos incluidos. no-permission
y player-only son lo que envía el framework de comandos; player-not-found se envía para cualquier
argumento de jugador que no resuelve, y world-not-found para un argumento de mundo. La convención en
todos los archivos: un rechazo suena ENTITY_VILLAGER_NO, un éxito ENTITY_EXPERIENCE_ORB_PICKUP, un
aviso BLOCK_NOTE_BLOCK_PLING.
Archivos de módulo#
Cada página de módulo muestra su propio config.yml y lista sus claves de mensaje.
| Dónde | Contiene |
|---|---|
modules/<id>/config.yml | Los ajustes del módulo. Todos los módulos salvo el scoreboard e inspección tienen uno. |
lang/<language>/modules/<id>/messages.yml | Las líneas, títulos, barras de acción y sonidos del módulo. |
lang/<language>/modules/scoreboard/config.yml | Los sidebars, que son texto. |
lang/<language>/modules/inspect/config.yml | Los títulos de las ventanas, que son texto. |
lang/<language>/modules/staffmode/hotbar.yml | La hotbar del staff. |
lang/<language>/modules/replay/hotbar.yml | Los controles de las repeticiones. |
Los bloques de efecto como effects.enter, alert o reminder son efectos de la librería con las
secciones title, action-bar, boss-bar, sound y particle. Una sección vacía no se
escribe en el archivo; añádela para usarla. Sus claves están en la
página de efectos de la librería.
Webhooks de Discord#
El módulo discord refleja el chat de staff y los eventos del staff en canales de Discord mediante
webhooks. No necesita ni la web ni un bot, y no envía nada hasta que se pone una URL. Pega cada URL
(ajustes del canal » Integraciones » Webhooks) en su clave; una vacía no envía nada, y varias claves
pueden compartir URL. En una red cada servidor publica lo que pasa en él, así que da a todos los
servidores las mismas URLs.
staff-chat: ''
punishments: ''
reports: ''
helpop: ''
alerts: ''
freeze: ''
staff-log: ''
replays: ''| Clave | Publica |
|---|---|
staff-chat | Cada línea del chat de staff, con el nombre y la cabeza de quien la envía. |
punishments | Sanciones nuevas y revocadas. |
reports | Reportes nuevos de jugadores. |
helpop | Preguntas nuevas de /helpop. |
alerts | Alertas de minería y posible evasión de ban. |
freeze | Jugadores congelados y descongelados. |
staff-log | Staff que entra y sale de servicio. |
replays | Repeticiones guardadas por una regla de captura. |
Una URL que Discord rechazaría se avisa una vez en la consola al arrancar y al recargar, sin imprimirla, porque contiene el token. Los eventos de hace más de diez minutos, como las filas de una importación de un plugin de baneos, no se publican.
Lo que publica cada evento está en lang/<language>/modules/discord/messages.yml, una plantilla por
evento con el formato de plantilla de webhook de la librería. El
chat de staff publica la línea tal cual con %player% • %server% como nombre y la cabeza del jugador
como avatar; cualquier otro evento es una tarjeta coloreada con un token de la paleta, con %server% en
el pie. Todas las plantillas aceptan además %server%, el redis.server-id de este servidor.
| Plantilla | Tokens |
|---|---|
staff-chat | %player% %player_head% %message% |
punishment | %id% %target% %type% %duration% %staff% %reason% |
punishment-revoked | %id% %staff% %reason% |
report | %reporter% %target% %reason% |
helpop | %player% %message% |
mining-alert | %player% %count% %ore% %minutes% %level% %world% %x% %y% %z% |
ban-evasion | %player% %banned% |
frozen, unfrozen | %target% %staff% %reason% |
duty-start, duty-end | %player% |
replay-rule | %player% %detail% (la regla y lo que la disparó) %id% %seconds% |
Las colas, los límites de Discord y el escapado los gestiona la librería.
Sidebars#
lang/<language>/modules/scoreboard/config.yml contiene tres tableros: staff-mode, mostrado de
servicio; frozen, mostrado a un jugador congelado; freezing, mostrado al miembro del staff que lo
retiene. Cada uno tiene enabled, una lista title que se anima cuando tiene varias entradas, hasta
quince lines y update.interval en ticks. Los tableros se apilan: un freeze mostrado sobre el tablero
de staff lo oculta y lo devuelve al liberar. {server-ip} en la última línea es la dirección fijada una
sola vez en el colors.yml de ExyliaLib.
staff-mode:
enabled: true
title:
- '{primary}&lSTAFF'
lines:
- ''
- ' {muted}❙ {letters}Session {letters_black}» {highlight}%staff_staffmode_time%'
- ' {muted}❙ {letters}Vanish {letters_black}» %staff_vanish_status%'
- ' {muted}❙ {letters}Reports {letters_black}» {warning}%staff_reports_open%'
- ' {muted}❙ {letters}Help requests {letters_black}» {info}%staff_helpop_open%'
- ''
- ' {muted}❙ {letters}TPS {letters_black}» {info}%server_tps% {letters_black}· {letters}MSPT {letters_black}» {info}%server_mspt%ms'
- ' {muted}❙ {letters}CPU {letters_black}» {info}%server_cpu_process:percent% {letters_black}proc · {info}%server_cpu_system:percent% {letters_black}host'
- ' {muted}❙ {letters}RAM {letters_black}» {info}%server_ram_used%{letters_black}/{info}%server_ram_max% {letters_black}MB'
- ' {muted}❙ {letters}Ping {letters_black}» {info}%player_ping%ms'
- ''
- ' {muted}❙ {letters}Staff {letters_black}» {success}%staff_online% {letters_black}· {letters}Players {letters_black}» {success}%server_online%'
- ' {muted}❙ {letters}AFK {letters_black}» {warning}%staff_afk_count%'
- ''
- ' {highlight}{server-ip}'
update:
interval: 20
smart: true
frozen:
enabled: true
title:
- '{error}&lFROZEN'
lines:
- ''
- ' {muted}❙ {letters}A staff member is talking'
- ' {muted}❙ {letters}to you. Answer them.'
- ''
- ' {muted}❙ {letters}Staff {letters_black}» {highlight}%staff_freeze_by%'
- ' {muted}❙ {letters}Frozen for {letters_black}» {info}%staff_freeze_time%'
- ''
- ' {error}❙ Do not log out.'
- ''
- ' {highlight}{server-ip}'
update:
interval: 20
smart: true
freezing:
enabled: true
title:
- '{primary}&lFREEZING'
lines:
- ''
- ' {muted}❙ {letters}Target {letters_black}» {highlight}%staff_freeze_target%'
- ' {muted}❙ {letters}Frozen for {letters_black}» {info}%staff_freeze_time%'
- ''
- ' {highlight}{server-ip}'
update:
interval: 20
smart: trueMenús#
Cada pantalla de staff es un archivo YAML bajo lang/<language>/menus/<module>/: reports/ con
reasons, list, player y history; helpop/list; punishments/ con categories, reasons,
confirm y history; mining/ con suspicious y player; restore/ con servers, list,
backup, parts y log; replay/ con list y players; revoke/quarantine; stafflog/ con
sessions, summary y top; replay/events, el registro de eventos; y admin/ con hub y modules,
las pantallas que abre /staffadmin. Su formato es el formato de menús de la librería.
Son tuyas para cambiarles el estilo, salvo admin/: esas dos son del plugin y se reescriben desde el jar
en cada arranque y recarga. Una versión nueva solo añade lo que les falta a tus archivos; un valor
por defecto que cambió en algo que nunca editaste espera en /exylialib updates, donde lo aplicas o te
quedas con el tuyo.
database.yml#
Motor y Redis, escrito por ExyliaLib. H2 por defecto. Ver Instalación
para los motores y las tablas, y la página de base de datos de la librería para cada clave,
redis.server-id entre ellas, que es el nombre que muestra cada alerta y cada línea del chat de staff.
¿Falta algo en esta página? Dínoslo en Discord