CocoBans - Plugin de sanctions pour Velocity

v1.1.0
Scroll down for English version

Français

CocoBans est un plugin complet de gestion des sanctions pour les serveurs Minecraft utilisant Velocity. Développé par Lechat, il offre une solution robuste et performante pour administrer les sanctions sur votre serveur.

Caractéristiques principales

• 25 commandes fonctionnelles pour une gestion complète des sanctions
• Support multi-base de données (SQLite par défaut, MySQL optionnel)
• Système de logs avancé avec fichier dédié et consultation en jeu
• Templates prédéfinis pour une application rapide des sanctions courantes
• Statistiques détaillées avec métriques complètes
• Configuration entièrement personnalisable avec plus de 80 messages configurables
• Système de prison avancé avec surveillance continue et redirection automatique
• Système de sécurité renforcé avec protections anti-abus
• Performances optimisées avec requêtes asynchrones et cache intelligent

Types de sanctions supportés

Sanctions joueurs

• Ban - Bannissement temporaire ou permanent
• Mute - Réduction au silence dans le chat
• Kick - Expulsion immédiate du serveur
• Warn - Avertissement sans déconnexion
• Jail - Redirection vers un serveur de prison

Sanctions IP

• BanIP - Bannissement d'une adresse IP complète
• MuteIP - Réduction au silence de tous les joueurs d'une IP
• KickIP - Expulsion de tous les joueurs connectés depuis une IP
• JailIP - Prison pour une adresse IP complète

Nouvelles fonctionnalités

• Système de prison amélioré avec redirection automatique vers le serveur de prison
• Surveillance asynchrone de la prison toutes les 5 secondes avec vérification continue
• Messages informatifs configurables lors de la redirection des joueurs vers la prison
• Nouvelles commandes /unjail et /unjailip pour libérer les joueurs et IPs emprisonnés
• Commande /jailip complétée avec support complet pour les sanctions IP
• Correction de l'autocomplétion pour la commande /mute avec suggestions de durée
• Messages entièrement configurables - Plus de 80 messages personnalisables
• Analyse améliorée des arguments pour toutes les commandes de prison
• Validation robuste des types de prison avec support multi-serveurs

Corrections de bugs

• Correction de l'analyse du temps permanent pour les sanctions (maintenant "perm" fonctionne correctement)
• Correction des erreurs de syntaxe YAML dans la configuration (séparateurs et autres)
• Correction des messages d'utilisation des commandes avec syntaxe complète
• Correction de l'analyse des arguments pour les commandes de prison (durée et raison)
• Correction de la validation du type de prison (utilise "default" au lieu du nom du serveur)
• Correction de l'autocomplétion pour /mute avec suggestions de durée
• Correction des chaînes codées en dur - Tous les messages sont désormais configurables

Installation

Installation rapide

1. Téléchargez le fichier JAR depuis les releases
2. Placez-le dans le dossier plugins/ de votre serveur Velocity
3. Redémarrez le serveur
4. Le plugin créera automatiquement sa configuration
5. Mettez à jour votre config.yml si vous mettez à niveau depuis une version précédente pour bénéficier des nouvelles options de configuration

Configuration

Le plugin génère automatiquement un fichier config.yml complet avec toutes les options disponibles. Vous pouvez personnaliser :

• Messages et notifications (plus de 80 messages entièrement configurables)
• Paramètres de base de données (SQLite par défaut, MySQL supporté)
• Permissions et commandes
• Templates de sanctions prédéfinis
• Options de broadcast et alertes
• Durées par défaut pour les sanctions
• Support pour plusieurs types de prisons et serveurs
• Configuration des jails avec serveurs personnalisés

Commandes disponibles

Sanctions de base

/ban <joueur> <durée> <raison>     - Bannir un joueur
/mute <joueur> <durée> <raison>    - Mute un joueur  
/kick <joueur> <raison>            - Expulser un joueur
/warn <joueur> <raison>            - Avertir un joueur

Sanctions IP

/banip <ip> <durée> <raison>       - Bannir une adresse IP
/muteip <ip> <durée> <raison>      - Mute une adresse IP
/kickip <ip> <raison>              - Expulser une adresse IP

Sanctions de prison

/jail <joueur> <durée> <raison> <type> - Emprisonner un joueur
/jailip <ip> <durée> <raison> <type> - Emprisonner une adresse IP
/jailban <joueur> <durée> <raison> - Bannir et emprisonner un joueur
/jailbanip <ip> <durée> <raison> - Bannir et emprisonner une adresse IP
/unjail <joueur> - Libérer un joueur de prison
/unjailip <ip> - Libérer une adresse IP de prison

Révoquer les sanctions

/unban <joueur>                    - Débannir un joueur
/unmute <joueur>                   - Démute un joueur
/unjail <joueur>                   - Libérer un joueur de prison
/unjailip <ip>                     - Libérer une adresse IP de prison

Informations

/check <joueur>                    - Vérifier les sanctions actives
/history <joueur>                  - Consulter l'historique complet

Administration

/cocobans reload                   - Recharger la configuration
/cocobans info                     - Informations du plugin
/cbstats                          - Statistiques détaillées
/cbtemplate list                  - Lister les templates
/cbtemplate use <template> <joueur> - Appliquer un template
/cblogs [lignes]                  - Consulter les logs

Système de permissions

Permissions de base

• cocobans.admin - Accès administrateur complet
• cocobans.ban - Permission de bannir
• cocobans.mute - Permission de muter
• cocobans.kick - Permission d'expulser
• cocobans.warn - Permission d'avertir
• cocobans.unban - Permission de débannir
• cocobans.unmute - Permission de démuter
• cocobans.check - Permission de vérifier les sanctions
• cocobans.history - Permission de consulter l'historique

Permissions IP

• cocobans.banip - Permission de bannir par IP
• cocobans.muteip - Permission de muter par IP
• cocobans.kickip - Permission d'expulser par IP

Permissions de bypass

• cocobans.bypass.ban - Immunité contre les bans
• cocobans.bypass.mute - Immunité contre les mutes
• cocobans.bypass.kick - Immunité contre les kicks

Permissions spéciales

• cocobans.alerts - Recevoir les notifications de sanctions

Formats de durée

Le plugin accepte plusieurs formats de durée, par exemple :

• 30s - 30 secondes
• 5m - 5 minutes
• 2h - 2 heures
• 7d - 7 jours
• perm - Permanent

Templates prédéfinis

Le plugin inclut des templates pour les sanctions courantes :

• grief - Ban 7 jours pour grief
• spam - Mute 1 heure pour spam
• insultes - Mute 6 heures pour insultes
• hack - Ban permanent pour hack
• pub - Kick pour publicité
• avertissement - Warn général

Base de données

SQLite (par défaut)

Aucune configuration requise. La base de données est créée automatiquement dans le dossier du plugin.

MySQL (optionnel)

Configurez les paramètres de connexion dans config.yml :

database:
  type: "mysql"
  host: "localhost"
  port: 3306
  database: "cocobans"
  username: "votre_utilisateur"
  password: "votre_mot_de_passe"

Prérequis techniques

• Java 17 ou supérieur
• Velocity 3.2.0 ou supérieur
• Minecraft 1.19 ou supérieur

Support et documentation

Pour obtenir de l'aide, contactez moi sur Discord : @lechat87

---

English

CocoBans is a comprehensive sanctions management plugin for Minecraft servers using Velocity. Developed by Lechat, it provides a robust and performant solution for administering sanctions on your server.

Key Features

• 25 functional commands for complete sanctions management
• Multi-database support (SQLite by default, MySQL optional)
• Advanced logging system with dedicated file and in-game consultation
• Predefined templates for quick application of common sanctions
• Detailed statistics with comprehensive metrics
• Fully customizable configuration with 80+ configurable messages
• Advanced jail system with continuous monitoring and automatic redirection
• Enhanced security system with anti-abuse protections
• Optimized performance with asynchronous queries and intelligent caching

Supported Sanction Types

Player Sanctions

• Ban - Temporary or permanent banishment
• Mute - Chat silencing
• Kick - Immediate server expulsion
• Warn - Warning without disconnection
• Jail - Redirection to a jail server

IP Sanctions

• BanIP - Complete IP address banishment
• MuteIP - Silencing all players from an IP
• KickIP - Expulsion of all players connected from an IP
• JailIP - Jail for a complete IP address

New Features

• Improved jail system with automatic server redirection
• Asynchronous jail monitoring every 5 seconds with continuous verification
• Configurable informative messages when players are redirected to jail
• New /unjail and /unjailip commands to release jailed players and IPs
• Completed /jailip command with full IP sanction support
• Fixed /mute command autocomplete with duration suggestions
• Fully configurable messages - 80+ customizable messages
• Enhanced argument parsing for all jail commands
• Robust jail type validation with multi-server support

Bug Fixes

• Fixed permanent time parsing for sanctions ("perm" now works correctly)
• Fixed YAML syntax errors in configuration (separators and other issues)
• Fixed command usage messages with complete syntax
• Fixed argument parsing for jail commands (duration and reason handling)
• Fixed jail type validation (uses "default" instead of server name)
• Fixed autocomplete for /mute with duration suggestions
• Fixed hardcoded strings - All messages are now configurable

Installation

Quick Installation

1. Download the JAR file from releases
2. Place it in your Velocity server's plugins/ folder
3. Restart the server
4. The plugin will automatically create its configuration
5. Update your config.yml if upgrading from previous versions to take advantage of new configuration options

Configuration

The plugin automatically generates a complete config.yml file with all available options. You can customize:

• Messages and notifications (80+ fully configurable messages)
• Database parameters (SQLite default, MySQL supported)
• Permissions and commands
• Predefined sanction templates
• Broadcast and alert options
• Default sanction durations
• Support for multiple jail types and servers
• Jail configuration with custom servers

Available Commands

Basic Sanctions

/ban <player> <duration> <reason>     - Ban a player
/mute <player> <duration> <reason>    - Mute a player
/kick <player> <reason>               - Kick a player
/warn <player> <reason>               - Warn a player

IP Sanctions

/banip <ip> <duration> <reason>       - Ban an IP address
/muteip <ip> <duration> <reason>      - Mute an IP address
/kickip <ip> <reason>                 - Kick an IP address

Jail Sanctions

/jail <player> <duration> <reason> <type> - Jail a player
/jailip <ip> <duration> <reason> <type> - Jail an IP address
/jailban <player> <duration> <reason> - Ban and jail a player
/jailbanip <ip> <duration> <reason> - Ban and jail an IP address
/unjail <player> - Release a player from jail
/unjailip <ip> - Release an IP address from jail

Revocations

/unban <player>                       - Unban a player
/unmute <player>                      - Unmute a player
/unjail <player>                      - Release a player from jail
/unjailip <ip>                        - Release an IP address from jail

Information

/check <player>                       - Check active sanctions
/history <player>                     - View complete history

Administration

/cocobans reload                      - Reload configuration
/cocobans info                        - Plugin information
/cbstats                             - Detailed statistics
/cbtemplate list                     - List templates
/cbtemplate use <template> <player>   - Apply a template
/cblogs [lines]                      - View logs

Permission System

Basic Permissions

• cocobans.admin - Full administrator access
• cocobans.ban - Permission to ban
• cocobans.mute - Permission to mute
• cocobans.kick - Permission to kick
• cocobans.warn - Permission to warn
• cocobans.unban - Permission to unban
• cocobans.unmute - Permission to unmute
• cocobans.check - Permission to check sanctions
• cocobans.history - Permission to view history

IP Permissions

• cocobans.banip - Permission to ban by IP
• cocobans.muteip - Permission to mute by IP
• cocobans.kickip - Permission to kick by IP

Bypass Permissions

• cocobans.bypass.ban - Immunity against bans
• cocobans.bypass.mute - Immunity against mutes
• cocobans.bypass.kick - Immunity against kicks

Special Permissions

• cocobans.alerts - Receive sanction notifications

Duration Formats

The plugin accepts several duration formats, like :

• 30s - 30 seconds
• 5m - 5 minutes
• 2h - 2 hours
• 7d - 7 days
• perm - Permanent

Predefined Templates

The plugin includes templates for common sanctions:

• grief - 7-day ban for griefing
• spam - 1-hour mute for spam
• insultes - 6-hour mute for insults
• hack - Permanent ban for hacking
• pub - Kick for advertising
• avertissement - General warning

Database

SQLite (default)

No configuration required. The database is automatically created in the plugin folder.

MySQL (optional)

Configure connection parameters in config.yml:

database:
  type: "mysql"
  host: "localhost"
  port: 3306
  database: "cocobans"
  username: "your_username"
  password: "your_password"

Technical Requirements

• Java 17 or higher
• Velocity 3.2.0 or higher
• Minecraft 1.19 or higher

Support and Documentation

For help, contact me on Discord : @lechat87

---

Author

Lechat_