whatisgithub

What is aram-mayhem-database?

lanternko/aram-mayhem-database — explained in plain English

Analysis updated 2026-05-18

17PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

In one sentence

ARAM Mayhem Database tracks League of Legends ARAM Mayhem match data that Riot's public API no longer provides, and publishes a free champion tier list and augment recommendation website built from community-submitted data.

Mindmap

mindmap
  root((repo))
    What it does
      Tracks Mayhem stats
      Champion tier list
      Augment recommendations
    Tech stack
      Python
      SQLite
      HTML CSS JS
    Use cases
      Check champion tiers
      Find best augments
      Contribute match data
    Audience
      LoL players
      Mayhem fans

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Check which League of Legends champions have the best win rates in ARAM Mayhem

USE CASE 2

See which augments boost or hurt a specific champion the most

USE CASE 3

Contribute your own match data by running the collector while logged into League of Legends

USE CASE 4

Deploy your own version of the tier list website from collected match data

What is it built with?

PythonSQLitePyTorchHTMLCSSJavaScript

How does it compare?

lanternko/aram-mayhem-database0petru/sentimoalingalingling/akasha-wechat
Stars171717
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/53/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Contributing requires the League of Legends client running and logged in, plus Python 3.13 or newer.

So what is it?

ARAM Mayhem Database is a community project that tracks player statistics for a League of Legends game mode called ARAM Mayhem. Riot Games removed this mode from its public match history API starting around patch 14, so websites like OP.GG and U.GG cannot show any data for it. This project works around that limit by using the local API built into the League of Legends client itself, which can still show your own recent matches and the matches of people you have played against. A small program called a collector runs on a contributor's computer while they are logged into the League client. It follows a chain outward from the contributor, checking their own matches, then friends, then opponents, then opponents of opponents, gathering the champion picks, chosen augments, and win or loss results from each ARAM Mayhem match it finds. That data is saved locally, then exported as a file containing no personal player IDs, which the contributor shares by opening a GitHub Issue and attaching it. Submissions merge automatically without duplicates. So far the project has collected roughly 38,000 matches. The results are published as a free website showing which champions perform best, ranked by a win rate calculation that accounts for how many games were played so lucky streaks do not skew rankings. Clicking a champion shows which in-game augments help or hurt it the most, with descriptions shown in Chinese. Visitors can filter by role and search in Chinese or English, and the site adjusts automatically for phone screens. The site itself is plain HTML, CSS, and JavaScript with no framework and no server, hosted for free through GitHub Pages. The data gathering scripts are written in Python. The project plans to eventually add a machine learning model to predict how well two champions perform when paired together. It is an unofficial fan project and is not affiliated with or endorsed by Riot Games. It is released under the MIT license.

Copy-paste prompts

Prompt 1
Explain how ARAM-Mayhem-Database collects match data since Riot removed Mayhem from its public API.
Prompt 2
Walk me through running the LCU collector script to contribute my own ARAM Mayhem match data.
Prompt 3
How does the Bayesian win rate smoothing in this project work and why does it matter for small sample sizes?
Prompt 4
Help me set up build_tier_list.py to generate my own tier list site from the SQLite database.

Frequently asked questions

What is aram-mayhem-database?

ARAM Mayhem Database tracks League of Legends ARAM Mayhem match data that Riot's public API no longer provides, and publishes a free champion tier list and augment recommendation website built from community-submitted data.

What language is aram-mayhem-database written in?

Mainly Python. The stack also includes Python, SQLite, PyTorch.

How hard is aram-mayhem-database to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is aram-mayhem-database for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.