LiteBans

Logo de Litebans

LiteBans

Type

Modération, Premium

Développeur

Ruan

Statut

Installé

Grade requis

Aspirant

Ressources

Documentation

Spigot

Code source

GitLab

Compatibilité

Dépendance(s)

MySQL/MariaDB (recommandé), SQLite (supporté)

LiteBans est un plugin premium de modération performant pour serveurs Minecraft. Il fournit un système complet de sanctions (ban, mute, kick, warn), une base de données centralisée (réseau multi-serveurs), une synchronisation en temps réel, des raisons configurables, des durées flexibles, un historique détaillé et un panneau web optionnel.

Description

Conçu pour la fiabilité et la performance, LiteBans enregistre toutes les sanctions dans une base SQL, assure la persistance et la cohérence sur un réseau (BungeeCord/Velocity) et propose de puissants outils d’audit: historique, preuves, raisons prédéfinies, logs, et intégration PlaceholderAPI pour l’affichage en jeu.

Fonctionnalités

Catégorie	Détails
Sanctions	Ban, TempBan, Mute, TempMute, Kick, Warn; raisons et durées personnalisables; pardons; notes staff
Réseau	Sync temps réel entre serveurs (Bungee/Velocity); base MySQL/MariaDB partagée; actions proxy ou backend
Historique	Consultation détaillée par joueur/IP; recherche par staff/raison/date; logs exportables
Panneau Web	Interface PHP/MySQL facultative: historique public/privé, recherche, liens de preuve (screens)
Messages	Messages 100% personnalisables (couleurs, placeholders); multi-langue; templates de raisons
Sécurité	Détection de contournement via IP/UUID; préventions doublons; limites de rate
Intégrations	PlaceholderAPI (placeholders de stats/sanctions); compatible avec la plupart des plugins de permissions (ex: LuckPerms)
Performance	Requêtes asynchrones; cache; index SQL; impact minimal sur TPS même en réseau

Installation

Serveur unique (Paper/Spigot)

Acheter et télécharger LiteBans depuis SpigotMC (fichier .jar).
Placer LiteBans.jar dans plugins/.
Démarrer le serveur pour générer la configuration.
Choisir le stockage (SQLite par défaut, MySQL recommandé).

# plugins/LiteBans/config.yml (extrait)
sql:
  driver: mysql         # mysql | mariadb | postgresql | sqlite
  address: "127.0.0.1:3306"
  database: "litebans"
  username: "litebans"
  password: "motdepasse"
  table_prefix: "lb_"

Réseau (BungeeCord/Velocity + backends)

Installer LiteBans sur le proxy ET/OU sur chaque backend selon votre flux de modération.
Configurer TOUS les nœuds pour qu’ils utilisent la même base MySQL/MariaDB et le même table_prefix.
Redémarrer proxy et serveurs. Les sanctions seront partagées instantanément.

Panneau Web (optionnel)

Pré-requis : PHP 8.x, serveur web (Apache/Nginx), accès MySQL.

Télécharger l’interface web LiteBans (fourni avec la ressource) et la placer dans le vhost.
Configurer inc/settings.php avec les mêmes identifiants MySQL que le plugin.
Protéger l’accès admin (auth basique ou ACL); option d’index public en lecture seule.
(Optionnel) Configurer réécritures URL et cache (OPcache/fastcgi).

Commandes

Commande	Description	Exemple
`/ban <joueur> [raison]`	Bannir définitivement	`/ban Notch Cheating`
`/tempban <joueur> <durée> [raison]`	Bannir temporairement	`/tempban Notch 7d Macro`
`/mute <joueur> [raison]`	Muter définitivement	`/mute Notch Insultes`
`/tempmute <joueur> <durée> [raison]`	Muter temporairement	`/tempmute Notch 2h Spam`
`/kick <joueur> [raison]`	Expulser	`/kick Notch Règles`
`/warn <joueur> [raison]`	Avertir	`/warn Notch Langage`
`/unban <cible>`	Déban	`/unban Notch`
`/unmute <cible>`	Unmute	`/unmute Notch`
`/history <joueur/ip>`	Historique des sanctions	`/history Notch`
`/checkban <joueur/ip>`	Vérifier si banni	`/checkban Notch`
`/litebans`	Infos / aide plugin

Formats de durée pris en charge

s=secondes, m=minutes, h=heures, d=jours, w=semaines, mo=mois, y=années
Exemples: 90m, 2h, 7d, 1mo, 1y, combinable: 1d12h

Permissions

Permission	Description
`litebans.ban`	Autoriser /ban
`litebans.tempban`	Autoriser /tempban
`litebans.mute`	Autoriser /mute
`litebans.tempmute`	Autoriser /tempmute
`litebans.kick`	Autoriser /kick
`litebans.warn`	Autoriser /warn
`litebans.unban`	Autoriser /unban
`litebans.unmute`	Autoriser /unmute
`litebans.history`	Voir historique
`litebans.checkban`	Vérifier bannis
`litebans.notify`	Recevoir notifications staff
`litebans.bypass`	Bypass certaines restrictions (à limiter)
`litebans.*`	Tous les droits LiteBans (administration)

Configuration

Messages et raisons

# plugins/LiteBans/messages.yml (extraits)
messages:
  ban_broadcast: "&c{player} a été banni par {staff}: &7{reason}"
  mute_broadcast: "&e{player} a été muté: &7{reason}"
  ban_message: "&cBanni du serveur.&r\n&7Raison: {reason}\n&7Expire: {expires}"
  mute_message: "&eVous êtes muet: &7{reason}\n&7Expire: {expires}"

# Raccourcis de raisons
reasons:
  cheat: "Cheating / Client modifié"
  spam: "Spam / Flood"
  toxic: "Insultes / Toxicité"

Limites et sécurité

# Limiter des durées par rôle (ex via permissions contextuelles)
limits:
  tempban_max: "30d"   # durée max si non-admin
  tempmute_max: "7d"
confirmations:
  require_reason: true
  require_duration_for_temp: true
ip_bans:
  enabled: true
uuid_bans:
  enabled: true

Base de données

- Préférez MySQL/MariaDB pour réseau et gros volumes. - Créez des index si nécessaire (rare, déjà fournis). - Sauvegardes régulières des tables lb_* (mysqldump).

PlaceholderAPI

Si PlaceholderAPI est installé, LiteBans expose des placeholders utiles:

%litebans_bans_total%
%litebans_mutes_total%
%litebans_warnings_total%
%litebans_player_banned%
%litebans_player_mute_active%
%litebans_player_warnings%

Bonnes pratiques

- Utiliser LuckPerms pour des rôles staff fins (helper/mod/admin) et limiter les permissions destructives. - Activer une base MySQL dédiée avec un utilisateur restreint (GRANT limité). - Standardiser vos raisons et durées (chartes internes) pour cohérence du staff. - Configurer les messages multilingues si le serveur est international. - Installer le panneau web en lecture seule pour transparence (optionnel).

Dépannage

Les sanctions ne se propagent pas en réseau

Vérifier que TOUS les nœuds pointent sur la même base et le même table_prefix.
Vérifier la connectivité MySQL (logs serveur).
Redémarrer proxy + backends après un changement de schéma.

Préfixes/couleurs non rendus - Vérifier le support couleurs du client/console et le formatage (& ou §). - Contrôler qu’aucun autre plugin n’écrase les messages.

Erreurs SQL - Vérifier droits MySQL (CREATE/INSERT/UPDATE/DELETE/SELECT). - Vérifier la version du driver/serveur (MariaDB/MySQL). - Lancer une réparation des tables si crash.

Voir aussi

Liens externes

Page SpigotMC
(Web UI) fourni avec la ressource premium