# CocoBans – Plugin de sanctions pour Velocity
\nv1.1.0
\nScroll down for English version
\n## Fran\u00e7ais<\/p>\n
CocoBans est un plugin complet de gestion des sanctions pour les serveurs Minecraft utilisant Velocity. D\u00e9velopp\u00e9 par Lechat, il offre une solution robuste et performante pour administrer les sanctions sur votre serveur.<\/p>\n
### Caract\u00e9ristiques principales<\/p>\n
– **25 commandes fonctionnelles** pour une gestion compl\u00e8te des sanctions
\n– **Support multi-base de donn\u00e9es** (SQLite par d\u00e9faut, MySQL optionnel)
\n– **Syst\u00e8me de logs avanc\u00e9** avec fichier d\u00e9di\u00e9 et consultation en jeu
\n– **Templates pr\u00e9d\u00e9finis** pour une application rapide des sanctions courantes
\n– **Statistiques d\u00e9taill\u00e9es** avec m\u00e9triques compl\u00e8tes
\n– **Configuration enti\u00e8rement personnalisable** avec plus de 80 messages configurables
\n– **Syst\u00e8me de prison avanc\u00e9** avec surveillance continue et redirection automatique
\n– **Syst\u00e8me de s\u00e9curit\u00e9 renforc\u00e9** avec protections anti-abus
\n– **Performances optimis\u00e9es** avec requ\u00eates asynchrones et cache intelligent<\/p>\n
### Types de sanctions support\u00e9s<\/p>\n
#### Sanctions joueurs
\n– **Ban** – Bannissement temporaire ou permanent
\n– **Mute** – R\u00e9duction au silence dans le chat
\n– **Kick** – Expulsion imm\u00e9diate du serveur
\n– **Warn** – Avertissement sans d\u00e9connexion
\n– **Jail** – Redirection vers un serveur de prison<\/p>\n
#### Sanctions IP
\n– **BanIP** – Bannissement d’une adresse IP compl\u00e8te
\n– **MuteIP** – R\u00e9duction au silence de tous les joueurs d’une IP
\n– **KickIP** – Expulsion de tous les joueurs connect\u00e9s depuis une IP
\n– **JailIP** – Prison pour une adresse IP compl\u00e8te<\/p>\n
### Nouvelles fonctionnalit\u00e9s<\/p>\n
– **Syst\u00e8me de prison am\u00e9lior\u00e9** avec redirection automatique vers le serveur de prison
\n– **Surveillance asynchrone de la prison** toutes les 5 secondes avec v\u00e9rification continue
\n– **Messages informatifs configurables** lors de la redirection des joueurs vers la prison
\n– **Nouvelles commandes \/unjail et \/unjailip** pour lib\u00e9rer les joueurs et IPs emprisonn\u00e9s
\n– **Commande \/jailip compl\u00e9t\u00e9e** avec support complet pour les sanctions IP
\n– **Correction de l’autocompl\u00e9tion pour la commande \/mute** avec suggestions de dur\u00e9e
\n– **Messages enti\u00e8rement configurables** – Plus de 80 messages personnalisables
\n– **Analyse am\u00e9lior\u00e9e des arguments** pour toutes les commandes de prison
\n– **Validation robuste des types de prison** avec support multi-serveurs<\/p>\n
### Corrections de bugs<\/p>\n
– **Correction de l’analyse du temps permanent** pour les sanctions (maintenant “perm” fonctionne correctement)
\n– **Correction des erreurs de syntaxe YAML** dans la configuration (s\u00e9parateurs et autres)
\n– **Correction des messages d’utilisation des commandes** avec syntaxe compl\u00e8te
\n– **Correction de l’analyse des arguments** pour les commandes de prison (dur\u00e9e et raison)
\n– **Correction de la validation du type de prison** (utilise “default” au lieu du nom du serveur)
\n– **Correction de l’autocompl\u00e9tion** pour \/mute avec suggestions de dur\u00e9e
\n– **Correction des cha\u00eenes cod\u00e9es en dur** – Tous les messages sont d\u00e9sormais configurables<\/p>\n
### Installation<\/p>\n
#### Installation rapide
\n1. T\u00e9l\u00e9chargez le fichier JAR depuis les releases
\n2. Placez-le dans le dossier `plugins\/` de votre serveur Velocity
\n3. Red\u00e9marrez le serveur
\n4. Le plugin cr\u00e9era automatiquement sa configuration
\n5. Mettez \u00e0 jour votre `config.yml` si vous mettez \u00e0 niveau depuis une version pr\u00e9c\u00e9dente pour b\u00e9n\u00e9ficier des nouvelles options de configuration<\/p>\n
### Configuration<\/p>\n
Le plugin g\u00e9n\u00e8re automatiquement un fichier `config.yml` complet avec toutes les options disponibles. Vous pouvez personnaliser :<\/p>\n
– **Messages et notifications** (plus de 80 messages enti\u00e8rement configurables)
\n– Param\u00e8tres de base de donn\u00e9es (SQLite par d\u00e9faut, MySQL support\u00e9)
\n– Permissions et commandes
\n– Templates de sanctions pr\u00e9d\u00e9finis
\n– Options de broadcast et alertes
\n– Dur\u00e9es par d\u00e9faut pour les sanctions
\n– Support pour plusieurs types de prisons et serveurs
\n– Configuration des jails avec serveurs personnalis\u00e9s<\/p>\n
### Commandes disponibles<\/p>\n
#### Sanctions de base #### Sanctions IP #### Sanctions de prison #### R\u00e9voquer les sanctions #### Informations #### Administration ### Syst\u00e8me de permissions<\/p>\n #### Permissions de base #### Permissions IP #### Permissions de bypass #### Permissions sp\u00e9ciales ### Formats de dur\u00e9e<\/p>\n Le plugin accepte plusieurs formats de dur\u00e9e, par exemple : ### Templates pr\u00e9d\u00e9finis<\/p>\n Le plugin inclut des templates pour les sanctions courantes : ### Base de donn\u00e9es<\/p>\n #### SQLite (par d\u00e9faut) #### MySQL (optionnel) ### Pr\u00e9requis techniques<\/p>\n – **Java** 17 ou sup\u00e9rieur ### Support et documentation<\/p>\n Pour obtenir de l’aide, contactez moi sur Discord : @lechat_v2<\/p>\n —<\/p>\n ## English<\/p>\n 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.<\/p>\n ### Key Features<\/p>\n – **25 functional commands** for complete sanctions management ### Supported Sanction Types<\/p>\n #### Player Sanctions #### IP Sanctions ### New Features<\/p>\n – **Improved jail system** with automatic server redirection ### Bug Fixes<\/p>\n – **Fixed permanent time parsing** for sanctions (“perm” now works correctly) ### Installation<\/p>\n #### Quick Installation ### Configuration<\/p>\n The plugin automatically generates a complete `config.yml` file with all available options. You can customize:<\/p>\n – **Messages and notifications** (80+ fully configurable messages) ### Available Commands<\/p>\n #### Basic Sanctions #### IP Sanctions #### Jail Sanctions #### Revocations #### Information #### Administration ### Permission System<\/p>\n #### Basic Permissions #### IP Permissions #### Bypass Permissions #### Special Permissions ### Duration Formats<\/p>\n The plugin accepts several duration formats, like : ### Predefined Templates<\/p>\n The plugin includes templates for common sanctions: ### Database<\/p>\n #### SQLite (default) #### MySQL (optional) ### Technical Requirements<\/p>\n – **Java** 17 or higher ### Support and Documentation<\/p>\n For help, contact me on Discord : @lechat_v2<\/p>\n —<\/p>\n ## Author<\/p>\n **Lechat_**<\/p>\n","protected":false},"excerpt":{"rendered":" A Velocity plugin to apply sanctions on users.<\/p>\n","protected":false},"featured_media":43574,"template":"","meta":{"_minecraft_slug":"cocobans","_minecraft_project_id":"d3iYqYTJ","_minecraft_author":"lechat","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":34,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"cocobans.zip","_minecraft_size_bytes":27153447,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T21:52:36.453154Z","_minecraft_date_created":"2025-08-12T02:31:26.413099Z","_minecraft_date_modified":"2025-11-18T09:05:49.869133Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/cocobans","_minecraft_icon_attachment_id":43574,"_minecraft_imported_at":"2026-06-02T00:29:39+00:00","_minecraft_import_hash":"e00165ece9569a5403812103c26d1bd2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,92,985],"mod_loader":[986],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-43573","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-utility","mod_category-velocity","mod_loader-velocity","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","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
\n“`
\n\/ban
\n\/mute
\n\/kick
\n\/warn
\n“`<\/p>\n
\n“`
\n\/banip
\n\/muteip
\n\/kickip
\n“`<\/p>\n
\n“`
\n\/jail
\n\/jailip
\n\/jailban
\n\/jailbanip
\n\/unjail
\n\/unjailip
\n“`<\/p>\n
\n“`
\n\/unban
\n\/unmute
\n\/unjail
\n\/unjailip
\n“`<\/p>\n
\n“`
\n\/check
\n\/history
\n“`<\/p>\n
\n“`
\n\/cocobans reload – Recharger la configuration
\n\/cocobans info – Informations du plugin
\n\/cbstats – Statistiques d\u00e9taill\u00e9es
\n\/cbtemplate list – Lister les templates
\n\/cbtemplate use
\n\/cblogs [lignes] – Consulter les logs
\n“`<\/p>\n
\n– `cocobans.admin` – Acc\u00e8s administrateur complet
\n– `cocobans.ban` – Permission de bannir
\n– `cocobans.mute` – Permission de muter
\n– `cocobans.kick` – Permission d’expulser
\n– `cocobans.warn` – Permission d’avertir
\n– `cocobans.unban` – Permission de d\u00e9bannir
\n– `cocobans.unmute` – Permission de d\u00e9muter
\n– `cocobans.check` – Permission de v\u00e9rifier les sanctions
\n– `cocobans.history` – Permission de consulter l’historique<\/p>\n
\n– `cocobans.banip` – Permission de bannir par IP
\n– `cocobans.muteip` – Permission de muter par IP
\n– `cocobans.kickip` – Permission d’expulser par IP<\/p>\n
\n– `cocobans.bypass.ban` – Immunit\u00e9 contre les bans
\n– `cocobans.bypass.mute` – Immunit\u00e9 contre les mutes
\n– `cocobans.bypass.kick` – Immunit\u00e9 contre les kicks<\/p>\n
\n– `cocobans.alerts` – Recevoir les notifications de sanctions<\/p>\n
\n– `30s` – 30 secondes
\n– `5m` – 5 minutes
\n– `2h` – 2 heures
\n– `7d` – 7 jours
\n– `perm` – Permanent<\/p>\n
\n– `grief` – Ban 7 jours pour grief
\n– `spam` – Mute 1 heure pour spam
\n– `insultes` – Mute 6 heures pour insultes
\n– `hack` – Ban permanent pour hack
\n– `pub` – Kick pour publicit\u00e9
\n– `avertissement` – Warn g\u00e9n\u00e9ral<\/p>\n
\nAucune configuration requise. La base de donn\u00e9es est cr\u00e9\u00e9e automatiquement dans le dossier du plugin.<\/p>\n
\nConfigurez les param\u00e8tres de connexion dans `config.yml` :
\n“`yaml
\ndatabase:
\n type: “mysql”
\n host: “localhost”
\n port: 3306
\n database: “cocobans”
\n username: “votre_utilisateur”
\n password: “votre_mot_de_passe”
\n“`<\/p>\n
\n– **Velocity** 3.2.0 ou sup\u00e9rieur
\n– **Minecraft** 1.19 ou sup\u00e9rieur<\/p>\n
\n– **Multi-database support** (SQLite by default, MySQL optional)
\n– **Advanced logging system** with dedicated file and in-game consultation
\n– **Predefined templates** for quick application of common sanctions
\n– **Detailed statistics** with comprehensive metrics
\n– **Fully customizable configuration** with 80+ configurable messages
\n– **Advanced jail system** with continuous monitoring and automatic redirection
\n– **Enhanced security system** with anti-abuse protections
\n– **Optimized performance** with asynchronous queries and intelligent caching<\/p>\n
\n– **Ban** – Temporary or permanent banishment
\n– **Mute** – Chat silencing
\n– **Kick** – Immediate server expulsion
\n– **Warn** – Warning without disconnection
\n– **Jail** – Redirection to a jail server<\/p>\n
\n– **BanIP** – Complete IP address banishment
\n– **MuteIP** – Silencing all players from an IP
\n– **KickIP** – Expulsion of all players connected from an IP
\n– **JailIP** – Jail for a complete IP address<\/p>\n
\n– **Asynchronous jail monitoring** every 5 seconds with continuous verification
\n– **Configurable informative messages** when players are redirected to jail
\n– **New \/unjail and \/unjailip commands** to release jailed players and IPs
\n– **Completed \/jailip command** with full IP sanction support
\n– **Fixed \/mute command autocomplete** with duration suggestions
\n– **Fully configurable messages** – 80+ customizable messages
\n– **Enhanced argument parsing** for all jail commands
\n– **Robust jail type validation** with multi-server support<\/p>\n
\n– **Fixed YAML syntax errors** in configuration (separators and other issues)
\n– **Fixed command usage messages** with complete syntax
\n– **Fixed argument parsing** for jail commands (duration and reason handling)
\n– **Fixed jail type validation** (uses “default” instead of server name)
\n– **Fixed autocomplete** for \/mute with duration suggestions
\n– **Fixed hardcoded strings** – All messages are now configurable<\/p>\n
\n1. Download the JAR file from releases
\n2. Place it in your Velocity server’s `plugins\/` folder
\n3. Restart the server
\n4. The plugin will automatically create its configuration
\n5. Update your `config.yml` if upgrading from previous versions to take advantage of new configuration options<\/p>\n
\n– Database parameters (SQLite default, MySQL supported)
\n– Permissions and commands
\n– Predefined sanction templates
\n– Broadcast and alert options
\n– Default sanction durations
\n– Support for multiple jail types and servers
\n– Jail configuration with custom servers<\/p>\n
\n“`
\n\/ban
\n\/mute
\n\/kick
\n\/warn
\n“`<\/p>\n
\n“`
\n\/banip
\n\/muteip
\n\/kickip
\n“`<\/p>\n
\n“`
\n\/jail
\n\/jailip
\n\/jailban
\n\/jailbanip
\n\/unjail
\n\/unjailip
\n“`<\/p>\n
\n“`
\n\/unban
\n\/unmute
\n\/unjail
\n\/unjailip
\n“`<\/p>\n
\n“`
\n\/check
\n\/history
\n“`<\/p>\n
\n“`
\n\/cocobans reload – Reload configuration
\n\/cocobans info – Plugin information
\n\/cbstats – Detailed statistics
\n\/cbtemplate list – List templates
\n\/cbtemplate use
\n\/cblogs [lines] – View logs
\n“`<\/p>\n
\n– `cocobans.admin` – Full administrator access
\n– `cocobans.ban` – Permission to ban
\n– `cocobans.mute` – Permission to mute
\n– `cocobans.kick` – Permission to kick
\n– `cocobans.warn` – Permission to warn
\n– `cocobans.unban` – Permission to unban
\n– `cocobans.unmute` – Permission to unmute
\n– `cocobans.check` – Permission to check sanctions
\n– `cocobans.history` – Permission to view history<\/p>\n
\n– `cocobans.banip` – Permission to ban by IP
\n– `cocobans.muteip` – Permission to mute by IP
\n– `cocobans.kickip` – Permission to kick by IP<\/p>\n
\n– `cocobans.bypass.ban` – Immunity against bans
\n– `cocobans.bypass.mute` – Immunity against mutes
\n– `cocobans.bypass.kick` – Immunity against kicks<\/p>\n
\n– `cocobans.alerts` – Receive sanction notifications<\/p>\n
\n– `30s` – 30 seconds
\n– `5m` – 5 minutes
\n– `2h` – 2 hours
\n– `7d` – 7 days
\n– `perm` – Permanent<\/p>\n
\n– `grief` – 7-day ban for griefing
\n– `spam` – 1-hour mute for spam
\n– `insultes` – 6-hour mute for insults
\n– `hack` – Permanent ban for hacking
\n– `pub` – Kick for advertising
\n– `avertissement` – General warning<\/p>\n
\nNo configuration required. The database is automatically created in the plugin folder.<\/p>\n
\nConfigure connection parameters in `config.yml`:
\n“`yaml
\ndatabase:
\n type: “mysql”
\n host: “localhost”
\n port: 3306
\n database: “cocobans”
\n username: “your_username”
\n password: “your_password”
\n“`<\/p>\n
\n– **Velocity** 3.2.0 or higher
\n– **Minecraft** 1.19 or higher<\/p>\n