HyTari Studios · Guide officiel de configuration

CommandSpy

Contrôlez ce qui est surveillé, par qui et pendant combien de temps.

CommandSpy sépare la surveillance en direct, les permissions personnelles et l'audit local. Ce guide explique les catégories, le panneau du staff, les logs et la protection des commandes sensibles.

COMMENCER LE GUIDE PAGE DU MOD

AVANT DE COMMENCER

Bien démarrer

ÉTAPE 01

Installer le JAR

Placez une seule version de CommandSpy dans le dossier mods puis redémarrez le serveur.

ÉTAPE 02

Attribuer les permissions

N'accordez au staff que les catégories de surveillance réellement nécessaires.

ÉTAPE 03

Configurer la rétention

Choisissez les événements à conserver et pendant combien de jours.

Les logs peuvent contenir des commandes et des conversations privées. Limitez l'accès à mods/CommandSpy et utilisez des permissions staff minimales.

CHAPITRE 01 · 1 EXEMPLES

Installation et fichiers

Où sont créés la configuration, les états du staff et les logs.

01STRUCTURE

Fichiers créés par le mod

CommandSpy conserve la configuration, l'état personnel du staff et un journal d'audit persistant.

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

mods/CommandSpy/

CE QUE ÇA FAIT

CommandSpy conserve la configuration, l'état personnel du staff et un journal d'audit persistant.

COMPORTEMENT IMPORTANT

  • Les états ne sont enregistrés que pour le staff ayant CommandSpy activé.
  • commands.log est persistant et nettoyé selon la durée de rétention.
  • Le mod n'envoie aucune donnée surveillée hors du serveur.

CHAPITRE 02 · 1 EXEMPLES

Permissions

Séparez l'accès complet, les messages privés, les commandes joueurs et la console.

01PERMISSIONS

Permissions indépendantes

Les catégories de surveillance peuvent être attribuées séparément selon le rôle du staff.

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

Plugin de permissions / permissions serveur

CE QUE ÇA FAIT

Les catégories de surveillance peuvent être attribuées séparément selon le rôle du staff.

COMPORTEMENT IMPORTANT

  • command.spy donne l'accès complet et /cmdspy reload.
  • command.spy.messages couvre les commandes de messages privés reconnues.
  • command.spy.commands couvre les commandes normales des joueurs.
  • command.spy.console permet de voir les commandes exécutées par la console.

CHAPITRE 03 · 1 EXEMPLES

Commandes et panneau

Chaque membre du staff contrôle ses propres catégories de surveillance.

01COMMANDES

Contrôles personnels du staff

L'interrupteur principal et les filtres de catégories sont personnels et peuvent aussi être gérés depuis le panneau graphique.

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

Commandes en jeu

CE QUE ÇA FAIT

L'interrupteur principal et les filtres de catégories sont personnels et peuvent aussi être gérés depuis le panneau graphique.

COMPORTEMENT IMPORTANT

  • Les catégories sans permission restent visibles mais ne peuvent pas être modifiées.
  • Les préférences actives sont enregistrées immédiatement.
  • Quand l'interrupteur principal est désactivé, l'état sauvegardé est supprimé et les valeurs par défaut reviennent à la prochaine activation.

CHAPITRE 04 · 1 EXEMPLES

Logs et rétention

Choisissez les catégories écrites dans le journal d'audit et leur durée de conservation.

01JSON

Configuration du journal d'audit

La journalisation fichier est indépendante des permissions en direct et des filtres personnels du 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

CE QUE ÇA FAIT

La journalisation fichier est indépendante des permissions en direct et des filtres personnels du staff.

COMPORTEMENT IMPORTANT

  • Chaque catégorie peut être enregistrée ou exclue indépendamment.
  • log-retention-days supprime automatiquement les anciennes lignes du fichier persistant.
  • La rétention par défaut est de 15 jours.

CHAPITRE 05 · 1 EXEMPLES

Confidentialité et sécurité

Les commandes contenant des identifiants sont exclues avant classification et journalisation.

01COMPORTEMENT

Protection des identifiants

Les commandes courantes de connexion, mot de passe, PIN et codes temporaires sont exclues avant surveillance et journalisation.

COMPORTEMENT
login / register / password / PIN / OTP
→ exclus de la surveillance en direct
→ exclus de commands.log

Protection interne

CE QUE ÇA FAIT

Les commandes courantes de connexion, mot de passe, PIN et codes temporaires sont exclues avant surveillance et journalisation.

COMPORTEMENT IMPORTANT

  • Les arguments sensibles ne sont jamais affichés au staff.
  • Les journaux d'audit peuvent tout de même contenir des conversations privées et d'autres arguments de commande : limitez l'accès au dossier du mod.
  • La classification sépare messages privés, commandes joueurs normales et commandes console.

Avant d'utiliser un exemple

Les options de logging n'accordent aucune permission de surveillance en direct.

Le panneau et les commandes personnelles ne modifient pas les permissions attribuées par le système de permissions.

Les commandes contenant des identifiants sensibles sont filtrées avant de pouvoir être affichées ou enregistrées.

RETOUR EN HAUT