HyTari Studios · Guía oficial de configuración

CommandSpy

Controla qué se supervisa, quién lo ve y durante cuánto tiempo.

CommandSpy separa la supervisión en vivo, los permisos personales y la auditoría local. Esta guía explica las categorías, el panel del staff, los registros y la protección de comandos sensibles.

INICIAR LA GUÍA PÁGINA DEL MOD

ANTES DE EMPEZAR

Primeros pasos

PASO 01

Instala el JAR

Coloca una sola versión de CommandSpy en la carpeta mods y reinicia el servidor.

PASO 02

Asigna permisos

Concede al staff solo las categorías de supervisión que realmente necesite.

PASO 03

Configura la retención

Elige qué eventos guardar y durante cuántos días.

Los registros pueden contener comandos y conversaciones privadas. Restringe el acceso a mods/CommandSpy y usa permisos mínimos para el staff.

CAPÍTULO 01 · 1 EJEMPLOS

Instalación y archivos

Dónde se crean la configuración, los estados del staff y los registros.

01ESTRUCTURA

Archivos creados por el mod

CommandSpy mantiene la configuración, el estado personal del staff y un único registro de auditoría persistente.

ESTRUCTURA
config.json
spy-state.json
console-state.json
logs/commands.log

mods/CommandSpy/

QUÉ HACE

CommandSpy mantiene la configuración, el estado personal del staff y un único registro de auditoría persistente.

COMPORTAMIENTO IMPORTANTE

  • Los estados solo se guardan para miembros del staff con CommandSpy activo.
  • commands.log es persistente y se limpia según la retención configurada.
  • El mod no envía los datos supervisados fuera del servidor.

CAPÍTULO 02 · 1 EJEMPLOS

Permisos

Separa acceso completo, mensajes privados, comandos de jugadores y consola.

01PERMISOS

Permisos independientes

Las categorías de supervisión pueden asignarse por separado según el rol del staff.

PERMISOS
command.spy
command.spy.messages
command.spy.commands
command.spy.console

Plugin de permisos / permisos del servidor

QUÉ HACE

Las categorías de supervisión pueden asignarse por separado según el rol del staff.

COMPORTAMIENTO IMPORTANTE

  • command.spy concede acceso completo y /cmdspy reload.
  • command.spy.messages cubre los comandos de mensajes privados reconocidos.
  • command.spy.commands cubre los comandos normales de los jugadores.
  • command.spy.console permite ver los comandos ejecutados por la consola.

CAPÍTULO 03 · 1 EJEMPLOS

Comandos y panel

Cada miembro del staff controla sus propias categorías de supervisión.

01COMANDOS

Controles personales del staff

El interruptor general y los filtros por categoría son personales y también pueden gestionarse desde el panel gráfico.

COMANDOS
/cmdspy
/cmdspy messages
/cmdspy commands
/cmdspy console
/cmdspy gui
/cmdspy reload

Comandos del juego

QUÉ HACE

El interruptor general y los filtros por categoría son personales y también pueden gestionarse desde el panel gráfico.

COMPORTAMIENTO IMPORTANTE

  • Las categorías sin permiso siguen visibles, pero no pueden modificarse.
  • Las preferencias activas se guardan inmediatamente.
  • Al desactivar el interruptor general, se elimina el estado guardado y en la próxima activación vuelven los valores predeterminados.

CAPÍTULO 04 · 1 EJEMPLOS

Registro y retención

Decide qué categorías se guardan en el archivo de auditoría y durante cuántos días.

01JSON

Configuración del registro de auditoría

El registro en archivo es independiente de los permisos en vivo y de los filtros personales del staff.

JSON
{
  "default-spy-enabled": false,
  "log-player-commands": true,
  "log-private-messages": true,
  "log-console-commands": true,
  "log-retention-days": 15
}

mods/CommandSpy/config.json

QUÉ HACE

El registro en archivo es independiente de los permisos en vivo y de los filtros personales del staff.

COMPORTAMIENTO IMPORTANTE

  • Cada categoría puede registrarse o excluirse de forma independiente.
  • log-retention-days elimina automáticamente las líneas antiguas del archivo persistente.
  • La retención predeterminada es de 15 días.

CAPÍTULO 05 · 1 EJEMPLOS

Privacidad y seguridad

Los comandos con credenciales se excluyen antes de clasificarse y registrarse.

01COMPORTAMIENTO

Protección de credenciales

Los comandos habituales de inicio de sesión, contraseñas, PIN y códigos temporales se excluyen antes de la supervisión y el registro.

COMPORTAMIENTO
login / register / password / PIN / OTP
→ excluidos de la supervisión en vivo
→ excluidos de commands.log

Protección interna

QUÉ HACE

Los comandos habituales de inicio de sesión, contraseñas, PIN y códigos temporales se excluyen antes de la supervisión y el registro.

COMPORTAMIENTO IMPORTANTE

  • Los argumentos sensibles nunca se muestran al staff.
  • Los registros de auditoría pueden seguir conteniendo conversaciones privadas y otros argumentos de comandos: restringe el acceso a la carpeta del mod.
  • La clasificación separa mensajes privados, comandos normales de jugadores y comandos de consola.

Antes de usar un ejemplo

Las opciones de registro no conceden permisos de supervisión en vivo.

El panel y los comandos personales no cambian los permisos asignados por el sistema de permisos.

Los comandos con credenciales sensibles se filtran antes de poder mostrarse o escribirse en los registros.

VOLVER ARRIBA