Cocobans

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

- Performances optimisées pour une gestion complète des sanctions - Performances optimisées (SQLite par défaut, MySQL optionnel) - Performances optimisées avec fichier dédié et consultation en jeu - Performances optimisées pour une application rapide des sanctions courantes - Performances optimisées avec métriques complètes - Performances optimisées avec plus de 80 messages configurables - Performances optimisées avec surveillance continue et redirection automatique - Performances optimisées avec protections anti-abus - Performances optimisées avec requêtes asynchrones et cache intelligent

Types de sanctions supportés

Sanctions joueurs

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

Sanctions IP

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

Nouvelles fonctionnalités

- Validation robuste des types de prison avec redirection automatique vers le serveur de prison - Validation robuste des types de prison toutes les 5 secondes avec vérification continue - Validation robuste des types de prison lors de la redirection des joueurs vers la prison - Validation robuste des types de prison pour libérer les joueurs et IPs emprisonnés - Validation robuste des types de prison avec support complet pour les sanctions IP - Validation robuste des types de prison avec suggestions de durée - Validation robuste des types de prison - Plus de 80 messages personnalisables - Validation robuste des types de prison pour toutes les commandes de prison - Validation robuste des types de prison avec support multi-serveurs

Corrections de bugs

- Correction des chaînes codées en dur pour les sanctions (maintenant "perm" fonctionne correctement) - Correction des chaînes codées en dur dans la configuration (séparateurs et autres) - Correction des chaînes codées en dur avec syntaxe complète - Correction des chaînes codées en dur pour les commandes de prison (durée et raison) - Correction des chaînes codées en dur (utilise "default" au lieu du nom du serveur) - Correction des chaînes codées en dur 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` : ```yaml database: type: "mysql" host: "localhost" port: 3306 database: "cocobans" username: "votre_utilisateur" password: "votre_mot_de_passe" ```

Prérequis techniques

- Minecraft 17 ou supérieur - Minecraft 3.2.0 ou supérieur - Minecraft 1.19 ou supérieur

Support et documentation

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

---

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

- Optimized performance for complete sanctions management - Optimized performance (SQLite by default, MySQL optional) - Optimized performance with dedicated file and in-game consultation - Optimized performance for quick application of common sanctions - Optimized performance with comprehensive metrics - Optimized performance with 80+ configurable messages - Optimized performance with continuous monitoring and automatic redirection - Optimized performance with anti-abuse protections - Optimized performance with asynchronous queries and intelligent caching

Supported Sanction Types

Player Sanctions

- Jail - Temporary or permanent banishment - Jail - Chat silencing - Jail - Immediate server expulsion - Jail - Warning without disconnection - Jail - Redirection to a jail server

IP Sanctions

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

New Features

- Robust jail type validation with automatic server redirection - Robust jail type validation every 5 seconds with continuous verification - Robust jail type validation when players are redirected to jail - Robust jail type validation to release jailed players and IPs - Robust jail type validation with full IP sanction support - Robust jail type validation with duration suggestions - Robust jail type validation - 80+ customizable messages - Robust jail type validation for all jail commands - Robust jail type validation with multi-server support

Bug Fixes

- Fixed hardcoded strings for sanctions ("perm" now works correctly) - Fixed hardcoded strings in configuration (separators and other issues) - Fixed hardcoded strings with complete syntax - Fixed hardcoded strings for jail commands (duration and reason handling) - Fixed hardcoded strings (uses "default" instead of server name) - Fixed hardcoded strings 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`: ```yaml database: type: "mysql" host: "localhost" port: 3306 database: "cocobans" username: "your_username" password: "your_password" ```

Technical Requirements

- Minecraft 17 or higher - Minecraft 3.2.0 or higher - Minecraft 1.19 or higher

Support and Documentation

For help, contact me on Discord : @lechat_v2

---

Author

Lechat_