0.3.5

This readme is incomplete! Feel free to help me add to it!

TournamentAssistant

A program designed to make it easier to coordinate tournaments for the VR rhythm game Beat Saber

Changelog

        0.0.1: Begin assembling UI for coordinator panels
        0.1.1: Implemented versioning system
        0.1.2: Fixed song download bug
        0.1.3: Recreated song detail view, refactored tournament flowcoordinator into room flowcoordinator, added match destroying / player leaving to back button on TournamentAssistant side
        0.1.4: Added Teams
        0.1.5: Reorganized workflow, baby-proofed server disconnections
        0.1.6: Updated for QR Sync
        0.1.7: Bugfixes
        0.1.8: Bugfixes
        0.1.9: Re-added no-arrows
        0.2.0: Prevent players from pausing, added mod list grabber
        0.2.1: BeatKhana charity event version
        0.2.2: Bugfixes, added DisableFail
        0.2.5: Added Banned Mods checking, bugfixes
        0.2.8: Fixed server config overwriting, added IPV6 support, behind-the-scenes work on Qualifiers
        0.3.0: Finished implementing qualifiers and decentralized network
        0.3.1: (skipped due to github issue)
        0.3.2: Added downloading from custom hosts, qualifier event settings
        0.3.3: Version bump for 0.12.2
        0.3.4: Fixed QR codes, BattleSaber, "Gathering Data" bug
        0.3.5: Fixed Oculus bug

How To Coordinate a Match

• Download the latest release build (TournamentAssistantUI.exe) from Releases

Usage

• Run TournamentAssistantUI.exe
• Enter the server address/port in the “Host IP” box
• Enter your username in the “Username” box and click Connect
• Click on the desired players’ names so that they become highlighted and then press the blue “Create Match” button
• When in the Match Room, paste the desired song link or key into the “Song URL” box
• Click “Load Song” and wait for a the song to load (If you look closely, you’ll notice the button itself is the progress bar)
• Select your desired characteristic (standard, one saber, etc.), difficulty (easy-expert+), and modifiers (no fail, faster song, etc.)
• Click the “Play Song” button

With Stream Sync (Optional)

• Instead of clicking the “Play Song” button, click “Play Song (With Dual Sync)”
• You will see a green box highlighting one of your monitors. Be sure the streams you want to sync are visible insdie that monitor
• Note: If the matches are streamed to a central channel (as for most tournaments) you will have to use that channel for Sync. Do not sync by pulling up the players' individual streams

How to Host a Server

• Download the latest release build (TournamentAssistantCore-release-[platform].zip) from Releases and extract it to any location
• Run TournamentAssistantCore.exe (or the linux equivalent) once to generate serverConfig.json
• Modify serverConfig.json to set your desired port and ServerName
• Run TournamentAssistantCore.exe again!
• (You may also change other settings and add teams, an overlay, or a list of banned mods!)

TODO

Please help me improve this readme!

Contributing

Pull requests are welcome! Feel free to dm me on discord if you have any questions or concerns!

License

MIT

0.3.4

This readme is incomplete! Feel free to help me add to it!

TournamentAssistant

A program designed to make it easier to coordinate tournaments for the VR rhythm game Beat Saber

Changelog

        0.0.1: Begin assembling UI for coordinator panels
        0.1.1: Implemented versioning system
        0.1.2: Fixed song download bug
        0.1.3: Recreated song detail view, refactored tournament flowcoordinator into room flowcoordinator, added match destroying / player leaving to back button on TournamentAssistant side
        0.1.4: Added Teams
        0.1.5: Reorganized workflow, baby-proofed server disconnections
        0.1.6: Updated for QR Sync
        0.1.7: Bugfixes
        0.1.8: Bugfixes
        0.1.9: Re-added no-arrows
        0.2.0: Prevent players from pausing, added mod list grabber
        0.2.1: BeatKhana charity event version
        0.2.2: Bugfixes, added DisableFail
        0.2.5: Added Banned Mods checking, bugfixes
        0.2.8: Fixed server config overwriting, added IPV6 support, behind-the-scenes work on Qualifiers
        0.3.0: Finished implementing qualifiers and decentralized network
        0.3.1: (skipped due to github issue)
        0.3.2: Added downloading from custom hosts, qualifier event settings
        0.3.3: Version bump for 0.12.2
        0.3.4: Fixed QR codes, BattleSaber, "Gathering Data" bug

How To Coordinate a Match

• Download the latest release build (TournamentAssistantUI.exe) from Releases

Usage

• Run TournamentAssistantUI.exe
• Enter the server address/port in the “Host IP” box
• Enter your username in the “Username” box and click Connect
• Click on the desired players’ names so that they become highlighted and then press the blue “Create Match” button
• When in the Match Room, paste the desired song link or key into the “Song URL” box
• Click “Load Song” and wait for a the song to load (If you look closely, you’ll notice the button itself is the progress bar)
• Select your desired characteristic (standard, one saber, etc.), difficulty (easy-expert+), and modifiers (no fail, faster song, etc.)
• Click the “Play Song” button

With Stream Sync (Optional)

• Instead of clicking the “Play Song” button, click “Play Song (With Dual Sync)”
• You will see a green box highlighting one of your monitors. Be sure the streams you want to sync are visible insdie that monitor
• Note: If the matches are streamed to a central channel (as for most tournaments) you will have to use that channel for Sync. Do not sync by pulling up the players' individual streams

How to Host a Server

• Download the latest release build (TournamentAssistantCore-release-[platform].zip) from Releases and extract it to any location
• Run TournamentAssistantCore.exe (or the linux equivalent) once to generate serverConfig.json
• Modify serverConfig.json to set your desired port and ServerName
• Run TournamentAssistantCore.exe again!
• (You may also change other settings and add teams, an overlay, or a list of banned mods!)

TODO

Please help me improve this readme!

Contributing

Pull requests are welcome! Feel free to dm me on discord if you have any questions or concerns!

License

MIT

0.3.3

This readme is incomplete! Feel free to help me add to it!

TournamentAssistant

A program designed to make it easier to coordinate tournaments for the VR rhythm game Beat Saber

How To Coordinate a Match

• Download the latest release build (TournamentAssistantUI.exe) from Releases

Usage

• Run TournamentAssistantUI.exe
• Enter the server address/port in the “Host IP” box
• Enter your username in the “Username” box and click Connect
• Click on the desired players’ names so that they become highlighted and then press the blue “Create Match” button
• When in the Match Room, paste the desired song link or key into the “Song URL” box
• Click “Load Song” and wait for a the song to load (If you look closely, you’ll notice the button itself is the progress bar)
• Select your desired characteristic (standard, one saber, etc.), difficulty (easy-expert+), and modifiers (no fail, faster song, etc.)
• Click the “Play Song” button

With Stream Sync (Optional)

• Instead of clicking the “Play Song” button, click “Play Song (With Dual Sync)”
• You will see a green box highlighting one of your monitors. Be sure the streams you want to sync are visible insdie that monitor
• Note: If the matches are streamed to a central channel (as for most tournaments) you will have to use that channel for Sync. Do not sync by pulling up the players' individual streams

How to Host a Server

• Download the latest release build (TournamentAssistantCore-release-[platform].zip) from Releases and extract it to any location
• Run TournamentAssistantCore.exe (or the linux equivalent) once to generate serverConfig.json
• Modify serverConfig.json to set your desired port and ServerName
• Run TournamentAssistantCore.exe again!
• (You may also change other settings and add teams, an overlay, or a list of banned mods!)

TODO

Please help me improve this readme!

Contributing

Pull requests are welcome! Feel free to dm me on discord if you have any questions or concerns!

License

MIT

0.3.2

This readme is incomplete! Feel free to help me add to it!

TournamentAssistant

A program designed to make it easier to coordinate tournaments for the VR rhythm game Beat Saber

How To Coordinate a Match

• Download the latest release build (TournamentAssistantUI.exe) from Releases

Usage

• Run TournamentAssistantUI.exe
• Enter the server address/port in the “Host IP” box
• Enter your username in the “Username” box and click Connect
• Click on the desired players’ names so that they become highlighted and then press the blue “Create Match” button
• When in the Match Room, paste the desired song link or key into the “Song URL” box
• Click “Load Song” and wait for a the song to load (If you look closely, you’ll notice the button itself is the progress bar)
• Select your desired characteristic (standard, one saber, etc.), difficulty (easy-expert+), and modifiers (no fail, faster song, etc.)
• Click the “Play Song” button

With Stream Sync (Optional)

• Instead of clicking the “Play Song” button, click “Play Song (With Dual Sync)”
• You will see a green box highlighting one of your monitors. Be sure the streams you want to sync are visible insdie that monitor
• Note: If the matches are streamed to a central channel (as for most tournaments) you will have to use that channel for Sync. Do not sync by pulling up the players' individual streams

How to Host a Server

• Download the latest release build (TournamentAssistantCore-release-[platform].zip) from Releases and extract it to any location
• Run TournamentAssistantCore.exe (or the linux equivalent) once to generate serverConfig.json
• Modify serverConfig.json to set your desired port and ServerName
• Run TournamentAssistantCore.exe again!
• (You may also change other settings and add teams, an overlay, or a list of banned mods!)

TODO

Please help me improve this readme!

Contributing

Pull requests are welcome! Feel free to dm me on discord if you have any questions or concerns!

License

MIT

0.3.0

This readme is incomplete! Feel free to help me add to it!

TournamentAssistant

A program designed to make it easier to coordinate tournaments for the VR rhythm game Beat Saber

How To Coordinate a Match

• Download the latest release build (TournamentAssistantUI.exe) from Releases

Usage

• Run TournamentAssistantUI.exe
• Enter the server address/port in the “Host IP” box
• Enter your username in the “Username” box and click Connect
• Click on the desired players’ names so that they become highlighted and then press the blue “Create Match” button
• When in the Match Room, paste the desired song link or key into the “Song URL” box
• Click “Load Song” and wait for a the song to load (If you look closely, you’ll notice the button itself is the progress bar)
• Select your desired characteristic (standard, one saber, etc.), difficulty (easy-expert+), and modifiers (no fail, faster song, etc.)
• Click the “Play Song” button

With Stream Sync (Optional)

• Instead of clicking the “Play Song” button, click “Play Song (With Dual Sync)”
• You will see a green box highlighting one of your monitors. Be sure the streams you want to sync are visible insdie that monitor
• Note: If the matches are streamed to a central channel (as for most tournaments) you will have to use that channel for Sync. Do not sync by pulling up the players' individual streams

How to Host a Server

• Download the latest release build (TournamentAssistantCore-release-[platform].zip) from Releases and extract it to any location
• Run TournamentAssistantCore.exe (or the linux equivalent) once to generate serverConfig.json
• Modify serverConfig.json to set your desired port and ServerName
• Run TournamentAssistantCore.exe again!
• (You may also change other settings and add teams, an overlay, or a list of banned mods!)

TODO

Please help me improve this readme!

Contributing

Pull requests are welcome! Feel free to dm me on discord if you have any questions or concerns!

License

MIT

0.2.8

This readme is incomplete! Feel free to help me add to it!

TournamentAssistant

A program designed to make it easier to coordinate tournaments for the VR rhythm game Beat Saber

How To Coordinate a Match

• Download the latest release build (TournamentAssistantUI.exe) from Releases

Usage

• Run TournamentAssistantUI.exe
• Enter the server address/port in the “Host IP” box
• Enter your username in the “Username” box and click Connect
• Click on the desired players’ names so that they become highlighted and then press the blue “Create Match” button
• When in the Match Room, paste the desired song link or key into the “Song URL” box
• Click “Load Song” and wait for a the song to load (If you look closely, you’ll notice the button itself is the progress bar)
• Select your desired characteristic (standard, one saber, etc.), difficulty (easy-expert+), and modifiers (no fail, faster song, etc.)
• Click the “Play Song” button

With Stream Sync (Optional)

• Instead of clicking the “Play Song” button, click “Play Song (With Dual Sync)”
• You will see a green box highlighting one of your monitors. Be sure the streams you want to sync are visible insdie that monitor
• Note: If the matches are streamed to a central channel (as for most tournaments) you will have to use that channel for Sync. Do not sync by pulling up the players' individual streams

How to Host a Server

• Download the latest release build (TournamentAssistantCore-release-[platform].zip) from Releases and extract it to any location
• Run TournamentAssistantCore.exe (or the linux equivalent) once to generate serverConfig.json
• Modify serverConfig.json to set your desired port and ServerName
• Run TournamentAssistantCore.exe again!
• (You may also change other settings and add teams, an overlay, or a list of banned mods!)

TODO

Please help me improve this readme!

Contributing

Pull requests are welcome! Feel free to dm me on discord if you have any questions or concerns!

License

MIT

Version bump for Beat Saber 1.11

THIS README IS INCOMPLETE! FEEL FREE TO HELP ME ADD TO IT!

TournamentAssistant

A program designed to make it easier to coordinate tournaments for the VR rhythm game Beat Saber

How To Coordinate a Match

• Download the latest release build (TournamentAssistantUI.exe) from Releases

Usage

• Run TournamentAssistantUI.exe
• Enter the server address/port in the “Host IP” box
• Enter your username in the “Username” box and click Connect
• Click on the desired players’ names so that they become highlighted and then press the blue “Create Match” button
• When in the Match Room, paste the desired song link or key into the “Song URL” box
• Click “Load Song” and wait for a the song to load (If you look closely, you’ll notice the button itself is the progress bar)
• Select your desired characteristic (standard, one saber, etc.), difficulty (easy-expert+), and modifiers (no fail, faster song, etc.)
• Click the “Play Song” button

With Stream Sync (Optional)

• Instead of clicking the “Play Song” button, click “Play Song (With Dual Sync)”
• You will see a green box highlighting one of your monitors. Be sure the streams you want to sync are visible insdie that monitor
• Note: If the matches are streamed to a central channel (as for most tournaments) you will have to use that channel for Sync. Do not sync by pulling up the players' individual streams

How to Host a Server

• Download the latest release build (TournamentAssistantCore-release-[platform].zip) from Releases and extract it to any location
• Run TournamentAssistantCore.exe (or the linux equivalent) once to generate serverConfig.json
• Modify serverConfig.json to set your desired port and ServerName
• Run TournamentAssistantCore.exe again!
• (You may also change other settings and add teams, an overlay, or a list of banned mods!)

TODO

Please help me improve this readme!

Contributing

Pull requests are welcome! Feel free to dm me on discord if you have any questions or concerns!

License

MIT

0.2.5

TournamentAssistant

A program designed to make it easier to coordinate tournaments for the VR rhythm game Beat Saber

How To Coordinate a Match

• Download the latest release build (TournamentAssistantUI.exe) from Releases

Usage

• Run TournamentAssistantUI.exe
• Enter the server address/port in the “Host IP” box
• Enter your username in the “Username” box and click Connect
• Click on the desired players’ names so that they become highlighted and then press the blue “Create Match” button
• When in the Match Room, paste the desired song link or key into the “Song URL” box
• Click “Load Song” and wait for a the song to load (If you look closely, you’ll notice the button itself is the progress bar)
• Select your desired characteristic (standard, one saber, etc.), difficulty (easy-expert+), and modifiers (no fail, faster song, etc.)
• Click the “Play Song” button

With Stream Sync (Optional)

• Instead of clicking the “Play Song” button, click “Play Song (With Dual Sync)”
• You will see a green box highlighting one of your monitors. Be sure the streams you want to sync are visible insdie that monitor
• Note: If the matches are streamed to a central channel (as for most tournaments) you will have to use that channel for Sync. Do not sync by pulling up the players' individual streams

How to Host a Server

• Download the latest release build (TournamentAssistantCore-release-[platform].zip) from Releases and extract it to any location
• Run TournamentAssistantCore.exe (or the linux equivalent) once to generate serverConfig.json
• Modify serverConfig.json to set your desired port and ServerName
• Run TournamentAssistantCore.exe again!
• (You may also change other settings and add teams, an overlay, or a list of banned mods!)

TODO

Please help me improve this readme!

Contributing

Pull requests are welcome! Feel free to dm me on discord if you have any questions or concerns!

License

MIT

0.1.3

BattleSaber

A program designed to make it easier to coordinate tournaments for the VR rhythm game Beat Saber

For Players

Installation

Download the latest release build (BattleSaber.dll) from Releases and place it in your Plugins folder

Usage

Run the game :P

For Coordinators

Installation

Download the latest release build (BattleSaberUI-release.zip) from Releases and extract it to any location

Usage

- Run `BattleSaberUI.exe`
- Ask for the server address/port and enter it in the “Host IP” box
- Enter your username in the “Username” box and click Connect
- Click on the desired players’ names so that they become highlighted and then press the blue “Create Match” button
- When in the Match Room, paste the desired song link or key into the “Song URL” box
- Click “Load Song” and wait for a the song to load (If you look closely, you’ll notice the button itself is the progress bar)
- Select your desired characteristic (standard, one saber, etc.), difficulty (easy-expert+), and modifiers (no fail, faster song, etc.)
- Click the “Play Song” button

With Stream Sync (Optional)

- Instead of clicking the “Play Song” button, click “Play Song (with sync),” then follow the instructions displayed on the pop-up windows as follows:
- Left click inside of the stream (where beat saber is directly visible, so no overlay pictures) of the player whose name is displayed in the pop-up window, then click Accept. Continue following these steps until all players are accounted for and the pop-ups stop
- Note: If the matches are streamed to a central channel (as for most tournaments) you will have to click on the players’ screens within the central stream. For example, matches of the Random Song Tournament were being streamed on the BeatKhana channel, so you’d have to click the screens of the players within the BeatKhana stream and not the players’ individual streams
- Note: There will be a green screen visible on stream for a short period of time while the stream delay is calculated

For Hosts

Installation

Download the latest release build (BattleSaberCore-release-[platform].zip) from Releases and extract it to any location

Usage

Run BattleSaberCore.exe or ./BattleSaberCore, depending on your platform :)

TODO

If anyone wants to improve this readme, please do. Dm me, submit a pull request, anything you want. I am incapable of writing readmes for large projects.

Contributing

Pull requests are welcome! Feel free to dm me on discord if you have any questions or concerns!

License

MIT

0.1.1

BattleSaber

A program designed to coordinate tournaments and act as a rudimentary multiplayer (pending new features!) for Beat Saber

For Players

Installation

Download the latest release build (BattleSaber.dll) from Releases and place it in your Plugins folder

Usage

Run the game :P

For Coordinators

Installation

Download the latest release build (BattleSaberUI-release.zip) from Releases and extract it to any location

Usage

- Run `BattleSaberUI.exe`
- Ask for the server address/port and enter it in the “Host IP” box
- Enter your username in the “Username” box and click Connect
- Click on the desired players’ names so that they become highlighted and then press the blue “Create Match” button
- When in the Match Room, paste the desired song link or key into the “Song URL” box
- Click “Load Song” and wait for a the song to load (If you look closely, you’ll notice the button itself is the progress bar)
- Select your desired characteristic (standard, one saber, etc.), difficulty (easy-expert+), and modifiers (no fail, faster song, etc.)
- Click the “Play Song” button

With Stream Sync (Optional)

- Instead of clicking the “Play Song” button, click “Play Song (with sync),” then follow the instructions displayed on the pop-up windows as follows:
- Left click inside of the stream (where beat saber is directly visible, so no overlay pictures) of the player whose name is displayed in the pop-up window, then click Accept. Continue following these steps until all players are accounted for and the pop-ups stop
- Note: If the matches are streamed to a central channel (as for most tournaments) you will have to click on the players’ screens within the central stream. For example, matches of the Random Song Tournament were being streamed on the BeatKhana channel, so you’d have to click the screens of the players within the BeatKhana stream and not the players’ individual streams
- Note: There will be a green screen visible on stream for a short period of time while the stream delay is calculated

For Hosts

Installation

Download the latest release build (BattleSaberCore-release-[platform].zip) from Releases and extract it to any location

Usage

Run BattleSaberCore.exe or ./BattleSaberCore, depending on your platform :)