HyTari Studios · Guia oficial de configuração

CommandSpy

Controle o que é monitorado, por quem e por quanto tempo.

O CommandSpy separa monitorização em tempo real, permissões pessoais e auditoria local. Este guia mostra como configurar categorias, painel da equipa, logs e proteção para comandos sensíveis.

INICIAR O GUIA PÁGINA DO MOD

ANTES DE COMEÇAR

Primeiros passos

PASSO 01

Instale o JAR

Coloque apenas uma versão do CommandSpy na pasta mods e reinicie o servidor.

PASSO 02

Atribua permissões

Conceda à equipa somente as categorias de monitorização realmente necessárias.

PASSO 03

Configure a retenção

Escolha quais eventos armazenar e por quantos dias mantê-los.

Os logs podem conter comandos e conversas privadas. Restrinja o acesso a mods/CommandSpy e utilize permissões mínimas para a equipa.

CAPÍTULO 01 · 1 EXEMPLOS

Instalação e ficheiros

Onde são criados configuração, estados da equipa e logs.

01ESTRUTURA

Ficheiros criados pelo mod

O CommandSpy mantém configuração, estado pessoal da equipa e um único log de auditoria persistente.

ESTRUTURA

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

mods/CommandSpy/

O QUE FAZ

O CommandSpy mantém configuração, estado pessoal da equipa e um único log de auditoria persistente.

COMPORTAMENTO IMPORTANTE

Os estados só são guardados para membros da equipa com o CommandSpy ativo.
commands.log é persistente e limpo conforme a retenção configurada.
O mod não envia os dados monitorizados para fora do servidor.

CAPÍTULO 02 · 1 EXEMPLOS

Permissões

Separe acesso total, mensagens privadas, comandos de jogadores e console.

01PERMISSÕES

Permissões independentes

As categorias de monitorização podem ser atribuídas separadamente de acordo com a função da equipa.

PERMISSÕES

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

Plugin de permissões / permissões do servidor

O QUE FAZ

As categorias de monitorização podem ser atribuídas separadamente de acordo com a função da equipa.

COMPORTAMENTO IMPORTANTE

command.spy concede acesso total e /cmdspy reload.
command.spy.messages cobre comandos reconhecidos de mensagens privadas.
command.spy.commands cobre comandos comuns dos jogadores.
command.spy.console permite monitorar comandos executados pelo console.

CAPÍTULO 03 · 1 EXEMPLOS

Comandos e painel

Cada membro da equipa controla suas próprias categorias de monitorização.

01COMANDOS

Controles pessoais da equipa

O interruptor geral e os filtros por categoria são pessoais e também podem ser gerenciados pelo painel gráfico.

COMANDOS

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

Comandos no jogo

O QUE FAZ

O interruptor geral e os filtros por categoria são pessoais e também podem ser gerenciados pelo painel gráfico.

COMPORTAMENTO IMPORTANTE

Categorias sem permissão continuam visíveis no painel, mas não podem ser alteradas.
As preferências ativas são salvas imediatamente.
Ao desativar o interruptor geral, o estado guardado é removido e os padrões voltam na próxima ativação.

CAPÍTULO 04 · 1 EXEMPLOS

Logs e retenção

Escolha quais categorias vão para o ficheiro de auditoria e por quantos dias.

01JSON

Configuração do log de auditoria

O registo em ficheiro é independente das permissões em tempo real e dos filtros pessoais da equipa.

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

O QUE FAZ

O registo em ficheiro é independente das permissões em tempo real e dos filtros pessoais da equipa.

COMPORTAMENTO IMPORTANTE

Cada categoria pode ser registrada ou excluída separadamente.
log-retention-days remove automaticamente linhas antigas do ficheiro persistente.
A retenção padrão é de 15 dias.

CAPÍTULO 05 · 1 EXEMPLOS

Privacidade e segurança

Comandos com credenciais são excluídos antes da classificação e do registo.

01COMPORTAMENTO

Proteção de credenciais

Comandos comuns de login, senha, PIN e códigos temporários são excluídos antes do monitorização e do registo.

COMPORTAMENTO

login / register / password / PIN / OTP
→ excluídos do monitorização em tempo real
→ excluídos de commands.log

Proteção interna

O QUE FAZ

Comandos comuns de login, senha, PIN e códigos temporários são excluídos antes do monitorização e do registo.

COMPORTAMENTO IMPORTANTE

Argumentos sensíveis nunca são mostrados à equipa.
Os logs de auditoria ainda podem conter conversas privadas e outros argumentos de comandos; restrinja o acesso à pasta do mod.
A classificação separa mensagens privadas, comandos comuns de jogadores e comandos do console.

Antes de utilizar um exemplo

As opções de logging não concedem permissões de monitorização em tempo real.

O painel e os comandos pessoais não alteram as permissões atribuídas pelo sistema de permissões.

Comandos com credenciais sensíveis são filtrados antes de poderem ser exibidos ou gravados nos logs.

VOLTAR AO TOPO