How osu!pepe works

The main score and user data comes from the public osu! performance dumps on data.ppy.sh. Those dumps provide the large historical base used by rankings, profiles, score lists, and beatmap activity pages.

osu!pepe also refreshes top players through the official osu! API, mainly to keep recent scores, profile pp, and global rank closer to current osu! data.

The worker checks once per day for a newer public dump. If osu! has published a newer dump, osu!pepe downloads it and rebuilds the app data from it.

Between full dump updates, the worker cycles through top players and refreshes them from the osu! API. In practice, top players can update multiple times per day when the worker is running, while the wider dataset follows the dump schedule.

osu!pepe is not reading all osu! scores live on every page load. It reads its own stored copy of the data, then refreshes that copy over time.

A new score may appear quickly for refreshed top players, or later after the next full dump and processing pass. A player can also be absent from a ruleset if he is not in the top-ranked players for that ruleset at the beginning of the month.

Live API refreshes are limited to the highest-ranked players so the updater can run continuously without hammering the osu! API.

osu!standard refreshes the top 2500 players (official osu! pp rank) through the API. osu!taiko, osu!catch, and osu!mania only refresh the top 1000 players.

If your profile is outside those ranges, it usually has to wait for the next public data dump and the next processing pass before new scores or rank changes appear. Usually 1st or 2nd day of the month.

Badges compare how much of a player's performance comes from a mod against what is normal for that mod across the player pool.

They also consider how strong the player is among people who have performance in that mod. The occurences % are hand-adjusted. NF is ignored, and badges like HT or EZ are rarer occurences.

A badge therefore means "this player is unusually specialized here", not simply "this is their highest mod pp".

This is a single person's hobby project that was hacked together to run as efficiently as possible on a cheap VPS. Everything is quite a bit complicated, and it may be possible that things are broken sometimes.

You can report a bug or suggest an improvement by private message on Discord to bastoo0. Note that while I read all messages, I may not be able to respond to every report or suggestion.