CocoLogger

# CocoLogger # French ## Scroll down for english version CocoLogger est un plugin de logging avancé pour serveurs Minecraft Spigot/Paper 1.21.4. Il permet de tracer toutes les actions des joueurs sur le serveur avec une interface web moderne pour consulter et analyser les données. ## Présentation Ce plugin a été développé pour répondre aux besoins de surveillance et d'investigation sur les serveurs Minecraft. Il enregistre automatiquement toutes les actions importantes des joueurs et fournit une interface web intuitive pour consulter ces informations. ### Principales fonctionnalités **Système de logging complet** - Enregistrement des blocs placés et détruits avec coordonnées exactes - Suivi des interactions avec les items (utilisation, clics) - Logging des panneaux avec contenu complet (écriture et modifications) - Horodatage précis de toutes les actions - Identification des joueurs par nom et UUID **Interface web moderne** - Dashboard avec statistiques en temps réel - Système d'authentification sécurisé par JWT - Filtres avancés par joueur, type d'action, période - Recherche libre dans les logs - Affichage des textures des items et têtes de joueurs - Design responsive adapté mobile et desktop - Pagination intelligente pour les gros volumes de données **Base de données flexible** - Base H2 intégrée par défaut (aucune configuration requise) - Support MySQL optionnel avec basculement automatique - Optimisations de performance avec traitement par lots - Sauvegarde automatique configurable ## Installation ### Prérequis - Serveur Spigot ou Paper version 1.21.4 - Java 17 ou supérieur ### Étapes d'installation 1. Téléchargez le fichier `CocoLogger.jar` depuis le dossier `target/` 2. Placez le fichier dans le dossier `plugins/` de votre serveur 3. Démarrez ou redémarrez votre serveur 4. Le plugin créera automatiquement sa configuration dans `plugins/CocoLogger/` Au premier démarrage, CocoLogger génère automatiquement : - Le fichier de configuration `config.yml` - La base de données H2 locale - Les dossiers nécessaires au fonctionnement ## Configuration ### Configuration de base Le fichier `config.yml` contient toutes les options de configuration : ```yaml # Configuration de la base de données database: type: "H2" # H2 ou MYSQL h2: file: "plugins/CocoLogger/database.db" mysql: host: "localhost" port: 3306 database: "cocologger" username: "root" password: "password" useSSL: false # Interface web web: port: 8767 auth: username: "admin" password: "ChangeMoi123!" jwt_secret: "CocoLogger_Secret_Key_Change_Me_In_Production" jwt_expiry_hours: 24 ``` ### Configuration du logging Vous pouvez activer ou désactiver chaque type de logging : ```yaml logging: blocks: enabled: true place: true # Blocs placés break: true # Blocs détruits items: enabled: true use: true # Utilisation d'items interact: true # Interactions left_click: false right_click: false signs: enabled: true write: true # Écriture sur panneaux edit: true # Modification de panneaux ``` ### Optimisation des performances ```yaml performance: batch_size: 100 # Taille des lots pour l'insertion save_interval: 30 # Intervalle de sauvegarde (secondes) max_memory_entries: 1000 # Entrées max en mémoire ``` ## Utilisation ### Commandes disponibles Toutes les commandes nécessitent la permission `cocologger.admin` : - `/cocologger reload` - Recharge la configuration - `/cocologger status` - Affiche le statut du plugin - `/cocologger web` - Informations sur l'interface web - `/clog` ou `/cl` - Alias pour les commandes ### Permissions | Permission | Description | Par défaut | |------------|-------------|------------| | `cocologger.admin` | Accès aux commandes administrateur | Opérateurs | | `cocologger.exempt` | Exemption du logging | Aucun | ### Interface web L'interface web est accessible à l'adresse `http://ipduserveur:8767` **Connexion par défaut :** - Nom d'utilisateur : `admin` - Mot de passe : `ChangeMoi123!` **Fonctionnalités de l'interface :** - Vue d'ensemble avec statistiques globales - Filtrage par joueur, type d'action, période - Recherche textuelle dans tous les champs - Affichage des coordonnées et mondes - Navigation par pages pour les gros volumes ## Base de données ### Mode H2 (par défaut) Le mode H2 ne nécessite aucune configuration. La base de données est créée automatiquement dans le dossier du plugin. Ce mode convient parfaitement pour la plupart des serveurs. ### Mode MySQL Pour utiliser MySQL, modifiez la configuration : ```yaml database: type: "MYSQL" mysql: host: "votre-serveur-mysql" port: 3306 database: "cocologger" username: "votre-utilisateur" password: "votre-mot-de-passe" ``` Le plugin créera automatiquement les tables nécessaires. En cas d'échec de connexion MySQL, il basculera automatiquement vers H2. ## Dépannage