git404hub

what is aram-mayhem-database fr?

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

Analysis updated 2026-05-18

17PythonAudience · generalComplexity · 3/5LicenseSetup · moderate

tl;dr

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.

vibe map

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 make with this?

VIBE 1

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

VIBE 2

See which augments boost or hurt a specific champion the most

VIBE 3

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

VIBE 4

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

what's the stack?

PythonSQLitePyTorchHTMLCSSJavaScript

how it stacks up fr

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 i run it?

Difficulty · moderate time til it works · 30min

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

in plain english

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.

prompts (copy fr)

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 fr?

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.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.