Titanic

Titanic is a private server made to be compatible with all osu! stable clients (2008-2024). The goal of this project was to gain deeper insights into the inner workings of bancho and how it changed over the years.

The main goal of this project was achieved. There are still some features that I want to add, which you can view here.

You can play on it, by registering on the website, and downloading a client from the website. Keep in mind that only a smaller range of clients will be available there. For anyone interested, we also got a discord server: https://discord.gg/qupv72e7YH

Setup

To set up and use this project I would recommend to use docker, as it's easier to set up in most cases. If you do not feel comfortable using docker, here are some instructions for the manual setup, which is not recommended but still possible to do.

Verify that docker is installed:

docker --version

Clone this project onto your machine:

git clone --recurse-submodules --shallow-submodules https://github.com/osuTitanic/titanic.git

Rename the .example_env to .env and edit it.

Start the server:

docker compose up -d

("-d" argument means detached, meaning that containers will run in background)

To turn off the server, from the titanic root folder, execute:

docker compose stop

If you changed some files around, and don't see your changes applied, execute:

(rebuild)
docker compose build
(apply changes & restart affected containers)
docker compose up -d

Adding beatmaps

To add beatmaps, you will need to create them manually, inside the database, since the beatmap submission system is not implemented at the moment.

However, I have a small collection of beatmaps and beatmapsets that you can import to your database:

• beatmapsets.sql.gz
• beatmaps.sql.gz

They are gzip-compressed sql files, which contain a total of 140k beatmaps from 2007-2013.

Patching the client

You can view the instructions for patching the client here.

Contributing

You are welcome to make any kinds of suggestions or contributions to this project. Feel free to contact me if you have any questions.

Credits

• kanaarima for helping with the discord bot & developing the pp system
• osu.direct & nerinyan.moe for providing beatmap resources
• rory for funny playtesting
• Everyone that donated & contributed to this project (you guys are a big help!)

Screenshots

b20130606.1

b20130303

b1700