Contenido generado con IA — puede contener errores.

ExyliaStaff/Referencia

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.

Página 29 de 3812 min de lectura
    - 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   - top  - tp  - teleport

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.

Gestionado desde la web

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#

plugins/ExyliaStaff/config.yml
yaml
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:

InterruptorIdPágina
vanishvanishVanish
staff-modestaffmodeModo staff
freezefreezeFreeze
staff-chat, global-chatstaffchat, globalchatChat de staff
inspectinspectInspección
teleportteleportTeletransporte
staff-liststafflistLista de staff
scoreboardscoreboardSidebars
reports, helpopreports, helpopReportes, Helpop
miningminingMinería
inventory-restorerestoreRestaurar inventario
xray-visionxrayvisionVisión x-ray
see-invisiblerevealRevelar
punishmentspunishmentsSanciones
staff-logstafflogRegistro del staff
staff-adminstaffadminAuditoría y notas
afkafkAFK
action-baractionbarBarra de acción
item-revocationrevokeRevocación de objetos
replaysreplayRepeticiones
web, alts, anticheatweb, alts, anticheatExylia Staff Web
discorddiscordWebhooks de Discord
two-factortwofactorDoble 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.

yaml
disabled-commands:
  - top
  - tp
  - teleport

Los 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.

plugins/ExyliaStaff/lang/en/messages.yml
yaml
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óndeContiene
modules/<id>/config.ymlLos ajustes del módulo. Todos los módulos salvo el scoreboard e inspección tienen uno.
lang/<language>/modules/<id>/messages.ymlLas líneas, títulos, barras de acción y sonidos del módulo.
lang/<language>/modules/scoreboard/config.ymlLos sidebars, que son texto.
lang/<language>/modules/inspect/config.ymlLos títulos de las ventanas, que son texto.
lang/<language>/modules/staffmode/hotbar.ymlLa hotbar del staff.
lang/<language>/modules/replay/hotbar.ymlLos 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.

plugins/ExyliaStaff/modules/discord/config.yml
yaml
staff-chat: ''
punishments: ''
reports: ''
helpop: ''
alerts: ''
freeze: ''
staff-log: ''
replays: ''
ClavePublica
staff-chatCada línea del chat de staff, con el nombre y la cabeza de quien la envía.
punishmentsSanciones nuevas y revocadas.
reportsReportes nuevos de jugadores.
helpopPreguntas nuevas de /helpop.
alertsAlertas de minería y posible evasión de ban.
freezeJugadores congelados y descongelados.
staff-logStaff que entra y sale de servicio.
replaysRepeticiones 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.

PlantillaTokens
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.

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.

plugins/ExyliaStaff/lang/en/modules/scoreboard/config.yml
yaml
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: true

Menú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