From 726e490fe273507ddad4038f153ce076145f7cff Mon Sep 17 00:00:00 2001
From: Holly <onlinegamer748@gmail.com>
Date: Sun, 10 Sep 2023 13:14:37 +0100
Subject: [PATCH] Update README.md

---
 README.md | 87 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 86 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 50de3f7..64358f9 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,86 @@
-# The TypeScript rewrite is mostly feature complete but is still missing some features [as well as having some strange behaviours](https://github.com/tgpholly/Binato/issues/16). If you would like to use this I would suggest using the [old JavaScript version](https://github.com/tgpholly/Binato/tree/master) for now.
+# Binato [![CodeFactor](https://www.codefactor.io/repository/github/tgpholly/binato/badge)](https://www.codefactor.io/repository/github/tgpholly/binato)
+An implementation of osu!bancho in Javascript
+
+i'm sorry peppy
+<hr>
+
+### Features:
+ - Multiplayer + Invites
+ - Spectator
+ - Tourney Client
+ - User Panel
+ - Friends List
+ - Chat & Channels
+ - Private Messages
+ - Chat Bot (see [commands folder](https://github.com/tgpholly/Binato/tree/master/server/commands))
+   
+### [Planned additions](https://github.com/tgpholly/Binato/issues?q=is%3Aopen+is%3Aissue+label%3Aenhancement) | [List of currently known bugs](https://github.com/tgpethan/Binato/issues?q=is%3Aopen+is%3Aissue+label%3Abug)
+
+<hr>
+
+## Setup:
+While I don't support setting this up yourself it is fairly easy to do, all that should be required is:
+ - **NodeJS > 16**
+ - **MariaDB**
+ - Optional (Disabled via config):
+   - **Redis**
+   - **Prometheus**
+
+Clone the repo and run `npm i` to install required packages, then copy `config.example.json` to `config.json` and edit to your liking (this is where http compression, prometheus and redis can be enabled/disabled)
+
+After doing this running `npm run dev:run` should start the server.
+
+If you want to build something standalone you can run the build process using `npm run build`.
+
+## Reporting bugs:
+To report a bug [create a new issue](https://github.com/tgpholly/Binato/issues/new) and include information such as your OS / Distro, Node version, disabled Binato features (e.g. Prometheus, Redis, compression) and console output at the time of the bug if applicable.
+
+<hr>
+
+## How to connect:
+See <ins>Now (2022 - 2023)</ins> for the prefered way to connect now.
+
+### 2013 - Stable Fallback (2015 / 2016 ?):
+From 2013 to the Fallback client HTTP can be used, so for that you just need to direct it to the server<br>
+You can do this using the hosts file
+
+Location on Linux: `/etc/hosts`<br>
+Location on Mac: `/private/etc/hosts`<br>
+Location on Windows: `C:\Windows\system32\drivers\etc\hosts`
+
+Add an entry in the hosts file that looks like the following:
+```
+<server_ip> osu.ppy.sh c.ppy.sh c1.ppy.sh
+```
+Where <server_ip> is the IP Address of the server hosting the bancho server
+
+### 2016 - Early 2021:
+Versions of osu! past Stable Fallback use HTTPS and as such you'll have to create a self signed certificate and make the server identify as ppy.sh<br>
+In 2018 there were also new subdomains added which are: 
+ - c2.ppy.sh
+ - c3.ppy.sh
+ - c4.ppy.sh
+ - c5.ppy.sh
+ - c6.ppy.sh
+ - ce.ppy.sh
+
+### Now (2022 - 2023):
+There is a `-devserver` launch flag in the game which can be passed to the client to connect to a specific server. Example usage:
+```
+osu!.exe -devserver eusv.net
+```
+You need to have your subdomains structured like osu!'s with the exception of `c*.ppy.sh` domains. There is only one that is polled for `-devserver` usage.
+
+An example setup would be:
+ - osu.example.com (Score submit & web stuff)
+ - c.example.com (Bancho)
+ - a.example.com (Profile pictures)
+
+In addition to all of this, your domain **must** have HTTPS. I recommend [Cloudflare](https://www.cloudflare.com/) for this task.
+<hr>
+
+## Other Binato components:
+### Website:
+Binato's website is handled by [Binato-Website](https://github.com/tgpholly/Binato-Website)
+### Profile Pictures:
+Profile pictures can be handled by any standard HTTP server, there is also one I made for the task here: [Binato-ProfilePicture](https://github.com/tgpholly/Binato-ProfilePicture)