Velotlist

Plugin de whitelist pour proxy Velocity — léger, sans dépendance externe, rechargeable à chaud.

Prérequis

Composant	Version minimale
Velocity	3.4.0
Java	25

Installation

1. Compiler avec ./gradlew build — le jar shadowé est généré dans build/libs/.
2. Déposer le jar dans le dossier plugins/ de Velocity.
3. Redémarrer le proxy.

Le fichier plugins/velotlist/config.yml est créé automatiquement au premier démarrage.

Configuration

whitelist:
  # Active ou désactive l'interception des connexions.
  enabled: false

  # Liste des joueurs autorisés (insensible à la casse).
  players:
    - Notch
    - Dinnerbone

  # Message affiché aux joueurs non whitelistés.
  # Supporte le format MiniMessage : https://docs.advntr.dev/minimessage/format.html
  # Peut être une chaîne unique ou une liste (chaque entrée = une ligne de chat).
  kick-message:
    - "<red><bold>⛔ Accès refusé</bold></red>"
    - "<gray>Vous n'êtes pas sur la whitelist.</gray>"

Format des messages

Tous les messages supportent le format MiniMessage :

<red>texte</red>
<green><bold>texte</bold></green>
<gradient:#ff0000:#0000ff>dégradé</gradient>
<rainbow>arc-en-ciel</rainbow>

Le kick-message peut être multiligne via une liste YAML — chaque entrée est envoyée comme une ligne de chat distincte.

Commandes

Permission requise : velotlist.admin
Alias disponible : /vwl

Commande	Description
/velotlist	Affiche le statut, la version et l'aide
/velotlist add <joueur>	Ajoute un joueur à la whitelist
/velotlist remove <joueur>	Retire un joueur de la whitelist
/velotlist enable	Active la whitelist
/velotlist disable	Désactive la whitelist
/velotlist reload	Recharge la config et le listener

Toutes les modifications (add, remove, enable, disable) sont persistées immédiatement dans config.yml.

Fonctionnement

L'interception se fait sur le LoginEvent avec priority = Short.MAX_VALUE — soit la priorité la plus haute possible — pour bloquer les joueurs non autorisés avant tout autre listener du proxy.

Le reload ré-enregistre également le listener, garantissant un redémarrage propre sans avoir à relancer Velocity.

Build

./gradlew build
# → build/libs/velotlist-1.0.0.jar