Updated README
This commit is contained in:
@@ -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/
|
||||||
|
|||||||
Reference in New Issue
Block a user