Updated README

This commit is contained in:
2021-06-10 14:35:51 +02:00
parent 27409a3d35
commit a1a019de62
+45
View File
@@ -1,2 +1,47 @@
# Unalike # Unalike
A lobby manager IRC bot (Python) and web interface (PHP) that enables playing multiplayer with friends on different difficulties. A lobby manager IRC bot (Python) and web interface (PHP) that enables playing multiplayer with friends on different difficulties.
Live demo at [zovguran.net/Unalike][Unalike-URL]. (It might be broken sometimes because it's what I'm actively modifying.)
## Features
- Allow users to log in with their own osu! accounts.
- Communicate with Bancho IRC while respecting the rate limits.
- Communicate with the osu! API v1 and v2 and caching the responses for less abuse.
- Monitor multiplayer results to aggregate the scores.
- Create osu! lobbies using a custom web interface.
- Send invites to users using the web interface.
- Synchronize the mapset across the lobbies.
- (Optinally) Write ".desync" in #multiplayer to turn off syncing temporarily.
- Display the results based on accuracy. (So that everyone has equal chance of winning.)
- Supports all game modes, and the score calculation is fully\* independent of the lobby settings.
*\* Score v2 might break a lobby.*
## Requirements
- A dedicated web service (Such as IIS, Apache, or XAMPP.)
- PHP 7.4.10 or greater (Untested on others, some features might break in PHP 8.)
- Python 3.2 or greater (Tested on Python 3.9.1.)
## Setup
1. Clone the source code to a subfolder of your web server.
2. Copy the files from "setup_help/" to the root of Unalike
3. Fill in the missing keys in the newly copied files.
4. (Optional) Check the configuration section of unalike.py
5. Set up a URL rewrite rule that makes "path/to/unalike/api/USERNAME/KEY/VALUE" point to "path/to/unalike/API/?username=USERNAME&KEY=VALUE" (You can just rewrite these calls manually if you want to, but using API parameters like this is very user friendly.)
## Start
1. Start start.ps1 with powershell.
2. Start your web service if it is stopped.
[Unalike-URL]: http://zovguran.net/Unalike/