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.

• osu-ahr
  • Table of Contents
  • Bot Feature
  • Command List
  • Latest Version
    • Version 1.5.17
      • Code Quality
  • Bot Installation
  • Bot Configuration
  • Special Thanks

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.

1. Install Node.js and Git
   • Node.js (Version 16.11.1 or Higher)
   • Git
2. Clone this repository and install libraries

> git clone https://github.com/Meowhal/osu-ahr.git
> cd osu-ahr
> npm install

3. Create a file ./config/local.json, use ./config/default.json as template.
4. Get IRC password from osu! IRC Authentication
5. 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]"
    }
  }
}

6. (Optional) Configure the bot. See the Configuration article for details.
7. 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