Recalculate

This section introduces how to use the tools/recalculate.py tool to recalculate pp, leaderboards, star ratings, score totals, and other data.

Usage

The script is located at tools/recalculate.py. Basic usage is as follows:

usage: recalculate.py [-h] [--dry-run] [--concurrency CONCURRENCY] [--output-csv OUTPUT_CSV] [--max-cached-beatmaps-count MAX_CACHED_BEATMAPS_COUNT]
                      [--additional-count ADDITIONAL_COUNT]
                      {performance,leaderboard,score,rating,all} ...

Tip

If you deployed g0v0 using Docker, please use the following command to run the script:

docker exec -it g0v0-server uv run --no-sync python tools/recalculate.py

Common Arguments

• -h, --help: Show help message.
• --dry-run: Run command without committing changes.
• --concurrency CONCURRENCY: Maximum number of concurrent tasks.
• --output-csv OUTPUT_CSV: Output results to the specified CSV file.
• --max-cached-beatmaps-count MAX_CACHED_BEATMAPS_COUNT: Maximum number of beatmaps to cache (<=0 means no limit).
• --additional-count ADDITIONAL_COUNT: Additional beatmaps before cleanup (<=0 means cleanup immediately).

Recalculate Performance Point

You can use the subcommand performance to recalculate pp, and it supports using some filters. Please use the -h option to view available filters.

uv run --no-sync python tools/recalculate.py performance -h

This command is used to recalculate players' pp and best scores.

Recalculate Leaderboard and Statistics

If you changed settings regarding beatmaps or statistics, you can use the subcommand leaderboard to recalculate. You can also use the -h option to view filters.

uv run --no-sync python tools/recalculate.py leaderboard -h

This command is used to recalculate leaderboards and users' statistics (such as total playtime, maximum combo, so on).

Recalculate Score Totals

If you changed the mod multiplier settings, you can use the subcommand score to recalculate the total_score of all scores and rebuild the leaderboard.

uv run --no-sync python tools/recalculate.py score -h

This command recalculates total_score using the mod multiplier and rebuilds the leaderboard.

Recalculate Star Ratings

If you changed or updated the performance calculator, you might need to recalculate star ratings for all beatmaps. Use the rating subcommand. Use the -h option to view filters.

uv run --no-sync python tools/recalculate.py rating -h

Recalculate All

We provide a shortcut subcommand all to recalculate star ratings, pp, and leaderboards at once. The execution order is: Star Ratings (rating) -> PP (performance) -> Leaderboards (leaderboard).

uv run --no-sync python tools/recalculate.py all