LimboQueue-reloaded

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

- Connexion intelligente : Les joueurs sont automatiquement placés en file d'attente lors de la connexion si les serveurs sont pleins ou indisponibles - Connexion intelligente : Utilise LimboAPI pour faire une salle d'attente - Connexion intelligente : Vérifie la disponibilité de plusieurs serveurs simultanément - Connexion intelligente : 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: "<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 automatique : Le joueur se connecte au proxy Velocity 2. Connexion automatique : Si `queue-on-join` est activé, le plugin vérifie la disponibilité des serveurs 3. Connexion automatique : Si aucun serveur n'est disponible, le joueur est placé dans le monde limbo 4. Connexion automatique : 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 :

- Surveillance robuste : Résolution des problèmes de configuration et de sérialisation - Surveillance robuste : Meilleure gestion des déconnexions et des serveurs indisponibles - Surveillance robuste : Messages plus clairs et informatifs - Surveillance robuste : 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

- Smart connection : Players are automatically placed in queue upon connection if servers are full or unavailable - Smart connection : An environment where players wait - Smart connection : Checks the availability of multiple servers simultaneously - Smart connection : 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: "<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. Automatic connection : Player connects to the Velocity proxy 2. Automatic connection : If `queue-on-join` is enabled, the plugin checks server availability 3. Automatic connection : If no server is available, the player is placed in the limbo world 4. Automatic connection : 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:

- Robust monitoring : Resolution of configuration and serialization issues - Robust monitoring : Better management of disconnections and unavailable servers - Robust monitoring : Clearer and more informative messages - Robust monitoring : 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