Skip to content

Rank Queue is an eSports competitive platform that brings ranking and matchmaking systems to non-ranked games. It enables solo/duo and squad queues, custom tournaments, and competitive matchmaking for community-driven games like Stronghold Crusader, MOHAA, CS, Valorant customs, and more.

Notifications You must be signed in to change notification settings

youssefhamdy7dev/rank-queue

Repository files navigation

Rank Queue

Rank Queue is an eSports competitive platform designed to apply structured ranking and matchmaking systems to non-ranked and custom games. It enables gaming communities to create fair, competitive environments where official ranked modes do not exist.


🎮 Overview & 🧠 Concept

Many classic, legacy, or custom multiplayer games lack built-in ranked systems, matchmaking, or competitive progression.
Rank Queue solves this problem by introducing:

  • Structured competitive queues
  • Player ranking and progression
  • Community-driven tournaments
  • Fair matchmaking rules
  • Real-time interaction inside match lobbies

Inspired by competitive platforms, Rank Queue brings competitive integrity to games that were never designed for ranked play.


🎮 Supported Game Types

Rank Queue is suitable for custom or non-ranked games such as:

  • Stronghold Crusader
  • MOHAA / MOHAA Spearhead / MOHAA Breakthrough
  • Counter-Strike (CS 1.6, CS2, and other versions – Custom Games)
  • Valorant Custom Games
  • League of Legends Custom Games
  • Similar community-based competitive games

🚀 Core Features

🎯 Matchmaking

  • Competitive matchmaking logic
  • Solo / Duo queue
  • Squad queue
  • Balanced team formation
  • Queue state handling (join, leave, match creation)

🏆 Ranking System

  • Player ranking progression
  • Rank updates based on match results
  • Competitive ladder structure
  • Community-oriented ranking rules

🏟 Tournaments

  • Custom tournament creation
  • Community-hosted competitions
  • Manual or automated match flow
  • Flexible formats depending on the game

⚡ Real-Time Match Lobby

  • Live chat between players
  • Real-time lobby actions
  • Match-related live updates
  • Interactive pre-match and in-match experience

🛠 Tech Stack

Backend

  • PHP
  • Laravel
  • RESTful API architecture
  • Real-time event handling
  • Scalable service-oriented design

Database

  • MySQL

Frontend

  • React.js
  • Real-time UI updates
  • API-driven architecture

🔗 System Architecture

React Frontend ↓ RESTful API + Real-Time Events ↓ Laravel Backend ↓ MySQL Database

  • RESTful APIs handle core business logic
  • Real-time layer powers live chat and lobby actions
  • Frontend reflects live state changes instantly
  • Designed for scalability and community growth

📡 API & Real-Time Responsibilities

  • User authentication & authorization
  • Queue join / leave operations
  • Match creation and result submission
  • Rank calculation and updates
  • Tournament management
  • Real-time chat messaging
  • Live lobby state synchronization

🎯 Target Audience

  • Gaming communities
  • Competitive players in non-ranked or legacy games
  • eSports organizers hosting custom matches
  • Community admins managing competitive ladders

🔒 Design Principles

  • Community-first approach
  • Fair and transparent ranking logic
  • Scalable architecture
  • Game-agnostic competitive system
  • Real-time interaction and engagement

🔮 Future Enhancements

  • Advanced ranking algorithms
  • Match history and detailed statistics
  • Anti-smurf and abuse detection
  • Public leaderboards and seasonal rankings
  • Admin dashboard for moderation and tournament control
  • Extended real-time match analytics

👨‍💻 Author

Youssef Hamdy Ahmed Mohamed


Rank Queue exists to bring competitive structure where ranked modes don’t.

About

Rank Queue is an eSports competitive platform that brings ranking and matchmaking systems to non-ranked games. It enables solo/duo and squad queues, custom tournaments, and competitive matchmaking for community-driven games like Stronghold Crusader, MOHAA, CS, Valorant customs, and more.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors