# CocoLogger<\/p>\n
# French
\n## Scroll down for english version <\/p>\n
CocoLogger est un plugin de logging avanc\u00e9 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\u00e9es.<\/p>\n
## Pr\u00e9sentation<\/p>\n
Ce plugin a \u00e9t\u00e9 d\u00e9velopp\u00e9 pour r\u00e9pondre 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.<\/p>\n
### Principales fonctionnalit\u00e9s<\/p>\n
**Syst\u00e8me de logging complet**
\n– Enregistrement des blocs plac\u00e9s et d\u00e9truits avec coordonn\u00e9es exactes
\n– Suivi des interactions avec les items (utilisation, clics)
\n– Logging des panneaux avec contenu complet (\u00e9criture et modifications)
\n– Horodatage pr\u00e9cis de toutes les actions
\n– Identification des joueurs par nom et UUID<\/p>\n
**Interface web moderne**
\n– Dashboard avec statistiques en temps r\u00e9el
\n– Syst\u00e8me d’authentification s\u00e9curis\u00e9 par JWT
\n– Filtres avanc\u00e9s par joueur, type d’action, p\u00e9riode
\n– Recherche libre dans les logs
\n– Affichage des textures des items et t\u00eates de joueurs
\n– Design responsive adapt\u00e9 mobile et desktop
\n– Pagination intelligente pour les gros volumes de donn\u00e9es<\/p>\n
**Base de donn\u00e9es flexible**
\n– Base H2 int\u00e9gr\u00e9e par d\u00e9faut (aucune configuration requise)
\n– Support MySQL optionnel avec basculement automatique
\n– Optimisations de performance avec traitement par lots
\n– Sauvegarde automatique configurable<\/p>\n
## Installation<\/p>\n
### Pr\u00e9requis
\n– Serveur Spigot ou Paper version 1.21.4
\n– Java 17 ou sup\u00e9rieur<\/p>\n
### \u00c9tapes d’installation<\/p>\n
1. T\u00e9l\u00e9chargez le fichier `CocoLogger.jar` depuis le dossier `target\/`
\n2. Placez le fichier dans le dossier `plugins\/` de votre serveur
\n3. D\u00e9marrez ou red\u00e9marrez votre serveur
\n4. Le plugin cr\u00e9era automatiquement sa configuration dans `plugins\/CocoLogger\/`<\/p>\n
Au premier d\u00e9marrage, CocoLogger g\u00e9n\u00e8re automatiquement :
\n– Le fichier de configuration `config.yml`
\n– La base de donn\u00e9es H2 locale
\n– Les dossiers n\u00e9cessaires au fonctionnement<\/p>\n
## Configuration<\/p>\n
### Configuration de base<\/p>\n
Le fichier `config.yml` contient toutes les options de configuration :<\/p>\n
“`yaml
\n# Configuration de la base de donn\u00e9es
\ndatabase:
\n type: “H2” # H2 ou MYSQL
\n h2:
\n file: “plugins\/CocoLogger\/database.db”
\n mysql:
\n host: “localhost”
\n port: 3306
\n database: “cocologger”
\n username: “root”
\n password: “password”
\n useSSL: false<\/p>\n
# Interface web
\nweb:
\n port: 8767
\n auth:
\n username: “admin”
\n password: “ChangeMoi123!”
\n jwt_secret: “CocoLogger_Secret_Key_Change_Me_In_Production”
\n jwt_expiry_hours: 24
\n“`<\/p>\n
### Configuration du logging<\/p>\n
Vous pouvez activer ou d\u00e9sactiver chaque type de logging :<\/p>\n
“`yaml
\nlogging:
\n blocks:
\n enabled: true
\n place: true # Blocs plac\u00e9s
\n break: true # Blocs d\u00e9truits
\n items:
\n enabled: true
\n use: true # Utilisation d’items
\n interact: true # Interactions
\n left_click: false
\n right_click: false
\n signs:
\n enabled: true
\n write: true # \u00c9criture sur panneaux
\n edit: true # Modification de panneaux
\n“`<\/p>\n
### Optimisation des performances<\/p>\n
“`yaml
\nperformance:
\n batch_size: 100 # Taille des lots pour l’insertion
\n save_interval: 30 # Intervalle de sauvegarde (secondes)
\n max_memory_entries: 1000 # Entr\u00e9es max en m\u00e9moire
\n“`<\/p>\n
## Utilisation<\/p>\n
### Commandes disponibles<\/p>\n
Toutes les commandes n\u00e9cessitent la permission `cocologger.admin` :<\/p>\n
– `\/cocologger reload` – Recharge la configuration
\n– `\/cocologger status` – Affiche le statut du plugin
\n– `\/cocologger web` – Informations sur l’interface web
\n– `\/clog` ou `\/cl` – Alias pour les commandes<\/p>\n
### Permissions<\/p>\n
| Permission | Description | Par d\u00e9faut |
\n|————|————-|————|
\n| `cocologger.admin` | Acc\u00e8s aux commandes administrateur | Op\u00e9rateurs |
\n| `cocologger.exempt` | Exemption du logging | Aucun |<\/p>\n
### Interface web<\/p>\n
L’interface web est accessible \u00e0 l’adresse `http:\/\/ipduserveur:8767`<\/p>\n
**Connexion par d\u00e9faut :**
\n– Nom d’utilisateur : `admin`
\n– Mot de passe : `ChangeMoi123!`<\/p>\n
**Fonctionnalit\u00e9s de l’interface :**
\n– Vue d’ensemble avec statistiques globales
\n– Filtrage par joueur, type d’action, p\u00e9riode
\n– Recherche textuelle dans tous les champs
\n– Affichage des coordonn\u00e9es et mondes
\n– Navigation par pages pour les gros volumes<\/p>\n
## Base de donn\u00e9es<\/p>\n
### Mode H2 (par d\u00e9faut)<\/p>\n
Le mode H2 ne n\u00e9cessite aucune configuration. La base de donn\u00e9es est cr\u00e9\u00e9e automatiquement dans le dossier du plugin. Ce mode convient parfaitement pour la plupart des serveurs.<\/p>\n
### Mode MySQL<\/p>\n
Pour utiliser MySQL, modifiez la configuration :<\/p>\n
“`yaml
\ndatabase:
\n type: “MYSQL”
\n mysql:
\n host: “votre-serveur-mysql”
\n port: 3306
\n database: “cocologger”
\n username: “votre-utilisateur”
\n password: “votre-mot-de-passe”
\n“`<\/p>\n
Le plugin cr\u00e9era automatiquement les tables n\u00e9cessaires. En cas d’\u00e9chec de connexion MySQL, il basculera automatiquement vers H2.<\/p>\n
## D\u00e9pannage<\/p>\n
### Le plugin ne d\u00e9marre pas<\/p>\n
1. V\u00e9rifiez que vous utilisez Java 17 ou sup\u00e9rieur
\n2. Assurez-vous d’avoir Spigot\/Paper 1.21.4
\n3. Consultez les logs du serveur pour les erreurs d\u00e9taill\u00e9es
\n4. V\u00e9rifiez les permissions du dossier plugins<\/p>\n
### L’interface web n’est pas accessible<\/p>\n
1. V\u00e9rifiez que le port configur\u00e9 (8767 par d\u00e9faut) n’est pas utilis\u00e9
\n2. Contr\u00f4lez les r\u00e8gles de firewall de votre serveur
\n3. Testez l’acc\u00e8s local avec `http:\/\/localhost:8767`
\n4. V\u00e9rifiez les logs du plugin pour les erreurs de d\u00e9marrage web<\/p>\n
### Probl\u00e8mes de base de donn\u00e9es<\/p>\n
1. En mode H2, v\u00e9rifiez les permissions d’\u00e9criture dans le dossier plugins
\n2. En mode MySQL, testez la connexion avec les param\u00e8tres configur\u00e9s
\n3. Le plugin bascule automatiquement vers H2 en cas d’\u00e9chec MySQL
\n4. Consultez les logs pour les d\u00e9tails des erreurs de connexion<\/p>\n
### Performances<\/p>\n
Si vous constatez des ralentissements :<\/p>\n
1. Augmentez la valeur `batch_size` dans la configuration
\n2. R\u00e9duisez `save_interval` pour des sauvegardes plus fr\u00e9quentes
\n3. D\u00e9sactivez le logging des actions moins importantes (clics gauche\/droit)
\n4. Utilisez MySQL pour de meilleures performances sur gros volumes<\/p>\n
## S\u00e9curit\u00e9<\/p>\n
### Recommandations importantes<\/p>\n
1. **Changez imm\u00e9diatement** le mot de passe par d\u00e9faut de l’interface web
\n2. **Modifiez la cl\u00e9 JWT** `jwt_secret` en production
\n3. **Limitez l’acc\u00e8s** au port de l’interface web via firewall
\n4. **Utilisez HTTPS** avec un reverse proxy pour l’acc\u00e8s externe
\n5. **Sauvegardez r\u00e9guli\u00e8rement** la base de donn\u00e9es<\/p>\n
### Configuration s\u00e9curis\u00e9e<\/p>\n
“`yaml
\nweb:
\n auth:
\n username: “admin”
\n password: “MotDePasseComplexe123!”
\n jwt_secret: “CleSecreteTresLongueEtComplexePourProduction”
\n jwt_expiry_hours: 8 # R\u00e9duire la dur\u00e9e de validit\u00e9
\n“`<\/p>\n
## Historique des versions<\/p>\n
### Version 1.0.0
\n– Syst\u00e8me de logging complet pour blocs, items et panneaux
\n– Interface web avec authentification JWT
\n– Support bases de donn\u00e9es H2 et MySQL
\n– Dashboard avec statistiques temps r\u00e9el
\n– API REST compl\u00e8te
\n– Filtres et recherche avanc\u00e9s
\n– Affichage des textures Minecraft
\n– Configuration flexible et optimisations de performance<\/p>\n
## Support<\/p>\n
Contactez moi sur Discord ! Je r\u00e9pondrais le plus rapidement possible.<\/p>\n
—<\/p>\n
CocoLogger par Lechat_ (@lechat_v2 sur discord pour toute demande)<\/p>\n
# English<\/p>\n
CocoLogger is an advanced logging plugin for Minecraft Spigot\/Paper 1.21.4 servers. It allows tracking all player actions on the server with a modern web interface for viewing and analyzing data.<\/p>\n
## Introduction<\/p>\n
This plugin was developed to meet the needs of monitoring and investigation on Minecraft servers. It automatically records all important player actions and provides an intuitive web interface to view this information.<\/p>\n
### Main Features<\/p>\n
**Complete logging system**
\n– Recording of placed and broken blocks with exact coordinates
\n– Tracking of item interactions (use, clicks)
\n– Logging of signs with full content (writing and modifications)
\n– Precise timestamp for all actions
\n– Player identification by name and UUID<\/p>\n
**Modern web interface**
\n– Dashboard with real-time statistics
\n– Secure authentication system with JWT
\n– Advanced filters by player, action type, period
\n– Free search in logs
\n– Display of item textures and player heads
\n– Responsive design for mobile and desktop
\n– Smart pagination for large data volumes<\/p>\n
**Flexible database**
\n– Integrated H2 database by default (no configuration required)
\n– Optional MySQL support with automatic failover
\n– Performance optimizations with batch processing
\n– Automatic backup configurable<\/p>\n
## Installation<\/p>\n
### Prerequisites
\n– Spigot or Paper server version 1.21.4
\n– Java 17 or higher<\/p>\n
### Installation Steps<\/p>\n
1. Download the `CocoLogger.jar` file from the `target\/` folder
\n2. Place the file in the `plugins\/` folder of your server
\n3. Start or restart your server
\n4. The plugin will automatically create its configuration in `plugins\/CocoLogger\/`<\/p>\n
On first launch, CocoLogger automatically generates:
\n– The configuration file `config.yml`
\n– The local H2 database
\n– Necessary folders for operation<\/p>\n
## Configuration<\/p>\n
### Basic Configuration<\/p>\n
The `config.yml` file contains all configuration options:<\/p>\n
“`yaml
\n# Database configuration
\ndatabase:
\n type: “H2” # H2 or MYSQL
\n h2:
\n file: “plugins\/CocoLogger\/database.db”
\n mysql:
\n host: “localhost”
\n port: 3306
\n database: “cocologger”
\n username: “root”
\n password: “password”
\n useSSL: false<\/p>\n
# Web interface
\nweb:
\n port: 8767
\n auth:
\n username: “admin”
\n password: “ChangeMoi123!”
\n jwt_secret: “CocoLogger_Secret_Key_Change_Me_In_Production”
\n jwt_expiry_hours: 24
\n“`<\/p>\n
### Logging Configuration<\/p>\n
You can enable or disable each type of logging:<\/p>\n
“`yaml
\nlogging:
\n blocks:
\n enabled: true
\n place: true # Blocks placed
\n break: true # Blocks broken
\n items:
\n enabled: true
\n use: true # Item use
\n interact: true # Interactions
\n left_click: false
\n right_click: false
\n signs:
\n enabled: true
\n write: true # Sign writing
\n edit: true # Sign editing
\n“`<\/p>\n
### Performance Optimization<\/p>\n
“`yaml
\nperformance:
\n batch_size: 100 # Batch size for insertion
\n save_interval: 30 # Save interval (seconds)
\n max_memory_entries: 1000 # Max entries in memory
\n“`<\/p>\n
## Usage<\/p>\n
### Available Commands<\/p>\n
All commands require the `cocologger.admin` permission:<\/p>\n
– `\/cocologger reload` – Reloads the configuration
\n– `\/cocologger status` – Displays the plugin status
\n– `\/cocologger web` – Web interface information
\n– `\/clog` or `\/cl` – Alias for commands<\/p>\n
### Permissions<\/p>\n
| Permission | Description | Default |
\n|————|————-|———|
\n| `cocologger.admin` | Access to admin commands | Operators |
\n| `cocologger.exempt` | Exemption from logging | None |<\/p>\n
### Web Interface<\/p>\n
The web interface is accessible at `http:\/\/ipduserveur:8767`<\/p>\n
**Default login:**
\n– Username: `admin`
\n– Password: `ChangeMoi123!`<\/p>\n
**Interface features:**
\n– Overview with global statistics
\n– Filtering by player, action type, period
\n– Text search in all fields
\n– Display of coordinates and worlds
\n– Pagination for large volumes<\/p>\n
## Database<\/p>\n
### H2 Mode (default)<\/p>\n
The H2 mode requires no configuration. The database is created automatically in the plugin folder. This mode is perfect for most servers.<\/p>\n
### MySQL Mode<\/p>\n
To use MySQL, modify the configuration:<\/p>\n
“`yaml
\ndatabase:
\n type: “MYSQL”
\n mysql:
\n host: “votre-serveur-mysql”
\n port: 3306
\n database: “cocologger”
\n username: “votre-utilisateur”
\n password: “votre-mot-de-passe”
\n“`<\/p>\n
The plugin will automatically create the necessary tables. In case of MySQL connection failure, it will automatically switch to H2.<\/p>\n
## Troubleshooting<\/p>\n
### The plugin does not start<\/p>\n
1. Verify that you are using Java 17 or higher
\n2. Make sure you have Spigot\/Paper 1.21.4
\n3. Check the server logs for detailed error messages
\n4. Verify the permissions of the plugins folder<\/p>\n
### The web interface is not accessible<\/p>\n
1. Verify that the configured port (8767 by default) is not in use
\n2. Check the server’s firewall rules
\n3. Test local access with `http:\/\/localhost:8767`
\n4. Check the plugin logs for startup errors<\/p>\n
### Database issues<\/p>\n
1. In H2 mode, verify write permissions in the plugins folder
\n2. In MySQL mode, test the connection with the configured parameters
\n3. The plugin automatically switches to H2 in case of MySQL connection failure
\n4. Check the logs for connection error details<\/p>\n
### Performance<\/p>\n
If you notice slowdowns:<\/p>\n
1. Increase the `batch_size` value in the configuration
\n2. Reduce `save_interval` for more frequent backups
\n3. Disable less important logging actions (left\/right clicks)
\n4. Use MySQL for better performance on large volumes<\/p>\n
## Security<\/p>\n
### Important Recommendations<\/p>\n
1. **Immediately change** the default password for the web interface
\n2. **Modify the JWT key** `jwt_secret` in production
\n3. **Limit access** to the web interface port via firewall
\n4. **Use HTTPS** with a reverse proxy for external access
\n5. **Regularly backup** the database<\/p>\n
### Secure Configuration<\/p>\n
“`yaml
\nweb:
\n auth:
\n username: “admin”
\n password: “MotDePasseComplexe123!”
\n jwt_secret: “CleSecreteTresLongueEtComplexePourProduction”
\n jwt_expiry_hours: 8 # Reduce validity period
\n“`<\/p>\n
## Version History<\/p>\n
### Version 1.0.0
\n– Complete logging system for blocks, items, and signs
\n– Web interface with JWT authentication
\n– Support for H2 and MySQL databases
\n– Dashboard with real-time statistics
\n– Complete REST API
\n– Advanced filtering and search
\n– Display of Minecraft textures
\n– Flexible configuration and performance optimizations<\/p>\n
## Support<\/p>\n
Contact me on Discord! I will respond as quickly as possible.<\/p>\n
—<\/p>\n
CocoLogger by Lechat_ (@lechat_v2 on discord for any requests)<\/p>\n","protected":false},"excerpt":{"rendered":"
A plugin designed for the Cocoworld server, logging all blocs\/signs actions into a database.<\/p>\n","protected":false},"featured_media":43576,"template":"","meta":{"_minecraft_slug":"cocologger","_minecraft_project_id":"EBOJw9Gg","_minecraft_author":"lechat","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":53,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"cocologger.zip","_minecraft_size_bytes":27548995,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T21:02:34.695625Z","_minecraft_date_created":"2025-08-13T20:21:05.777021Z","_minecraft_date_modified":"2025-10-23T10:23:20.265085Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/cocologger","_minecraft_icon_attachment_id":43576,"_minecraft_imported_at":"2026-06-02T00:29:44+00:00","_minecraft_import_hash":"f92ef91f9d3c02c42cc18c3875f16901","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,129,92],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-43575","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n