Awesome osu! tournaments

This is a collection of useful tools and resources for managing an osu! tournament.

Table of contents

1. Awesome osu! tournaments
   1. Official Resources
      1. Development/API
      2. Official Support
      3. Clients
      4. Wiki/Forum
   2. Community Resources
      1. Automation/Bots
      2. Databases
      3. Development
      4. Spreadsheet Scripts/Tools
      5. Templates
      6. Tools
      7. Tutorials
      8. Website Templates
      9. Tournament Overlay Templates

Official Resources

Development/API

• AppsScript Documentation - Information about Google AppsScript.
• Google Sheets Function Documentation - Information about every single Google Sheets function.
• osu-api v1 Documentation - Information about interfacing with osu! API v1.
• osu-api v2 Documentation - Information about interfacing with osu! API v2.

Official Support

• Official tournament support - Information about screening, badging and main-menu banners.
• Official Tournament Support Updates - A thread of all changes to the above wiki starting in February 2023.

Clients

• osu!tourney - Information about the usage and setup osu!tourney (also referred to tourney client, stable tourney client, etc).
• osu!tournament client - Information about the usage and setup of the tournament client in osu!lazer.

Wiki/Forum

• Tournaments - List of official and community hosted osu! tournaments on the osu!wiki.
• Tournaments sub-forum - Dedicated subforum for promoting and/or participating in osu! tournaments.

Community Resources

Automation/Bots

• Player avatar download bulk tool (by oliebol) - Download osu! avatar images in bulk so you can use them in places like osu!lazer.
• Tosurnament (by SpartanPlume) - Discord bot that automates most Discord/spreadsheet relationships.
• osu! Lazer Tournament Client Bracket Generator CLI (by D I O) - Command-line interfacing program for automatically generating a complete bracket.json file for the osu! Lazer tournament client by taking qualifier results, player and team information, qualifier pool information, and tournament information.

Databases

• Badged Tournaments:
  • Mappools only:
    • 2019 5 Digit (by unknown)
  • 2020 (by DizzyH and Mirthille)
  • 2021 (by DizzyH)
  • 2022 (by DizzyH)
• Maps listed by skillset (by unknown) - Ranges from 4* - 8* pools. Note that this doesn’t mean a skillset shoud be confined to the slot given in the sheet.
• osu! Tournament & Map Database (by Konotorii) - Tournament map database targetting easier pooling for mappoolers.
• osu! Tournament Union Mappool Database Tool (by Stage, HitomiChan_ in collaboration with Dominick, 112servis, and o!TU database staff) - Interactive tool for finding maps of specific parameters and skillsets.

Development

• bancho.js (by ThePoon) - JS Library for interfacing with Bancho over IRC.
• BanchoSharp (by Stage) - C# library that manages connecting to osu!Bancho and automatically manages multiplayer lobbies. Used by Brigitta and Bancho Multiplayer Bot.
• passport-osu (by MiraiSubject) - osu! authentication strategy for Passport and Node.js.
• osu! provider for NextAuth.js (by NextAuth.js Contributors) - osu! authentication provider for NextAuth and Next.js
• osu.js (by Mario564) - An unofficial Javascript and Typescript SDK for the browser-facing portion of osu! with type safety in mind.

Spreadsheet Scripts/Tools

• osu! api fetch stuff for google scripts (by oliebol) - Sample code to interface with the osu! api using Google Sheets

Templates

• BBCode generator for staff in forum posts (by Nathaniel) - Generate BBCode to nicely display your staff in the tournament forum post.
• Mappool, qualifier and referee sheet templates (by IceDynamix) - Sheets for mappool and referee management in the backend, as well as a sheet to organise qualifier results.
• Player and staffing history sheet template (by HitomiChan) - You can track current and past tournaments that you have participated in as either staff or player.
• Referee sheets (by RussianVaxei) - Includes templates for overseeing qualifiers and matches.
• Team management templates (by RussianVaxei) - Track your team’s statistics and availability using this collection of sheet templates.
• Dio and LeoFLT’s tournament sheet templates (by Dio and LeoFLT) - Includes sheets for administration, mappooling, qualifiers, referees, statistics, tryouts, and team management.
• HitomiChan’s tournament sheet templates (by HitomiChan) - Includes templates for mappooling, reffing, statistics, and player administration.
• Nathaniel’s tournament sheet templates (by Nathaniel) - Includes 1v1 templates for administration, mappooling, and reffing, as well as a BBCode forum post generator.
• Team tournament template (by Mario564) - Manage your team by keeping track of the team’s availability, scores, lost and won maps and compare opponent’s scores in previous rounds.
• Player tournament history sheet template (by Squink) - Display tournament history data in an organized manner with additional teammate data automatically updated on the side.
• bracket.json Template (by BCraftMG) - Empty bracket.json for use with Lazer. Includes Ro64-Ro16 Single/Double Elimination

Tools

• IRC:
  • chat4osu! (by hallowatcher) - IRC chat client for referees and casual chatters.
  • Brigitta (by Stage) - IRC client made specifically for tournament referees - primary attraction is detailed interactive display while reffing.

  • Script chan (by shARPII) - Referee tool to create and manage lobbies.

  • Bancho Multiplayer Bot (by matte-ek) - Tool for creating multiplayer lobbies and automating them.
• gosumemory! (by l3lackShark) - Cross-Platform memory reader.
• tosu (by KotRikD) - Eponymous software for reading osu! memory, accounting for most of gosumemory’s issues.

Tutorials

• Various Tournament Video Tutorials (by Dio) - A series of tournament video tutorials on a variety of topics, including the tournament client, the lazer client, streaming, reffing, sheeting, and more. Receives periodic updates with new videos.
• Tournament Hosting Guide (by Fairy Bread a.k.a. ill onion) - The longest plain-text guide on hosting and staffing osu! tournaments, covering basically every aspect for Standard tournaments and all aspects besides mappooling for other game mode tournaments.
• Comprehensive Tournament Role Guide (by Nathaniel) - A compregensive plain-text guide on almost, if not every, single role and aspect for Standard tournaments, with links and references to other resources like role-specific guides and templates.
• Mappooling Guide (by dqwed) - A more modern mappooling guide as a counterpart to the more famous mappooling guides by Dada and Smoothie World.
• Mappool video guide (by DigitalHypno) - A video guide on mappooling.
• Pooling for 6 Digits (by Quag) - A mappooling guide for the 6 digit rank range.
• Refereeing Guide (by Yazzehh) - A text guide on refereeing, including tournament client setup for live-spectating any match you happen to be reffing.
• Regex for Discord Handles and osu! User IDs (by Dio) - A text guide on using regular expressions to control registration form input.

Website Templates

• Cosette Lite (by MiraiSubject) - Verify players for your tournament and join them to your Tournament server securely!

Tournament Overlay Templates

• VCL Tournament Overlay - Lazer edition (by Hoaq) - Gosumemory-compatible tournament overlay, made to simplifies the trouble with setting up Lazer overlay. Supports both score and accuracy win conditions.