Ripple's score server https://ripple.moe
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Giuseppe Guerra 274ab07021 1.23.1 2 weeks ago
common @ 3b58af355e Update submodules common 2 weeks ago
constants Automatically unrank approved, qualified, loved maps above a certain pp threshold 1 year ago
handlers New thread local storage (db and S3) 2 months ago
helpers Handle SIGINT and SIGTERM 1 month ago
objects Fix scores leaderboard position being 1 less if the user is restricted 1 month ago
pp Log oppai output (debug) and oppai errors to stdout 3 months ago
pubSubHandlers .SCORES. Cythonized some files 2 years ago
secret @ 45bed62642 Updated submodule secret 7 months ago
.gitignore Signore vienici a salvare 4 months ago
.gitmodules Submodule hell part 3 5 months ago
.landscape.yaml .HIDE. Update landscape config file 2 years ago
LICENSE Update README and LICENSE 3 years ago
README.md Revert "Update README" 8 months ago
full_build.sh Ignore pyenv and oppai in cython full build script 3 months ago
lets.py Handle SIGINT and SIGTERM 1 month ago
personalBestCache.py .SCORES. .HIDE. Log personal best stuff as debug 3 years ago
requirements.txt Switch to pymysql 3 months ago
run.sh Use pyoppai rather than calling oppai as a subprocess 2 years ago
runserver.bat .SCORES. More error checks in ripp 3 years ago
setup.py Force distutils Cython language, replaced tabs with spaces 3 months ago
tomejerry.py Update tomejerry to pymysql as well 3 months ago
userStatsCache.py .SCORES. General refactoring 2 years ago
version 1.23.1 2 weeks ago

README.md

LETS Code Health

Latest Essential Tatoe Server

This server handles every non real time client feature, so:

  • Ingame scoreboards
  • Score submission
  • Screenshots
  • Replays
  • osu!direct, thanks to cheesegull
  • Tillerino-like API (partially broken)
  • osu!standard and taiko pp calculation with oppai-ng, made by Franc[e]sco
  • osu!mania pp calculation with a slightly edited version of osu-tools, made by the osu! team
  • catch the beat pp calculation with catch-the-pp, made by Sunpy and cythonized by Nyo

Requirements

  • Python 3.6
  • Cython
  • C compiler

How to set up LETS

First of all, initialize and update the submodules

$ git submodule init && git submodule update

afterwards, install the required dependencies with pip

$ pip install -r requirements.txt

compile all *.pyx files to *.so or *.dll files using setup.py (distutils file). This compiles catch-the-pp as well.

$ python3 setup.py build_ext --inplace

then, run LETS once to create the default config file and edit it

$ python3 lets.py
$ nano config.ini

finally, compile oppai-ng (inside pp/oppai-ng) and osu-tools (inside pp/maniapp-osu-tools).

tomejerry.py

tomejerry.py is a tool that allows you to calculate pp for specific scores. It’s extremely useful to do mass PP recalculations if you mess something up. It uses lets’ config and packages, so make sure lets is installed and configured correctly before using it.

usage: tomejerry.py [-h]
                    [-r | -z | -i ID | -m MODS | -g GAMEMODE | -u USERID | -b BEATMAPID | -fhd]
                    [-w WORKERS] [-cs CHUNKSIZE] [-v]

pp recalc tool for ripple, new version.

optional arguments:
  -h, --help            show this help message and exit
  -r, --recalc          calculates pp for all high scores
  -z, --zero            calculates pp for 0 pp high scores
  -i ID, --id ID        calculates pp for the score with this score_id
  -m MODS, --mods MODS  calculates pp for high scores with these mods (flags)
  -g GAMEMODE, --gamemode GAMEMODE
                        calculates pp for scores played on this game mode
                        (std:0, taiko:1, ctb:2, mania:3)
  -u USERID, --userid USERID
                        calculates pp for high scores set by a specific user
                        (user_id)
  -b BEATMAPID, --beatmapid BEATMAPID
                        calculates pp for high scores played on a specific
                        beatmap (beatmap_id)
  -fhd, --fixstdhd      calculates pp for std hd high scores (14/05/2018 pp
                        algorithm changes)
  -w WORKERS, --workers WORKERS
                        number of workers. 16 by default. Max 32
  -cs CHUNKSIZE, --chunksize CHUNKSIZE
                        score chunks size
  -v, --verbose         verbose/debug mode

License

This project is licensed under the GNU AGPL 3 License.
See the “LICENSE” file for more information.