ExooQueue \u2013 Queue Management Plugin (Paper 1.21)
\n
\nOverview
\n– ExooQueue limits players in a main world and queues overflow players in a waiting world.
\n– Players see their queue position and an ETA.
\n– VIPs (permission or \/vip command) bypass the queue.
\n– Commands and actions are configurable. Actions can run as player or console and support %player_name% and PlaceholderAPI if installed.
\n– SQLite is initialized for future persistence (not actively used yet).<\/p>\n
Requirements
\n– Multiverse core (for define waiting and other worlds)
\n– Server: Paper 1.21.x
\n– Java: 21 (JDK\/JRE)
\n– Optional: PlaceholderAPI (for advanced placeholders in actions)
\n– Optional: A world management plugin if you use commands like “mvtp” in actions (e.g., Multiverse-Core)<\/p>\n
Files
\n– src\/main\/resources\/plugin.yml \u2192 Bukkit command\/permission declarations
\n– src\/main\/resources\/config.yml \u2192 Plugin configuration (worlds, queue, commands + actions)
\n– src\/main\/java\/…\/ExooQueuePlugin.java \u2192 Main plugin class
\n– build.gradle, settings.gradle \u2192 Gradle build files<\/p>\n
Install (Using Built JAR)
\n1) Copy build\/libs\/ExooQueue-1.0.0.jar to your Paper server “plugins” folder.
\n2) Start the server once to generate config.yml.
\n3) Stop the server and edit plugins\/ExooQueue\/config.yml as needed.
\n4) Start the server again.<\/p>\n
Build (If you need to rebuild)
\n– From project root: .\/gradlew build (Linux\/macOS) or .\\gradlew.bat build (Windows)
\n– Output JAR: build\/libs\/ExooQueue-1.0.0.jar<\/p>\n
Core Concepts Configuration (config.yml) Example (default) commands: Placeholders in actions Commands (User-visible) – \/vip Permissions How Queueing Works Adding a Custom Join Command Steps 2) Edit src\/main\/resources\/config.yml and add matching config under commands: 3) Restart the server (or fully reload the plugin) to register the new command and load config.<\/p>\n Important Note About Queue Processing If you need option (b), consider enhancing the code to store a map of queued player UUID \u2192 command name, and modify processQueue() to look up and run that command’s actions.<\/p>\n Changing Worlds and Spawns SQLite Database Reloading Configuration Troubleshooting Roadmap Ideas (if you extend the plugin) Quick Reference Support ExooQueue is a flexible and powerful queue plugin designed specifically for Paper Minecraft servers. It helps you manage player access to crowded worlds by implementing a fair, configurable waiting system \u2014 perfect for popular game modes or limited-capacit<\/p>\n","protected":false},"featured_media":66610,"template":"","meta":{"_minecraft_slug":"exooqueue","_minecraft_project_id":"eYiAGUQp","_minecraft_author":"q.moinulislam","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":77,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"exooqueue.zip","_minecraft_size_bytes":8455,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:16:45.012720Z","_minecraft_date_created":"2025-08-12T03:05:15.711252Z","_minecraft_date_modified":"2025-08-10T23:42:38.977954Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/exooqueue","_minecraft_icon_attachment_id":66610,"_minecraft_imported_at":"2026-06-03T19:40:00+00:00","_minecraft_import_hash":"364d471713b6cf43baa195e7d99d663e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[873,126,90,127,869,92],"mod_loader":[132],"minecraft_version":[62],"class_list":["post-66609","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-library","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-transportation","mod_category-utility","mod_loader-paper","minecraft_version-1-21"],"yoast_head":"\n
\n– Main world: The target world players want to join (e.g., “world”).
\n– Wait world: A lobby where queued players wait.
\n– Max players: When the main world reaches this number, additional players are queued.
\n– VIP bypass: Players with permission “exooqueue.vip” or added via \/vip
\n– Actions: A list of commands to run when a player is allowed into the main world. You can run separate commands as the player or the console.<\/p>\n
\nKeys
\n– author: Free-form string.
\n– max-players: Integer. Maximum player count allowed in the main world.
\n– main-world: World name for the destination world.
\n– wait-world: World name for the queue lobby.
\n– wait-time-per-player: Integer seconds per queue position to calculate ETA.
\n– commands: Map of command-name \u2192 settings (description, permission, vip-permission, actions).<\/p>\n
\nauthor: “Moin”
\nmax-players: 10
\nmain-world: “world”
\nwait-world: “wait”
\nwait-time-per-player: 10<\/p>\n
\n lifesteal:
\n description: “Join lifesteal queue”
\n permission: “exooqueue.lifesteal”
\n vip-permission: “exooqueue.vip”
\n actions:
\n player:
\n – “say %player_name% joined lifesteal!”
\n console:
\n – “mvtp %player_name% world”
\n vip:
\n description: “Make player VIP bypass”
\n permission: “exooqueue.vip”
\n actions:
\n player: []
\n console: []<\/p>\n
\n– %player_name% is always replaced with the player name.
\n– If PlaceholderAPI is installed, all PAPI placeholders are also processed.<\/p>\n
\n– \/lifesteal
\n Description: Attempts to join the main world. If full, adds the player to the queue and teleports to the wait world.
\n Permission: exooqueue.lifesteal (default: true via plugin.yml)<\/p>\n
\n Permission: exooqueue.vip (default: op)<\/p>\n
\n– exooqueue.
\n– exooqueue.vip \u2192 Bypass queue and use \/vip
\n– Operators also bypass the queue by default.<\/p>\n
\n1) Player runs a join command (e.g., \/lifesteal).
\n2) If VIP\/op or if main world has capacity, configured actions run immediately (e.g., teleport), and the player joins.
\n3) If full and not VIP, the player is added to an in-memory queue and teleported to the wait world.
\n4) A background task checks every 5 seconds: if slots are free, the next queued player is processed and their actions run.
\n5) ETA shown to players is position \u00d7 wait-time-per-player.<\/p>\n
\nNote: Commands must be declared in plugin.yml to be recognized by Bukkit. Then configure the behavior in config.yml.<\/p>\n
\n1) Edit src\/main\/resources\/plugin.yml and add a command block:
\n commands:
\n myworld:
\n description: Join myworld queue
\n permission: exooqueue.myworld
\n permission-message: You don’t have permission to use this command.<\/p>\n
\n commands:
\n myworld:
\n description: “Join myworld queue”
\n permission: “exooqueue.myworld”
\n vip-permission: “exooqueue.vip”
\n actions:
\n player:
\n – “say %player_name% is joining myworld!”
\n console:
\n – “mvtp %player_name% myworld”<\/p>\n
\n– The default queue processing uses the actions of the “lifesteal” command when moving players from the queue.
\n– If you rely on multiple different join commands\/worlds, you should either:
\n a) Use the same actions for all queues (point everyone to the same destination), or
\n b) Update the code to track which command each player used and run the corresponding actions when processing the queue.<\/p>\n
\n– Ensure the worlds listed in config.yml (main-world, wait-world) exist on your server.
\n– Set the wait world spawn using in-game commands (e.g., \/setworldspawn) or your world management plugin.
\n– If you use Multiverse-Core commands in actions (e.g., mvtp), install that plugin and ensure permissions for console\/player are correct.<\/p>\n
\n– The plugin creates plugins\/ExooQueue\/queue.sqlite and a table “queue” (uuid TEXT PRIMARY KEY, position INTEGER).
\n– Current version does not persist the queue contents across restarts yet. Future updates may use this for persistence.<\/p>\n
\n– This version reads configuration on startup. To apply changes:
\n – Stop and start the server, or
\n – Use a full server reload with caution (\/reload confirm). A restart is recommended.<\/p>\n
\n– Command not found: Ensure the command exists in plugin.yml and has a matching entry under commands in config.yml.
\n– Player not teleported: Verify your actions reference the correct world and that any required plugins (e.g., Multiverse-Core) are installed.
\n– Placeholder not replaced: Install PlaceholderAPI to use advanced placeholders. %player_name% always works.
\n– VIP not saved: \/vip is temporary and cleared on restart. Grant the exooqueue.vip permission via your permissions plugin for permanent VIP.
\n– Build issues: Use Java 21 and ensure the Paper repository is reachable. The provided Gradle config targets Paper 1.21.x.<\/p>\n
\n– Persist queue and VIP list to SQLite across restarts.
\n– Per-command queues and actions when processing queued players.
\n– Add \/queue status, \/queue leave, and admin controls.
\n– Config reload command.
\n– Per-world limits (main-world list with individual capacities).<\/p>\n
\n– Main command: \/lifesteal
\n– VIP command: \/vip
\n– Permissions: exooqueue.
\n– Worlds: main-world (destination), wait-world (queue lobby)<\/p>\n
\n– If you need the code updated to support per-command queues or persistence, provide your desired behavior and we can extend the plugin accordingly.<\/p>\n","protected":false},"excerpt":{"rendered":"