osu-ahr is auto host rotation bot for osu! multiplayer. The host rotation is managed with a queue. Players are added to the queue when joining a multiplayer room and sent to the back of the queue once their beatmap has been played.
Main page: Bot Usage Guides
These are what osu-ahr bot can do osu! bancho server:
- Creating new multiplayer room
- Managing existing multiplayer room
- IRC chat support in managed multiplayer room
- Managing host rotation queue
- Add map selection regulation
- Skipping current host
- Starting the match
- Aborting the match
- Preventing AFK players from squatting the room
- Closing the multiplayer room
Main page: Bot Command
For full changelog history, see: Changelog
- Add compiled JavaScript files for faster running option
For bot configuration, see Bot Configuration article.
- Install Node.js and Git
- Clone this repository and install libraries
> git clone https://github.com/Meowhal/osu-ahr.git
> cd osu-ahr
> npm install
- Create a file
./config/local.json
, use./config/default.json
as template. - Get IRC password from osu! IRC Authentication
- Enter your account ID and IRC password to
./config/local.json
as in the following example.
{
"irc": {
"server": "irc.ppy.sh",
"nick": "[your account id]",
"opt": {
"port": 6667,
"password": "[your account password]"
}
}
}
- (Optional) Configure the bot. See the Configuration article for details.
- Launch the bot. Note: You can also run your bot on Discord. See the Discord Integration article for details.
> npm run start
starting up...
Connecting to Osu Bancho ...
Connected :D
=== Welcome to osu-ahr ===
MainMenu Commands
[make <Lobby_name>] Make a lobby. e.g. 'make 5* auto host rotation'
[enter <LobbyID>] Enter the lobby. e.g. 'enter 123456' (It only works if you are a referee in the lobby).
[help] Show this message.
[quit] Quit the application.
> make 5-6* | auto host rotation
Main page: Bot Configuration
- Meowhalfannumber1
- He made great suggestions.
- Metacinnabar
- He helped me with the Japanese translation.
- ZeroPyrozen
- He helped me improve the map checker.
- qqzzy
- He gives me various insights.
- https://github.com/jramseygreen/osu_bot_framework-v3