Epic Games Achievements

This repository contains Python code to data-mine achievements on the Epic Games Store (EGS).

Requirements

Install the latest version of Python 3.X.
Install the required packages:

pip install -r requirements.txt

Usage

First, download the sandboxId associated with every pageSlug, via epic-games-ratings.

python download_store_products.py
python download_sandbox_ids.py

The output is stored in:

data/sandbox_ids.json

NB: to distinguish base editions of games from DLC, it is recommended (but not mandatory) to keep a copy of:

data/store_data_0.json
data/store_data_1.json

Then, to retrieve the achievements associated with every sandboxId, run:

python download_achievements.py

Finally, to export trimmed results to JSON and CSV, run:

python export_results.py

Alternatively:

Run epic_games_achievements.ipynb

Results

A ranking of games sorted by number of players is available here.

Here is a description of the headers:

Game slug is the ID of the game which appears in the Epic Games store URL,
#players (EOS overlay) is the number of players who have played with Epic Online Services in background,
#completionists is the number of players who have acquired all the achievements for the game,
% of completionists is the percentage of players who are completionists, described as "Platinum" on consoles,
#players (estimate) is an estimate of the number of players based on stats about completionists,
#achievements is the number of achievements of the game,
Max % for an achievement is the highest unlock rate among all the achievements of the game,
Total XP is the total number of experience points (XP) provided by game achievements ; 1000 XP are expected.

Discussion

some games did not have achievements on release day, or had issues with the EOS overlay, so the number of players obtained via EOS should be considered as a lower-bound of the true number of players.
the percentage of completionists is rounded by Epic using one significant figure, so our estimate of the number of players via Platinum stats should be used with caution.
there are bugs. For instance, Aeon Must Die has a negative number of completionists.
if the total XP is zero, then achievements are planned, being implemented, or the studio tried but gave up.
if the highest unlock rate is 0%, then achievements are most likely broken for this game.
the total XP is not equal to 1000 XP for Alan Wake Remastered due to exceptional DLC achievements, for a total of 67 achievements (1500 XP) for the whole package, versus 50 achievements (1000 XP) for the base game.
the 100% unlock rate for an achievement ("Out of bed") of the game "Supraland" is not a bug: this achievement is obtained right at the start of the game.

woctezuma / epic-games-achievements Goto Github PK