0.4.6

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

(You do not need to host your own server if you don't want to. Feel free to use the Default Server!)

Contents:

• How to install the plugin
• How to coordinate a match
  • Basic
  • With stream sync
• How to host a server
  • Windows
  • Linux
    • Bash script (TBA)
    • Terminal only
    • GUI

Expand to show installation instructions

How to install the plugin

• Download the latest version of the .dll from the repository or from your tournament coordinators (e.g. Beat The Hub discord).

• After downloading the .dll open your steam client, right-click BeatSaber, goto manage, and click Browse local files.
  
  
  

• After that, a window with the game files should open, when it does, open the location where you downloaded the .dll (Downloads folder by default) and drag n' drop it into the plugins folder.
  
  
  

• After doing that, you should be good to go. If you encounter any issues, feel free to ask for help on BSMG or ask your tournament coordinators.

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

Windows

• Download and extract the latest TournamentAssistantCore-windows.zip

• Run TournamentAssistantCore.exe
  

• After a window similar to the screenshot above appears, you can close it and there should be a new file named serverConfig.json in the server directory.
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets
  

• You can also add a server name and password.
  
  

• Once thats done, you can save the changes and run TournamentAssistantCore.exe again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

Linux

Bash script

TBA

Terminal only

I'll be using Arch Linux with neovim in this example. I won't provide screenshots here since I'll be assuming that you know what you're doing. If you don't, then I would recommend the GUI guide below.

• Make a new directory where you want to save the server files and cd to it:mkdir TournamentAssistantCore && cd TournamentAssistantCore

• Download the latest TournamentAssistantCore-linux using wget: wget https://github.com/MatrikMoon/TournamentAssistant/releases/download/0.4.1/TournamentAssistantCore-linux. This example command is for the version 0.4.1, if a new version has been released please replace the url with the new one

• Make TournamentAssistantCore-linux executable using chmod +x /path/to/TournamentAssistantCore-linux.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux. After ~5 seconds close it with ctrl + c.

• Open your terminal editor of choice and edit the configuration file: nvim serverConfig.json. You can use the screenshots from Linux GUI setup as a reference. Don't forget to remove the brackets.

  • Add your server address. It will need to be a domain name, direct IP addresses are not supported.
  • You can also add a server name and password.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux again.

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

GUI

I'll be using Arch Linux with KDE DE in this example

• Download the latest TournamentAssistantCore-linux. I'd recommend using your home directory, just so you don't have to deal with sudo.
• Make TournamentAssistantCore-linux executable using your file manager of choice or using chmod +x /path/to/TournamentAssistantCore-linux. (In the screenshot I am using nautilus)
  
  
• Open terminal and run ./TournamentAssistantCore-linux. If you saved the executable somewhere else you will have to either specify the path to it ./path/to/TournamentAssistantCore-linux or cd into the directory and then run ./TournamentAssistantCore-linux.

Do not doubleclick the executable, it will run headless and you won't be able to turn it off without killing the process in the terminal or rebooting.

in this example I have TournamentAssistantCore-linux in a subfolder in my home directory

• Now press ctrl + c to close TournamentAssistantCore-linux and use your text/code editor of choice to edit the serverConfig.json configuration file. (In the screenshots I am using VS Code)
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets.
  

• You can also add a server name and password.
  
  

• After you finish configuration, save the file, open terminal and run ./TournamentAssistantCore-linux again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to ver...

0.4.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

(You do not need to host your own server if you don't want to. Feel free to use the Default Server!)

Contents:

• How to install the plugin
• How to coordinate a match
  • Basic
  • With stream sync
• How to host a server
  • Windows
  • Linux
    • Bash script (TBA)
    • Terminal only
    • GUI

Expand to show installation instructions

How to install the plugin

• Download the latest version of the .dll from the repository or from your tournament coordinators (e.g. Beat The Hub discord).

• After downloading the .dll open your steam client, right-click BeatSaber, goto manage, and click Browse local files.
  
  
  

• After that, a window with the game files should open, when it does, open the location where you downloaded the .dll (Downloads folder by default) and drag n' drop it into the plugins folder.
  
  
  

• After doing that, you should be good to go. If you encounter any issues, feel free to ask for help on BSMG or ask your tournament coordinators.

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

Windows

• Download and extract the latest TournamentAssistantCore-windows.zip

• Run TournamentAssistantCore.exe
  

• After a window similar to the screenshot above appears, you can close it and there should be a new file named serverConfig.json in the server directory.
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets
  

• You can also add a server name and password.
  
  

• Once thats done, you can save the changes and run TournamentAssistantCore.exe again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

Linux

Bash script

TBA

Terminal only

I'll be using Arch Linux with neovim in this example. I won't provide screenshots here since I'll be assuming that you know what you're doing. If you don't, then I would recommend the GUI guide below.

• Make a new directory where you want to save the server files and cd to it:mkdir TournamentAssistantCore && cd TournamentAssistantCore

• Download the latest TournamentAssistantCore-linux using wget: wget https://github.com/MatrikMoon/TournamentAssistant/releases/download/0.4.1/TournamentAssistantCore-linux. This example command is for the version 0.4.1, if a new version has been released please replace the url with the new one

• Make TournamentAssistantCore-linux executable using chmod +x /path/to/TournamentAssistantCore-linux.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux. After ~5 seconds close it with ctrl + c.

• Open your terminal editor of choice and edit the configuration file: nvim serverConfig.json. You can use the screenshots from Linux GUI setup as a reference. Don't forget to remove the brackets.

  • Add your server address. It will need to be a domain name, direct IP addresses are not supported.
  • You can also add a server name and password.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux again.

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

GUI

I'll be using Arch Linux with KDE DE in this example

• Download the latest TournamentAssistantCore-linux. I'd recommend using your home directory, just so you don't have to deal with sudo.
• Make TournamentAssistantCore-linux executable using your file manager of choice or using chmod +x /path/to/TournamentAssistantCore-linux. (In the screenshot I am using nautilus)
  
  
• Open terminal and run ./TournamentAssistantCore-linux. If you saved the executable somewhere else you will have to either specify the path to it ./path/to/TournamentAssistantCore-linux or cd into the directory and then run ./TournamentAssistantCore-linux.

Do not doubleclick the executable, it will run headless and you won't be able to turn it off without killing the process in the terminal or rebooting.

in this example I have TournamentAssistantCore-linux in a subfolder in my home directory

• Now press ctrl + c to close TournamentAssistantCore-linux and use your text/code editor of choice to edit the serverConfig.json configuration file. (In the screenshots I am using VS Code)
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets.
  

• You can also add a server name and password.
  
  

• After you finish configuration, save the file, open terminal and run ./TournamentAssistantCore-linux again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to ver...

0.4.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

Contents:

• How to install the plugin
• How to coordinate a match
  • Basic
  • With stream sync
• How to host a server
  • Windows
  • Linux
    • Bash script (TBA)
    • Terminal only
    • GUI

Expand to show installation instructions

How to install the plugin

• Download the latest version of the .dll from the repository or from your tournament coordinators (e.g. Beat The Hub discord).

• After downloading the .dll open your steam client, right-click BeatSaber, goto manage, and click Browse local files.
  
  
  

• After that, a window with the game files should open, when it does, open the location where you downloaded the .dll (Downloads folder by default) and drag n' drop it into the plugins folder.
  
  
  

• After doing that, you should be good to go. If you encounter any issues, feel free to ask for help on BSMG or ask your tournament coordinators.

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

Windows

• Download and extract the latest TournamentAssistantCore-windows.zip

• Run TournamentAssistantCore.exe
  

• After a window similar to the screenshot above appears, you can close it and there should be a new file named serverConfig.json in the server directory.
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets
  

• You can also add a server name and password.
  
  

• Once thats done, you can save the changes and run TournamentAssistantCore.exe again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

Linux

Bash script

TBA

Terminal only

I'll be using Arch Linux with neovim in this example. I won't provide screenshots here since I'll be assuming that you know what you're doing. If you don't, then I would recommend the GUI guide below.

• Make a new directory where you want to save the server files and cd to it:mkdir TournamentAssistantCore && cd TournamentAssistantCore

• Download the latest TournamentAssistantCore-linux using wget: wget https://github.com/MatrikMoon/TournamentAssistant/releases/download/0.4.1/TournamentAssistantCore-linux. This example command is for the version 0.4.1, if a new version has been released please replace the url with the new one

• Make TournamentAssistantCore-linux executable using chmod +x /path/to/TournamentAssistantCore-linux.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux. After ~5 seconds close it with ctrl + c.

• Open your terminal editor of choice and edit the configuration file: nvim serverConfig.json. You can use the screenshots from Linux GUI setup as a reference. Don't forget to remove the brackets.

  • Add your server address. It will need to be a domain name, direct IP addresses are not supported.
  • You can also add a server name and password.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux again.

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

GUI

I'll be using Arch Linux with KDE DE in this example

• Download the latest TournamentAssistantCore-linux. I'd recommend using your home directory, just so you don't have to deal with sudo.
• Make TournamentAssistantCore-linux executable using your file manager of choice or using chmod +x /path/to/TournamentAssistantCore-linux. (In the screenshot I am using nautilus)
  
  
• Open terminal and run ./TournamentAssistantCore-linux. If you saved the executable somewhere else you will have to either specify the path to it ./path/to/TournamentAssistantCore-linux or cd into the directory and then run ./TournamentAssistantCore-linux.

Do not doubleclick the executable, it will run headless and you won't be able to turn it off without killing the process in the terminal or rebooting.

in this example I have TournamentAssistantCore-linux in a subfolder in my home directory

• Now press ctrl + c to close TournamentAssistantCore-linux and use your text/code editor of choice to edit the serverConfig.json configuration file. (In the screenshots I am using VS Code)
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets.
  

• You can also add a server name and password.
  
  

• After you finish configuration, save the file, open terminal and run ./TournamentAssistantCore-linux again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the d...

0.4.4-b

Update notes: This update is identical to the last, but rebuilt with proper libraries to work on 0.13.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

Contents:

• How to install the plugin
• How to coordinate a match
  • Basic
  • With stream sync
• How to host a server
  • Windows
  • Linux
    • Bash script (TBA)
    • Terminal only
    • GUI

Expand to show installation instructions

How to install the plugin

• Download the latest version of the .dll from the repository or from your tournament coordinators (e.g. Beat The Hub discord).

• After downloading the .dll open your steam client, right-click BeatSaber, goto manage, and click Browse local files.
  
  
  

• After that, a window with the game files should open, when it does, open the location where you downloaded the .dll (Downloads folder by default) and drag n' drop it into the plugins folder.
  
  
  

• After doing that, you should be good to go. If you encounter any issues, feel free to ask for help on BSMG or ask your tournament coordinators.

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

Windows

• Download and extract the latest TournamentAssistantCore-windows.zip

• Run TournamentAssistantCore.exe
  

• After a window similar to the screenshot above appears, you can close it and there should be a new file named serverConfig.json in the server directory.
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets
  

• You can also add a server name and password.
  
  

• Once thats done, you can save the changes and run TournamentAssistantCore.exe again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

Linux

Bash script

TBA

Terminal only

I'll be using Arch Linux with neovim in this example. I won't provide screenshots here since I'll be assuming that you know what you're doing. If you don't, then I would recommend the GUI guide below.

• Make a new directory where you want to save the server files and cd to it:mkdir TournamentAssistantCore && cd TournamentAssistantCore

• Download the latest TournamentAssistantCore-linux using wget: wget https://github.com/MatrikMoon/TournamentAssistant/releases/download/0.4.1/TournamentAssistantCore-linux. This example command is for the version 0.4.1, if a new version has been released please replace the url with the new one

• Make TournamentAssistantCore-linux executable using chmod +x /path/to/TournamentAssistantCore-linux.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux. After ~5 seconds close it with ctrl + c.

• Open your terminal editor of choice and edit the configuration file: nvim serverConfig.json. You can use the screenshots from Linux GUI setup as a reference. Don't forget to remove the brackets.

  • Add your server address. It will need to be a domain name, direct IP addresses are not supported.
  • You can also add a server name and password.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux again.

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

GUI

I'll be using Arch Linux with KDE DE in this example

• Download the latest TournamentAssistantCore-linux. I'd recommend using your home directory, just so you don't have to deal with sudo.
• Make TournamentAssistantCore-linux executable using your file manager of choice or using chmod +x /path/to/TournamentAssistantCore-linux. (In the screenshot I am using nautilus)
  
  
• Open terminal and run ./TournamentAssistantCore-linux. If you saved the executable somewhere else you will have to either specify the path to it ./path/to/TournamentAssistantCore-linux or cd into the directory and then run ./TournamentAssistantCore-linux.

Do not doubleclick the executable, it will run headless and you won't be able to turn it off without killing the process in the terminal or rebooting.

in this example I have TournamentAssistantCore-linux in a subfolder in my home directory

• Now press ctrl + c to close TournamentAssistantCore-linux and use your text/code editor of choice to edit the serverConfig.json configuration file. (In the screenshots I am using VS Code)
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets.
  

• You can also add a server name and password.
  
  

• After you finish configuration, save the file, open terminal and run ./TournamentAssistantCore-linux again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to ve...

0.4.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

Contents:

• How to install the plugin
• How to coordinate a match
  • Basic
  • With stream sync
• How to host a server
  • Windows
  • Linux
    • Bash script (TBA)
    • Terminal only
    • GUI

How to install the plugin

• Download the latest version of the .dll from the repository or from your tournament coordinators (e.g. Beat The Hub discord).

• After downloading the .dll open your steam client, right-click BeatSaber, goto manage, and click Browse local files.
  
  
  

• After that, a window with the game files should open, when it does, open the location where you downloaded the .dll (Downloads folder by default) and drag n' drop it into the plugins folder.
  
  
  

• After doing that, you should be good to go. If you encounter any issues, feel free to ask for help on BSMG or ask your tournament coordinators.

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

Windows

• Download and extract the latest TournamentAssistantCore-windows.zip

• Run TournamentAssistantCore.exe
  

• After a window similar to the screenshot above appears, you can close it and there should be a new file named serverConfig.json in the server directory.
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets
  

• You can also add a server name and password.
  
  

• Once thats done, you can save the changes and run TournamentAssistantCore.exe again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

Linux

Bash script

TBA

Terminal only

I'll be using Arch Linux with neovim in this example. I won't provide screenshots here since I'll be assuming that you know what you're doing. If you don't, then I would recommend the GUI guide below.

• Make a new directory where you want to save the server files and cd to it:mkdir TournamentAssistantCore && cd TournamentAssistantCore

• Download the latest TournamentAssistantCore-linux using wget: wget https://github.com/MatrikMoon/TournamentAssistant/releases/download/0.4.1/TournamentAssistantCore-linux. This example command is for the version 0.4.1, if a new version has been released please replace the url with the new one

• Make TournamentAssistantCore-linux executable using chmod +x /path/to/TournamentAssistantCore-linux.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux. After ~5 seconds close it with ctrl + c.

• Open your terminal editor of choice and edit the configuration file: nvim serverConfig.json. You can use the screenshots from Linux GUI setup as a reference. Don't forget to remove the brackets.

  • Add your server address. It will need to be a domain name, direct IP addresses are not supported.
  • You can also add a server name and password.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux again.

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

GUI

I'll be using Arch Linux with KDE DE in this example

• Download the latest TournamentAssistantCore-linux. I'd recommend using your home directory, just so you don't have to deal with sudo.
• Make TournamentAssistantCore-linux executable using your file manager of choice or using chmod +x /path/to/TournamentAssistantCore-linux. (In the screenshot I am using nautilus)
  
  
• Open terminal and run ./TournamentAssistantCore-linux. If you saved the executable somewhere else you will have to either specify the path to it ./path/to/TournamentAssistantCore-linux or cd into the directory and then run ./TournamentAssistantCore-linux.

Do not doubleclick the executable, it will run headless and you won't be able to turn it off without killing the process in the terminal or rebooting.

in this example I have TournamentAssistantCore-linux in a subfolder in my home directory

• Now press ctrl + c to close TournamentAssistantCore-linux and use your text/code editor of choice to edit the serverConfig.json configuration file. (In the screenshots I am using VS Code)
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets.
  

• You can also add a server name and password.
  
  

• After you finish configuration, save the file, open terminal and run ./TournamentAssistantCore-linux again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries ...

0.4.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

Contents:

• How to install the plugin
• How to coordinate a match
  • Basic
  • With stream sync
• How to host a server
  • Windows
  • Linux
    • Bash script (TBA)
    • Terminal only
    • GUI

How to install the plugin

• Download the latest version of the .dll from the repository or from your tournament coordinators (e.g. Beat The Hub discord).

• After downloading the .dll open your steam client, right-click BeatSaber, goto manage, and click Browse local files.
  
  
  

• After that, a window with the game files should open, when it does, open the location where you downloaded the .dll (Downloads folder by default) and drag n' drop it into the plugins folder.
  
  
  

• After doing that, you should be good to go. If you encounter any issues, feel free to ask for help on BSMG or ask your tournament coordinators.

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

Windows

• Download and extract the latest TournamentAssistantCore-windows.zip

• Run TournamentAssistantCore.exe
  

• After a window similar to the screenshot above appears, you can close it and there should be a new file named serverConfig.json in the server directory.
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets
  

• You can also add a server name and password.
  
  

• Once thats done, you can save the changes and run TournamentAssistantCore.exe again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

Linux

Bash script

TBA

Terminal only

I'll be using Arch Linux with neovim in this example. I won't provide screenshots here since I'll be assuming that you know what you're doing. If you don't, then I would recommend the GUI guide below.

• Make a new directory where you want to save the server files and cd to it:mkdir TournamentAssistantCore-linux-0.4.2 && cd TournamentAssistantCore-linux-0.4.2

• Download the latest TournamentAssistantCore-linux using wget: wget https://github.com/MatrikMoon/TournamentAssistant/releases/download/0.4.2/TournamentAssistantCore-linux. This example command is for the version 0.4.2, if a new version has been released please replace the url with the new one

• Make TournamentAssistantCore-linux executable using chmod +x /path/to/TournamentAssistantCore-linux.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux. After ~5 seconds close it with ctrl + c.

• Open your terminal editor of choice and edit the configuration file: nvim serverConfig.json. You can use the screenshots from Linux GUI setup as a reference. Don't forget to remove the brackets.

  • Add your server address. It will need to be a domain name, direct IP addresses are not supported.
  • You can also add a server name and password.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux again.

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

GUI

I'll be using Arch Linux with KDE DE in this example

• Download the latest TournamentAssistantCore-linux. I'd recommend using your home directory, just so you don't have to deal with sudo.
• Make TournamentAssistantCore-linux executable using your file manager of choice or using chmod +x /path/to/TournamentAssistantCore-linux. (In the screenshot I am using nautilus)
  
  
• Open terminal and run ./TournamentAssistantCore-linux. If you saved the executable somewhere else you will have to either specify the path to it ./path/to/TournamentAssistantCore-linux or cd into the directory and then run ./TournamentAssistantCore-linux.

Do not doubleclick the executable, it will run headless and you won't be able to turn it off without killing the process in the terminal or rebooting.

in this example I have TournamentAssistantCore-linux in a subfolder in my home directory

• Now press ctrl + c to close TournamentAssistantCore-linux and use your text/code editor of choice to edit the serverConfig.json configuration file. (In the screenshots I am using VS Code)
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets.
  

• You can also add a server name and password.
  
  

• After you finish configuration, save the file, open terminal and run ./TournamentAssistantCore-linux again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is p...

0.4.1

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

Contents:

• How to install the plugin
• How to coordinate a match
  • Basic
  • With stream sync
• How to host a server
  • Windows
  • Linux
    • Bash script (TBA)
    • Terminal only
    • GUI

How to install the plugin

• Download the latest version of the .dll from the repository or from your tournament coordinators (e.g. Beat The Hub discord).

• After downloading the .dll open your steam client, right-click BeatSaber, goto manage, and click Browse local files.
  
  
  

• After that, a window with the game files should open, when it does, open the location where you downloaded the .dll (Downloads folder by default) and drag n' drop it into the plugins folder.
  
  
  

• After doing that, you should be good to go. If you encounter any issues, feel free to ask for help on BSMG or ask your tournament coordinators.

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

Windows

• Download and extract the latest TournamentAssistantCore-windows.zip

• Run TournamentAssistantCore.exe
  

• After a window similar to the screenshot above appears, you can close it and there should be a new file named serverConfig.json in the server directory.
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets
  

• You can also add a server name and password.
  
  

• Once thats done, you can save the changes and run TournamentAssistantCore.exe again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

Linux

Bash script

TBA

Terminal only

I'll be using Arch Linux with neovim in this example. I won't provide screenshots here since I'll be assuming that you know what you're doing. If you don't, then I would recommend the GUI guide below.

• Make a new directory where you want to save the server files and cd to it:mkdir TournamentAssistantCore-linux-0.4.0 && cd TournamentAssistantCore-linux-0.4.0

• Download the latest TournamentAssistantCore-linux using wget: wget https://github.com/MatrikMoon/TournamentAssistant/releases/download/0.4.0/TournamentAssistantCore-linux. This example command is for the version 0.4.0, if a new version has been released please replace the url with the new one

• Make TournamentAssistantCore-linux executable using chmod +x /path/to/TournamentAssistantCore-linux.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux. After ~5 seconds close it with ctrl + c.

• Open your terminal editor of choice and edit the configuration file: nvim serverConfig.json. You can use the screenshots from Linux GUI setup as a reference. Don't forget to remove the brackets.

  • Add your server address. It will need to be a domain name, direct IP addresses are not supported.
  • You can also add a server name and password.

• Run TournamentAssistantCore-linux using ./TournamentAssistantCore-linux again.

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

GUI

I'll be using Arch Linux with KDE DE in this example

• Download the latest TournamentAssistantCore-linux. I'd recommend using your home directory, just so you don't have to deal with sudo.
• Make TournamentAssistantCore-linux executable using your file manager of choice or using chmod +x /path/to/TournamentAssistantCore-linux. (In the screenshot I am using nautilus)
  
  
• Open terminal and run ./TournamentAssistantCore-linux. If you saved the executable somewhere else you will have to either specify the path to it ./path/to/TournamentAssistantCore-linux or cd into the directory and then run ./TournamentAssistantCore-linux.

Do not doubleclick the executable, it will run headless and you won't be able to turn it off without killing the process in the terminal or rebooting.

in this example I have TournamentAssistantCore-linux in a subfolder in my home directory

• Now press ctrl + c to close TournamentAssistantCore-linux and use your text/code editor of choice to edit the serverConfig.json configuration file. (In the screenshots I am using VS Code)
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Don't forget to remove the brackets.
  

• You can also add a server name and password.
  
  

• After you finish configuration, save the file, open terminal and run ./TournamentAssistantCore-linux again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is p...

0.4.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

Windows

• Download and extract the latest TournamentAssistantCore-[platform]

• Run TournamentAssistantCore.exe
  

• After a window similar to the screenshot above appears, you can close it and there should be a new file named serverConfig.json in the server directory.
  

• In this file, add your server address. It will need to be a domain name, direct IP addresses are not supported. Dont forget to remove the brackets
  

• You can also add a server name and password.
  
  

• Once thats done, you can save the changes and run TournamentAssistantCore.exe again.
  

• If the address got verified and port got opened, congratulations, you have just created your own server.

• If the address got verified but port could not be opened, you will need to open the selected port in your router settings manually.

• If the address failed to verify and port got opened successfully and you made sure that there aren't any spelling mistakes or that the domain is pointed at the correct IP (keep in mind that DNS entries take up to an hour to be created/changed) seek help on discord.

Linux

todo (the process is similar to windows so use that instead for now)

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.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

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
        0.3.6: Changed to hub and spoke style network, bump TAUI version, fix accuracy for overlay
        0.3.7: Added password support and disabled score submission when nofail is on
        0.3.8: Fixed qualifier flow coordinator lock-in, partially fixed custom leaderboards

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.6

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
        0.3.6: Changed to hub and spoke style network, bump TAUI version, fix accuracy for overlay

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