Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/DRCallaghan/osu-lazer-qualifier-results-bracket-generator
https://github.com/DRCallaghan/osu-lazer-qualifier-results-bracket-generator
Last synced: 3 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/DRCallaghan/osu-lazer-qualifier-results-bracket-generator
- Owner: DRCallaghan
- License: mit
- Created: 2023-01-23T04:13:27.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-05-10T17:10:32.000Z (over 1 year ago)
- Last Synced: 2024-08-01T19:44:54.266Z (6 months ago)
- Language: JavaScript
- Size: 31.3 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-osu-tournaments - osu! Lazer Tournament Client Bracket Generator CLI - 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. (Community Resources / Automation/Bots)
README
# osu! Lazer Tournament Client Bracket Generator CLI
## Licensing:
[](https://shields.io/)
See the licensing file for more information about this project's copyright information.
## Table of Contents
- [Description](#description)
- [Installation](#installation)
- [Usage](#usage)
- [Video Tutorial](#video-tutorial)
- [Contribution](#contribution)
- [Additional Info](#additional-info)
## Description:
- This project was built to provide an easy way for anyone to create a bracket.json file for their tournament running on the osu! Lazer tournament client.
- Without this program, either users must write their own custom script for exporting qualifier results into osu! Lazer, or they must input all results manually. The first solution is very technically challenging, while the manual entry can take upwards of 10 hours for large tournaments. This program solves this problem in a matter of seconds once installed properly.
- During the course of writing this program, I refreshed much of my knowledge on CLIs, proper commenting and documentation, and file structure.
- This project is, to my knowledge, the only open source and publicly available osu! Lazer tournament client script for importing qualifier results. It is also fully customizable to any tournament with a qualifier mappool; team size, qualifier pool structure, and mod pool sizes are all left up to the user.
## Installation:
- If you do not have a program which can run CLI apps installed, first install one. I recommend [VSCode](https://code.visualstudio.com/) for Windows users.
- Make sure you have [node.js](https://nodejs.org/en) installed in VSCode after downloading it. I recommend installing the LTS build recommended for most users.
- If you have git installed, clone the repo onto your drive or download the zip.
- If you do not have git installed, download a zip file of this repo.
- Open a terminal in the project directory in your code editor.
- In the terminal, type `npm i`. Then hit enter.
- Add your `maps.csv` and `scores.csv` files to the `/db` directory. For the structure of these files, see [Usage](#usage). For example structure, sample files are included in the initial download of this program.
- You are now ready to run the program!
## Usage:
- Make sure your `maps.csv` and `scores.csv` files are formatted correctly!
- `maps.csv` should follow a basic format of a header row with all slot names, followed by a single other row with all beatmap IDs. See the sample included in this download for an example.
- 
- `scores.csv` should follow the following format, in order from left to right, starting with a header row:
- Team name
- Team flag code
- All map scores, in order
- Overall Seeding
- All overall mod pool seedings, in order
- All map seedings, in order
- Each team's team size
- All player IDs for each team, in order
- All player flag codes, in order
- See the sample included in this download for an example.
- 
- Once these files are correctly formatted and in the `/db` directory, you can run the program without issue.
- In the terminal, type `node index.js`.
- Follow all directions for listed in the terminal.
- Your Lazer `bracket.json` is now in the project directory! Make sure to move it out once finished; all future uses of this program will overwrite any existing file named `bracket.json` in the project directory.
## Video Tutorial
If you prefer a video tutorial rather than following this step-by-step, please use this [companion video](https://youtu.be/FpnKxfC6Rss).
## Outside Resources
There were no collaborators on this project. My information can be found in Additional Info.
This project uses [node.js](https://nodejs.org/en) and [npm](https://www.npmjs.com/).
## Contribution
There are no guidelines for contribution as this project is closed. This project will at some point become deprecated in favor of a web build for further end-use accessibility.
## Additional Info
- Github: [DRCallaghan](https://github.com/DRCallaghan)
- Email: [email protected]
If you would like to reach me for additional questions on this project, you can send me an email at the address listed above. Please title your email "osu! Lazer Tournament Client Bracket Generator CLI - Additional Questions" so I know to reply.