Skip to main content

Getting Started with NeatQueue

Welcome to NeatQueue! This comprehensive guide will help you understand what NeatQueue is and how to get started with your competitive gaming community.

What is NeatQueue?​

NeatQueue is a powerful Discord bot designed for managing competitive game queues with advanced matchmaking, statistics tracking, and extensive customization options.

Key Features​

  • 🎮 Automated Queue Management - Players can join/leave queues with simple button clicks
  • 📊 MMR & Ranking System - Track player skill levels and create balanced teams
  • ⚖️ Flexible Team Selection - Choose from random, MMR-balanced, captain picks, or player voting
  • 🏆 Statistics & Leaderboards - Comprehensive tracking of player performance and history
  • 🎯 Multi-Queue Support - Run multiple independent queues for different games or modes
  • 🎨 Premium Customization - Custom branding, colors, images, and advanced features

Installation​

Step 1: Invite the Bot​

Invite NeatQueue to your Discord server

Step 2: Create Your First Queue​

Run /setup in the channel where you want to create a queue. The interactive setup will guide you through all configuration options.

What You'll Learn​

This documentation covers everything you need to set up and manage NeatQueue:

📖 Core Guides​

🔧 Advanced Configuration​

Basic Concepts​

Queues​

A queue is a persistent waiting area for players who want to play together. When enough players join, teams are automatically created and the match begins. You don't need to recreate the queue after each match—it stays active for continuous use.

MMR (Match Making Rating)​

MMR is a skill rating system that helps create balanced teams. NeatQueue tracks wins/losses and adjusts each player's MMR accordingly. Higher MMR indicates a more skilled player.

Queue Types​

NeatQueue supports four queue types:

  1. PUGs/Normal Queue - Players join individually, default setup
  2. Matchmaking - MMR-based matching within skill ranges
  3. Full Team vs Full Team - Captains bring entire pre-formed teams
  4. Select Team On Join - Players choose which team when joining

Command Categories​

Commands are organized by access level:

  • User Commands - Available to all server members (join queue, view stats, etc.)
  • Admin Commands - Require "Manage Channels" permission or a configured staff role
  • Premium Commands - Exclusive features for premium subscribers

Understanding Permissions​

Who Can Manage Queues?​

By default, queue management requires:

  • Manage Channels permission (standard Discord permission), OR
  • NeatQueue Staff Role (configured with /staffrole add)

Granting Staff Access​

Allow moderators to help manage queues:

/staffrole add @Moderator

For granular control, allow specific commands:

/staffrole command allow /player add @Helper

Quick Start Path​

Ready to dive in? Follow this learning path:

  1. Quick Start ← Start here for a basic queue
  2. Complete Setup Guide ← Learn all configuration options (includes advanced features)
  3. Leaderboard and Stats ← Set up stats tracking
  4. MMR System and Ranks ← Add competitive ranks

Community and Support​

Need help or want to connect with other NeatQueue users?

Important Note

NeatQueue is a Discord bot, not a standalone platform. All matches, coordination, and communication happen within Discord. The bot manages queues, tracks stats, and organizes teams, but the actual gameplay happens in your game of choice.

Next Steps​

Choose your path: