# LimboQueue
### Source code : [Download ZIP](https://release-assets.githubusercontent.com/github-production-release-asset/1056988891/38bcd90a-6b87-4220-ad34-2aa0f2572acd?sp=r&sv=2018-11-09&sr=b&spr=https&se=2025-09-15T06%3A51%3A40Z&rscd=attachment%3B+filename%3Dlimboqueue-sourcecode.zip&rsct=application%2Foctet-stream&skoid=96c2d410-5711-43a1-aedd-ab1947aa7ab0&sktid=398a6654-997b-47e9-b12b-9515b896b4de&skt=2025-09-15T05%3A51%3A03Z&ske=2025-09-15T06%3A51%3A40Z&sks=b&skv=2018-11-09&sig=LZ7ORxquSn7vdSXKHcDRzclNknxWG9mZ9PHmc95tk0o%3D&jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmVsZWFzZS1hc3NldHMuZ2l0aHVidXNlcmNvbnRlbnQuY29tIiwia2V5Ijoia2V5MSIsImV4cCI6MTc1NzkxNjk2OSwibmJmIjoxNzU3OTE2NjY5LCJwYXRoIjoicmVsZWFzZWFzc2V0cHJvZHVjdGlvbi5ibG9iLmNvcmUud2luZG93cy5uZXQifQ.nKOBW7xXnS4OT63tITrKTDuJM6sAwAZsy3QNB7BGeBw&response-content-disposition=attachment%3B%20filename%3Dlimboqueue-sourcecode.zip&response-content-type=application%2Foctet-stream)
### Scroll down for English version
LimboQueue est un plugin de file d'attente pour [Velocity](https://velocitypowered.com) construit avec [LimboAPI](https://github.com/elytrium/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` :
```yaml
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: "Server is offline."
reload: "LimboQueue reloaded!"
reload-failed: "Reload failed!"
# Messages de la barre d'action
actionbar-waiting: "⏳ Searching for available servers... ({0}s)"
actionbar-connecting: "✓ Server found! Connecting..."
actionbar-queue: "Queue Position: {0} | Waiting time: {1}s"
# Messages d'état
no-servers-available: "No servers are currently available. Please wait..."
connecting-to-server: "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](https://velocitypowered.com) built with [LimboAPI](https://github.com/elytrium/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`:
```yaml
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: "Server is offline."
reload: "LimboQueue reloaded!"
reload-failed: "Reload failed!"
# ActionBar messages
actionbar-waiting: "Searching for available servers... ({0}s)"
actionbar-connecting: "Server found! Connecting..."
actionbar-queue: "Queue Position: {0} | Waiting time: {1}s"
# Status messages
no-servers-available: "No servers are currently available. Please wait..."
connecting-to-server: "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