Usage

This guide will assume you have filled out config.json and already have Roblox set up on your device.

Basic Method

Run this command in a terminal in the repository's directory: node index.js

After you run the program, copy the URI given and either:

• Paste the contents into your browser.
• Add as an argument to the Roblox executable. RobloxPlayerBeta.exe [URI]

[!WARNING] Do not share your URI or uri.txt file if the cookie field is filled out. It has the same risks as sharing your Roblox cookie, and can lead someone to access your account.

Auto Launching

[!IMPORTANT] Make sure writeToFile is enabled for this to work.

In the repository's directory, create a new file.

Give the file a certain file extension depending on your platform:

• Windows: The file should end with .bat with file extensions shown. (example: launch.bat)
• Linux: The file should end with .sh. (example: launch.sh)

Determine your current Roblox Player location:

• The location varies differently depending on your platform. These can be:

  • C:\Program Files (x86)\Roblox\Versions\*\RobloxPlayerBeta.exe
  • C:\Users\youruser\AppData\Local\Roblox\Versions\*\RobloxPlayerBeta.exe
  • C:\Users\youruser\AppData\Local\Bloxstrap\Bloxstrap.exe -player
  • Sober (Linux): flatpak run org.vinegarhq.Sober
  • Vinegar (Linux): flatpak run org.vinegarhq.Vinegar player run or vinegar player run

In the contents of that file, add the following to the file and make modifications if needed:

Windows

@ECHO OFF

"C:\Program Files\nodejs\node" index.js
< "uri.txt" set /p "uri="
"C:\Program Files (x86)\Roblox\Versions\*\RobloxPlayerBeta.exe" %uri%

Linux

Make sure the bash script is executable.

#!/bin/bash

node index.js
flatpak run org.vinegarhq.Sober $(cat uri.txt)

Afterwards, run the following script file in your terminal and wait for it to launch.

Adding as a Non-Steam Game

[!IMPORTANT] Make sure writeToFile is enabled for this to work.

Add any program as a Non-Steam Game, then edit the game's Properties. Follow the instructions for your platform.

Windows

Follow the Auto Launching section.

In the Target field, set it as the .bat file you made.

In the Start In field, set it as the repository's directory.

Once filled out, click the Play button and wait to see if it launches successfully.

Linux

Steam Deck/No Scripts

In the Target field, set it to either /usr/bin/flatpak or /usr/bin/vinegar (depends on your $PATH variable)

In the Start In field, set it as the repository's directory.

For the Launch Options field, fill it out like this: /usr/bin/node index.js && %command% run org.vinegarhq.Sober $(cat uri.txt)

Once filled out, click the Play button and wait to see if it launches successfully.

With Scripts

If you want to use a script, follow the Auto Launching section.

• Set the Target as the .sh file.
• Set the Start In field as the repository's directory.

Alternatively, create a init.sh and/or reset.sh.

• The launch options may look something like this: /usr/bin/bash init.sh && %command% && /usr/bin/bash reset.sh