LimboQueue

Source code : Download ZIP

Scroll down for English version

LimboQueue est un plugin de file d'attente pour Velocity construit avec LimboAPI. Ce plugin est un fork amélioré du LimboQueue original, conçu pour faire patienter les joueurs dans un monde limbo virtuel pendant qu'ils attendent qu'un serveur de lobby soit disponible.

Description

LimboQueue résout le problème des serveurs pleins ou temporairement indisponibles en plaçant automatiquement les joueurs dans une file d'attente virtuelle. Au lieu de recevoir un message d'erreur ou d'être déconnectés, les joueurs sont transportés dans un monde limbo où ils peuvent attendre confortablement qu'une place se libère sur les serveurs de destination.

Fonctionnalités principales

• File d'attente automatique : Les joueurs sont automatiquement placés en file d'attente lors de la connexion si les serveurs sont pleins ou indisponibles
• Monde "limbo" virtuel : Utilise LimboAPI pour faire une salle d'attente
• Surveillance multi-serveurs : Vérifie la disponibilité de plusieurs serveurs simultanément
• Messages informatifs : ActionBar dynamique qui informe les joueurs de leur position et du temps d'attente
• Connexion intelligente : Connecte automatiquement les joueurs dès qu'un serveur devient disponible

Installation

Prérequis

• Velocity (dernière version)
• LimboAPI (dernière version)
• Java 11 ou supérieur

Étapes d'installation

1. Téléchargez le fichier JAR depuis les releases ou compilez le projet
2. Placez le fichier LimboQueue-1.0.1.jar dans le dossier plugins de votre serveur Velocity
3. Redémarrez votre serveur Velocity
4. Le plugin générera automatiquement un fichier de configuration config.yml

Configuration

Le fichier de configuration se trouve dans plugins/limboqueue/config.yml :

main:
  # Format des messages : LEGACY_AMPERSAND, LEGACY_SECTION, MINIMESSAGE
  serializer: "MINIMESSAGE"
  
  # Serveur principal à vérifier (défini dans velocity.toml)
  server: "lobby"
  
  # Liste des serveurs à surveiller (séparés par des virgules)
  servers: "lobby,lobby2"
  
  # Message de kick qui déclenche la mise en file d'attente
  kick-message: "The server is full"
  
  # Intervalle de vérification des serveurs (en secondes)
  check-interval: 2
  
  # Activer la file d'attente automatique à la connexion
  queue-on-join: true
  
  # Activer les messages dans la barre d'action
  enable-actionbar: true
  
  # Activer le scoreboard (désactivé par défaut)
  enable-scoreboard: false
  
  # Intervalle de mise à jour de l'actionbar (en secondes)
  actionbar-interval: 1
  
  world:
    # Dimension du monde limbo : OVERWORLD, NETHER, THE_END
    dimension: "OVERWORLD"

messages:
  # Messages personnalisables
  queue-message: "Your position in queue: {0}"
  server-offline: "<red>Server is offline."
  reload: "<green>LimboQueue reloaded!"
  reload-failed: "<red>Reload failed!"
  
  # Messages de la barre d'action
  actionbar-waiting: "<yellow>⏳ Searching for available servers... <gray>({0}s)"
  actionbar-connecting: "<green>✓ Server found! Connecting..."
  actionbar-queue: "<aqua>Queue Position: <white>{0} <gray>| <yellow>Waiting time: <white>{1}s"
  
  # Messages d'état
  no-servers-available: "<red>No servers are currently available. Please wait..."
  connecting-to-server: "<green>Connecting to {0}..."

Commandes et permissions

Commandes administrateur

• /limboqueue reload ou /lq reload - Recharge la configuration du plugin
  • Permission : limboqueue.reload

Commandes joueur

• /limboqueue queue ou /lq queue - Rejoint manuellement la file d'attente
• /limboqueue status ou /lq status - Affiche l'état des serveurs surveillés

Fonctionnement

Flux automatique

1. Connexion du joueur : Le joueur se connecte au proxy Velocity
2. Vérification automatique : Si queue-on-join est activé, le plugin vérifie la disponibilité des serveurs
3. Mise en file d'attente : Si aucun serveur n'est disponible, le joueur est placé dans le monde limbo
4. Attente interactive : Le joueur voit sa position dans la file et le temps d'attente via l'ActionBar
5. Connexion automatique : Dès qu'un serveur devient disponible, le joueur y est automatiquement connecté

Gestion des serveurs pleins

Lorsqu'un joueur est expulsé d'un serveur avec un message contenant le texte configuré dans kick-message, il est automatiquement placé en file d'attente au lieu d'être déconnecté du proxy.

Avantages de ce fork

Cette version améliorée du LimboQueue original apporte plusieurs corrections et améliorations :

• Stabilité accrue : Résolution des problèmes de configuration et de sérialisation
• Gestion intelligente des erreurs : Meilleure gestion des déconnexions et des serveurs indisponibles
• Interface utilisateur améliorée : Messages plus clairs et informatifs
• Configuration simplifiée : Suppression des éléments problématiques tout en conservant les fonctionnalités essentielles
• Surveillance robuste : Vérification continue de l'état des serveurs avec reconnexion automatique

Support

Contactez moi sur Discord : @lechat87, ou par mail : axel@arockenbauer.fr

---

LimboQueue (English Version)

LimboQueue is a queue plugin for Velocity built with LimboAPI. This plugin is an improved fork of the original LimboQueue, designed to make players wait in a virtual limbo world while they wait for a lobby server to become available.

Description

LimboQueue solves the problem of full or temporarily unavailable servers by automatically placing players in a virtual queue. Instead of receiving an error message or being disconnected, players are transported to a limbo world where they can wait comfortably for a spot to open up on the destination servers.

Main features

• Automatic queue : Players are automatically placed in queue upon connection if servers are full or unavailable
• Virtual limbo world : An environment where players wait
• Multi-server monitoring : Checks the availability of multiple servers simultaneously
• Informative messages : Dynamic ActionBar that informs players of their position and waiting time
• Smart connection : Automatically connects players as soon as a server becomes available

Installation

Prerequisites

• Velocity (latest version)
• LimboAPI (latest version)
• Java 11 or higher

Installation steps

1. Download the JAR file from releases or compile the project
2. Place the LimboQueue-1.0.1.jar file in your Velocity server's plugins folder
3. Restart your Velocity server
4. The plugin will automatically generate a config.yml configuration file

Configuration

The configuration file is located in plugins/limboqueue/config.yml:

main:
  # Message format: LEGACY_AMPERSAND, LEGACY_SECTION, MINIMESSAGE
  serializer: "MINIMESSAGE"
  
  # Main server to check (defined in velocity.toml)
  server: "lobby"
  
  # List of servers to monitor (comma separated)
  servers: "lobby,lobby2"
  
  # Kick message that triggers queueing
  kick-message: "The server is full"
  
  # Server check interval (in seconds)
  check-interval: 2
  
  # Enable automatic queue on join
  queue-on-join: true
  
  # Enable actionbar messages
  enable-actionbar: true
  
  # Enable scoreboard (disabled by default)
  enable-scoreboard: false
  
  # Actionbar update interval (in seconds)
  actionbar-interval: 1
  
  world:
    # Limbo world dimension: OVERWORLD, NETHER, THE_END
    dimension: "OVERWORLD"

messages:
  # Customizable messages
  queue-message: "Your position in queue: {0}"
  server-offline: "<red>Server is offline."
  reload: "<green>LimboQueue reloaded!"
  reload-failed: "<red>Reload failed!"
  
  # ActionBar messages
  actionbar-waiting: "<yellow>Searching for available servers... <gray>({0}s)"
  actionbar-connecting: "<green>Server found! Connecting..."
  actionbar-queue: "<aqua>Queue Position: <white>{0} <gray>| <yellow>Waiting time: <white>{1}s"
  
  # Status messages
  no-servers-available: "<red>No servers are currently available. Please wait..."
  connecting-to-server: "<green>Connecting to {0}..."

Commands and permissions

Administrator commands

• /limboqueue reload or /lq reload - Reload plugin configuration
  • Permission: limboqueue.reload

Player commands

• /limboqueue queue or /lq queue - Manually join the queue
• /limboqueue status or /lq status - Display the status of monitored servers

How it works

Automatic flow

1. Player connection : Player connects to the Velocity proxy
2. Automatic check : If queue-on-join is enabled, the plugin checks server availability
3. Queue placement : If no server is available, the player is placed in the limbo world
4. Interactive waiting : Player sees their position in queue and waiting time via ActionBar
5. Automatic connection : As soon as a server becomes available, the player is automatically connected

Full server management

When a player is kicked from a server with a message containing the text configured in kick-message, they are automatically placed in queue instead of being disconnected from the proxy.

Advantages of this fork

This improved version of the original LimboQueue brings several fixes and improvements:

• Increased stability : Resolution of configuration and serialization issues
• Smart error handling : Better management of disconnections and unavailable servers
• Improved user interface : Clearer and more informative messages
• Simplified configuration : Removal of problematic elements while preserving essential features
• Robust monitoring : Continuous server status checking with automatic reconnection

Support

Contact me on Discord : @lechat87 ! I reply as soon as possible. If you prefer mail contact : axel@arockenbauer.fr