HyTari Studios · Guida ufficiale alla configurazione

CommandSpy

Controlla cosa viene monitorato, da chi e per quanto tempo.

CommandSpy separa monitoraggio live, permessi personali e audit locale. Questa guida mostra come configurare le categorie, il pannello staff, i log e le protezioni per i comandi sensibili.

INIZIA LA GUIDA PAGINA MOD

PRIMA DI INIZIARE

Per iniziare

PASSO 01

Installa il JAR

Metti una sola versione di CommandSpy nella cartella mods e riavvia il server.

PASSO 02

Assegna i permessi

Concedi allo staff solo le categorie realmente necessarie.

PASSO 03

Configura retention

Scegli quali eventi salvare e per quanti giorni conservarli.

I log possono contenere comandi e conversazioni private. Proteggi l'accesso a mods/CommandSpy e usa permessi staff minimali.

CAPITOLO 01 · 1 ESEMPI

Installazione e file

Dove vengono creati configurazione, stati staff e log.

01STRUTTURA

File creati dalla mod

CommandSpy mantiene configurazione, stato personale dello staff e un unico audit log persistente.

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

mods/CommandSpy/

COSA FA

CommandSpy mantiene configurazione, stato personale dello staff e un unico audit log persistente.

COMPORTAMENTO IMPORTANTE

  • Gli stati vengono salvati solo per staff con CommandSpy attivo.
  • Il file commands.log è persistente e viene ripulito in base alla retention.
  • La mod non invia dati monitorati fuori dal server.

CAPITOLO 02 · 1 ESEMPI

Permessi

Separa accesso completo, messaggi privati, comandi giocatori e console.

01PERMESSI

Permessi indipendenti

Le categorie possono essere assegnate separatamente in base al ruolo dello staff.

PERMESSI
command.spy
command.spy.messages
command.spy.commands
command.spy.console

Permission plugin / server permissions

COSA FA

Le categorie possono essere assegnate separatamente in base al ruolo dello staff.

COMPORTAMENTO IMPORTANTE

  • command.spy concede accesso completo e /cmdspy reload.
  • command.spy.messages copre i private-message commands riconosciuti.
  • command.spy.commands copre i normali comandi dei giocatori.
  • command.spy.console permette di vedere i comandi eseguiti dalla console.

CAPITOLO 03 · 1 ESEMPI

Comandi e pannello

Ogni membro dello staff controlla le proprie categorie di monitoraggio.

01COMANDI

Controlli personali dello staff

Il master switch e i filtri per categoria sono personali e possono essere gestiti anche dal pannello grafico.

COMANDI
/cmdspy
/cmdspy messages
/cmdspy commands
/cmdspy console
/cmdspy gui
/cmdspy reload

Comandi in gioco

COSA FA

Il master switch e i filtri per categoria sono personali e possono essere gestiti anche dal pannello grafico.

COMPORTAMENTO IMPORTANTE

  • Le categorie senza permesso restano visibili nel pannello ma non sono modificabili.
  • Le preferenze attive vengono salvate immediatamente.
  • Disattivando il master switch, lo stato salvato viene rimosso e al prossimo utilizzo tornano i default.

CAPITOLO 04 · 1 ESEMPI

Logging e retention

Decidi quali categorie finiscono nel file audit e per quanti giorni.

01JSON

Configurazione del log audit

Il logging su file è indipendente dai permessi live e dai filtri personali dello 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

COSA FA

Il logging su file è indipendente dai permessi live e dai filtri personali dello staff.

COMPORTAMENTO IMPORTANTE

  • Ogni categoria può essere registrata o esclusa in modo indipendente.
  • log-retention-days rimuove automaticamente le righe più vecchie dal file persistente.
  • Il default è 15 giorni.

CAPITOLO 05 · 1 ESEMPI

Privacy e sicurezza

I comandi con credenziali vengono esclusi prima della classificazione e del logging.

01COMPORTAMENTO

Protezione delle credenziali

Comandi tipicamente usati per login, password, PIN e codici temporanei vengono esclusi prima del monitoraggio e del log.

COMPORTAMENTO
login / register / password / PIN / OTP
→ esclusi dal live monitoring
→ esclusi da commands.log

Protezione interna

COSA FA

Comandi tipicamente usati per login, password, PIN e codici temporanei vengono esclusi prima del monitoraggio e del log.

COMPORTAMENTO IMPORTANTE

  • Gli argomenti sensibili non vengono mostrati allo staff.
  • Gli audit log possono comunque contenere conversazioni private e altri argomenti di comando: limita l'accesso alla cartella della mod.
  • La classificazione distingue messaggi privati, normali comandi giocatore e console.

Prima di usare un esempio

Le opzioni di logging non concedono permessi di monitoraggio live.

Il pannello e i comandi personali non cambiano le autorizzazioni assegnate dal sistema permessi.

I comandi con credenziali sensibili vengono filtrati prima che possano essere mostrati o scritti nei log.

TORNA SU