🚀 VelocityQueue

Advanced Velocity queue plugin for Minecraft servers, featuring NORMAL and PULL_ONLY modes — built for events, streams, tournaments, and any controlled access scenario.

✨ Features

• Full queue system managed directly on the Velocity proxy
• NORMAL mode — players automatically connect when they reach position #1
• PULL_ONLY mode — only staff decides who gets in using /pull
• Position displayed in the action bar in real time
• Throttled connections to prevent network spikes and backend freezes
• /pull command to connect N players or a specific player
• Hot config reload with /queue reload
• Automatic update checker on startup

📋 Commands

| Command | Description |
|---------|-------------|
| /pull <count> [server] | Pull N players from the queue to the server |
| /pull <player> | Pull a specific player from any queue |
| /pull list [server] | Display queue status |
| /queue reload | Reload the configuration without restarting |
| /queue version | Display the plugin version |

🔐 Permissions

| Permission | Description |
|------------|-------------|
| queue.use | Required to join the queue — give this to all players |
| queue.admin | Access to /pull and /queue reload commands |
| queue.priority | Bypasses the queue and PULL_ONLY mode, connects instantly |
| queue.bypass | Super admin — ignores the entire queue system |

⚙️ Configuration

# VelocityQueue — config.yml
 
servers:
  event:
    mode: PULL_ONLY   # Staff controls who gets in
  survival:
    mode: NORMAL      # Auto-connect when reaching position #1
 
pull:
  connect-per-second: 5   # Number of connections per second (throttle)
 
messages:
  queue-position: "&eYou are &6#%position% &ein the queue for &6%server%&e."
  queue-joined: "&aYou joined the queue for &6%server%&a. Position: &6#%position%"
  pull-success: "&aYou have been pulled from the queue and are connecting to &6%server%&a."
  no-permission: "&cYou don't have permission to do this."

📦 Installation

1. Download the .jar from the Releases tab
2. Drop it into the plugins/ folder of your Velocity server
3. Restart Velocity — config.yml will be generated automatically
4. Configure your servers in plugins/velocityqueue/config.yml
5. Restart or run /queue reload

✅ No plugin needed on Paper/Spigot — everything runs on the proxy.

📌 Requirements

• Velocity 3.x
• Java 17+

🧠 Contributing

• Drop a ⭐ if the plugin is useful to you
• Suggest features or report bugs via Issues
• Follow the repo to stay up to date with new Releases

📧 Contact

For any question, idea or collaboration:
[email protected]

❤️ Credits

Plugin developed by FreneDel
Minecraft/Velocity developer — building proxy tools to improve server management and community experiences.