RankFair – League System & Management for Darts, Bowling, Poker & Tournaments

RankFair is an Elo ranking system for recreational leagues (Darts, Bowling, Tournaments, Poker). Everything runs in a simple web interface.

Dashboard & Leagues

• Create a new league under "Create League". Owner automatically becomes League Admin.
• Add players (optionally with starting Elo), later invite more users to the league (separate roles per league).
• League settings: Rename, privacy, Premium, game type (Standard/Darts/Bowling/Poker) depending on permissions.
• "Recent Games" and leaderboard update live.

Roles & Invitations

• Roles: Owner, League Admin, User (per league), plus global Admins.
• Invitations via email; permissions only apply within the selected league.

Ranking System (Elo)

• Singles: classic Elo comparison with K=32 (expected value based on rating difference).
• Doubles: per player, the change is averaged from two hypothetical singles against both opponents.
• Administrative entries (e.g. bowling extras) can create 0-Elo games.

Premium & Administration

• Premium raises limits (e.g. player count) and unlocks convenience features.
• Admins manage users, leagues and premium status.

Record Games (Elo)

1. On the league overview, open "Record Game".
2. Select "Single" or "Doubles".
3. Assign players, set winner/loser, optional note.
4. Submit → Elo is adjusted; Δ is visible in "Recent Games".

Tournaments

• Formats: KO, Elimination, Round-Robin/League, Placement.
• Seeding: seeded, random or manual; limit bracket sizes & rounds.
• Play matches (e.g. with Darts integration) or enter results manually.

Random Matchday

• Mark attendance, automatic pairing suggestions (queue), start matches.
• All newly present players are scheduled at least once; queue adapts dynamically.

• Modes 301/501, Singles/Doubles, Best-of, starter selection.
• Input as score or remaining, bust/no-score, automatic turn change.
• Double-out check, 3-dart average, darts used.

Controls

• Keypad, "Remaining" toggle, undo with confirmation, end dialog.
• Validity: Score ≤ remaining, remaining≠1, max score 180, double-out required.

Tournaments with Darts

• Tournament match "Play" opens Darts setup with pre-filled players.
• "Continue" resumes ongoing games; results flow into bracket.

A fun game mode for social dart evenings with drinking game elements!

What is Dart And Drink?

Dart And Drink combines classic darts with entertaining drinking rules. Perfect for parties, game nights or just fun with friends.

Gameplay

• Goal: Collect points while following the drinking rules
• On certain throws: The thrower or other players must drink
• Examples: No hit = drink, Triple = others drink, Bull's Eye = everyone drinks

Customize Rules

• Drinking rules can be individually configured
• Choose between different difficulty levels
• Alcohol-free variants possible (e.g. with tasks instead of drinking)

Players & Settings

• Manage players in the league, then configure bowling settings.
• Categories (Elo±, €), order, "apply to others" rules, extras & notes.
• "Payment phase": mark paid, undo for admins, close when all paid.

• After players are created, you can start the bowling setup and open settings.
• These must be entered once before the first bowling, but can be adjusted later.

• Here you can freely define penalty categories and set a penalty that will be added later during bowling. Negative penalties are also possible.
• The Elo points to be deducted or added can also be set. This is only important for league ranking.

• Categories can also be created for all players. These are then added or charged to the other players.

• Categories can also be created for all players. These are then added or charged to the other players.

• Now the bowling game can be started and present players selected.

• An overview of players appears and their penalty is displayed.
• Clicking on a player row opens the penalties and the count can be increased with +. For league admins, - also appears to undo the penalty.

• Other penalties can be manually added to players.

• Once a bowling matchday is finished, a league admin can start the payment phase and check off players who have paid.
• Once all players have paid, the bowling matchday can be closed and appears in the list as completed.

Texas Hold'em Poker with real-time synchronization for all players!

🎮 Create New Game

• League admins and premium members can create new poker games
• Up to 8 players per table
• Optional: Chips mode with configurable starting chips and blinds

🪑 Lobby & Seats

• Claim seats: Players choose their seat themselves
• Invitations: League members can be invited to the game
• Order: Determines Dealer/Small Blind/Big Blind rotation
• Between rounds: Seats can be changed or left

💰 Chips Mode

• Starting chips: Each player starts with configurable stack (e.g. 1000)
• Blinds: Small Blind and Big Blind adjustable
• Rebuy: Admins can add or set chips
• Chip display: Everyone sees other players' stacks

🎲 Round Flow

• Start: Dealer deals hole cards (Pre-Flop)
• Flop: Reveal 3 community cards
• Turn: 4th community card
• River: 5th community card
• Showdown: Determine winner, distribute chips

📡 Live Updates

• Real-time synchronization via SSE (Server-Sent Events)
• All players see changes immediately
• Works on desktop, tablet and smartphone

Use a second device as table display for a real casino feeling!

🖥️ What is the Table Display?

The Table Display allows using a separate screen or second device (e.g. tablet, TV, laptop) as a central poker table display. Perfect for:

• A large TV in the middle of the poker table
• A tablet as dealer station
• A separate monitor for spectators

⚙️ How it works

1. Activate: In the poker lobby, turn on the "Active" switch under Table Display
2. Code generated: A unique code and QR code are created
3. Second device: Scan QR code or open link
4. Done: The display automatically shows the game state

📊 What is displayed?

• All players: Names, seat positions, chip stacks
• Community Cards: Flop, Turn, River in large view
• Dealer/Blinds: Current position of Dealer, SB, BB
• Pot size: (when chips mode active)
• Round phase: Pre-Flop, Flop, Turn, River, Showdown

🎛️ Dealer Controls

The display can also be used as dealer station:

• Start round: Deal hole cards
• Community cards: Reveal flop, turn, river
• Winner: Close round
• Touch-optimized: Large buttons for easy operation