This is a python package that allows you to make api calls for Rec Room and get your login token via your cookie. This is built ontop of Jegarde's RecNet-Login package.

Features

• Make authorized and non-authorized api calls
• Uses FlareSolverr and FlareSolver MITM Proxy to bypass Rec Room's Bot/DDoS protection
• Automatically renewing token
• Supports 2FA accounts
• Decoding the bearer token
• Detailed exceptions

Installation

Download the recnetlogin folder and place it in your project.

pip installation once this is stable.

Setup

Gathering your session token

1. Login to RecNet. While logging in, make sure you toggle on "Remember me / my machine".
2. Open your browser's DevTools (Inspect Element)
3. Open the Storage or Application tab on the top
4. Locate Cookies > https://rec.net on the directory
5. Search for __Secure-next-auth.session-token by filtering the cookies
6. Double click the value and copy it

Option 1/2: Storing it in your environment variables (Windows)

1. Search for environment variables and open the first result

2. Click Environment Variables...

3. Click New under System Variables

4. Name the variable RN_COOKIE and paste the copied value

5. Press OK on all the opened tabs

6. Restart your computer for it to take effect

Option 2/2: Storing it in a .env.secret file

1. Make a new file named .env.secret in your project's directory
2. Type RN_SESSION_TOKEN= in the file and paste the copied value

3. If the file is not in your project's directory, make sure to specify it

rnl = RecNetLogin(env_path=".env.secret")  # Env path defaults to local directory

New Auth Workaround

A month ago (as of 03/13/25) Rec Room added DDoS protection to their auth endpoints causing issues for this library. To get around it we can use FlareSolverr which is a proxy that gets around cloudflare DDoS protection.

FlareSolverr Setup

Option 1/2 Host one with Docker

If you already know about docker then please skip to the for Docker X section If you don't already have docker, install it by using the following: for windows: https://docs.docker.com/desktop/setup/install/windows-install/ for mac: https://docs.docker.com/desktop/setup/install/mac-install/ for linux: https://docs.docker.com/engine/install/ubuntu/

For Docker Engine (Linux)

1. Copy/download the file flaresolverr.docker-compose.yml from the repo
2. Move into the directory that contains the docker-compose file and run: docker compose -f <Insert filename> up -d

For Docker Desktop (Windows/Mac)

Use this stack overflow answer ... never touched Docker Desktop https://stackoverflow.com/a/66071384

Option 2/2 Using Someone Elses

For the time being I'll host a public Flaresolverr instance with a pretty hard rate limit on one of my vps's. It should be enough to do a couple logins per minute but this should only be used for testing with an alt account.

PLEASE DON'T TRUST RANDOM PUBLIC PROXIES WITH YOUR AUTH TOKENS

Now that being said ... the instance will be hosted at https://flaresolverr.apps.zigzatuzoo.xyz so your .env file will look like this FLARESOLVERR_INSTANCE="https://flaresolverr.apps.zigzatuzoo.xyz/v1"

Inserting Your Instance

3. Same way as setting up your RN_SESSION_TOKEN If you are using a .env file then write in it FLARESOLVERR_INSTANCE="http://<InsertInstanceDomain&Port>/v1" So if you are running the FlareSolverr instance on the same system then it will look like this FLARESOLVERR_INSTANCE="http://localhost:8191/v1"

4. You will also need to set the proxy url which 99% of the time will be localhost:8192 This will be the case for the default docker-compose.yml as well as my public instance So you should have or add FLARESOLVERR_MITMP_INSTANCE="localhost:8192" Also since this is just a TCP proxy it need to NOT have http or https

Usage

ADD LATER

Contributing

If you want to add more API endpoints

• Please just go to ./src/recnetclient/APIs and follow the premade examples
• If there is an endpoint you want to add that doesn't fit under the current files please make a new one with the class matching the name of the file and import it under the __init__.py file in the APIs folder

If you want to contribute to the other parts of this project

• Then please do ... any fixes are welcomed.
• I wouldn't say I'm a very organized coder so if you think there is a better way or want to spend the time cleaning up the codebase go right ahead
• When your done please make a PR and I'll review it when I can