ELO Ranking Algorithm

Add a complete ELO ranking system to your Laravel application with just one command. Perfect for competitive games, tournaments, photo contests, and any ranking system.

Quick Start

php artisan cook:326166428473917440

The recipe will guide you through setup with interactive prompts for your model names and preferences.

What You Get

• Core ELO Algorithm - Battle-tested rating calculations
• Smart Pairing - Automatically matches similar skill levels
• Trait-based Integration - Easy to add to existing models
• Database Migrations - Score columns and vote tracking
• Comprehensive Tests - Full test coverage included

Usage

// Add traits to your models
class Player extends Model
{
    use \App\Concerns\Rating\HasElo; // Add to rankable models
}

class Tournament extends Model  
{
    use \App\Concerns\Rating\HasEloRanking; // Add to parent models
}

// Get two players for voting
[$player1, $player2] = $tournament->getTwoAppropriateRankableItems();

// Record a result
$vote = Vote::create([
    'tournament_id' => $tournament->id,
    'winner_id' => $player1->id,
    'loser_id' => $player2->id,
]);
$vote->process(); // Updates both scores

// Get rankings
$leaderboard = $tournament->getLeaderboard();
$playerScore = $player->getEloScore();
$playerRank = $player->getRankingPosition();

Perfect For

• Chess Tournaments - Rank players by skill
• Photo Contests - Vote on submissions
• Gaming Leagues - Track competitive rankings
• Sports Competitions - Calculate team ratings
• Any Competitive System - Flexible and adaptable

Features

• Configurable K-factor - Adjust rating volatility
• Draw Support - Handle tied matches
• Smart Pairing - Prevents unfair matchups
• Statistics - Leaderboards and win rates
• Atomic Commits - Clean git history

The ELO algorithm is the gold standard for competitive ranking systems, used by chess federations, gaming platforms, and sports leagues worldwide.