QueueX | Modular Queue System v1.0.0

QueueX is a modern and fully configurable queue and party system for PvP, duel, practice, and event servers. It is built for servers that want polished queue flow, party support, clickable confirmation prompts, a clean GUI, and flexible command-based match launching without forcing a specific duel plugin.

Features

• Fully configurable queue system with support for multiple queues, categories, display names, materials, lore, team sizes, and required player counts.
• Queue categories GUI and queue browser GUI with pagination, filler items, queue info panels, queued player previews, and click-to-join / click-to-leave / click-to-swap flow.
• Admin GUI for enabling and disabling categories and individual queues live in-game.
• Queue list command with display-name-based output instead of raw internal ids.
• Per-queue permission support so specific ladders or modes can be locked behind permission nodes.
• Optional party support per queue, allowing some queues to accept parties while others stay solo only.
• Party-aware queue access checks, including permission checks, busy-state checks, offline checks, and max team-size protection.
• Join and leave cooldowns for both solo players and party members.
• Automatic queue filling based on teams-needed and team-size configuration.

Match Accept System

• Optional accept/decline phase before a queue launches.
• Clickable accept and decline chat messages for faster response.
• Configurable timeout for pending matches.
• Requeue support when a player declines, when accepted players time out, or when a launch fails.
• Pending-match status messages showing accepted players, required players, and remaining accepts.
• Match cancellation handling when a player goes offline before launch.

Party System

• /party invite, /party list, /party leave, /party disband, /party kick, /party transfer, /party promote, /party accept, and /party deny.
• Party roles with leader and moderator support.
• Clickable party invite accept/deny chat messages.
• Party list view with visible player count at the top.
• Clean leader / moderator / member display, with empty sections hidden automatically.
• Configurable max party size and max pending invites.
• Invite expiry support with timeout messages.
• Party busy protection so parties cannot be modified while queued or while a pending match is active.
• Admin party controls with /party forcejoin and /party takeover.

Match Launching

• Command-driven launch system using configurable on-fill commands.
• Supports console:, each-player:, and indexed senders like player1:.
• Built-in placeholders for launch commands, including %duel_id%, %player_count%, %players_csv%, %players_space%, %uuids_csv%, %uuids_space%, %player_1%, %player_2%, %uuid_1%, %uuid_2%, %self%, and %self_uuid%.
• Built-in temporary queue test-launch command for setup and testing.
• Built-in dev test-match mode for local development and queue flow testing.
• Launch safeguard that can automatically requeue players if the configured launch command fails.

Feedback and UX

• Fully configurable chat messages.
• Configurable titles, subtitles, action bars, and sounds for queue, party, and admin actions.
• Queue match found feedback and match accept request feedback.
• Queue and party messaging uses display names where appropriate for cleaner player-facing output.

Validation and Config Safety

• /queue reload to reload config changes.
• /queue validate to validate the config from disk before reloading.
• Validation catches duplicate duel ids, bad indexed player references, and placeholder/example launch command usage.
• Safe default backfilling for missing config keys.
• Config versioning with optional replace-on-newer-version behavior.

PlaceholderAPI Support

• Built-in PlaceholderAPI expansion with queue, player, duel, and category placeholders.
• Examples include total queue count, enabled queue count, current queue, queued queue, pending queue, queue position, pending accept stats, queue size per duel, players needed, display names, category names, permissions, and queued player lists.

Built for servers that want a polished queueing experience without being locked into one duel plugin. QueueX is ideal for practice networks, custom minigame hubs, event servers, and servers that want party-aware matchmaking with a modern presentation.