AeonLucid/RocketLeaguePublic AeonLucid/RocketLeaguePublic

  • Stars
    star
    109
  • Rank 319,077 (Top 7 %)
  • Language
    JavaScript
  • Created about 6 years ago
  • Updated over 2 years ago
Twitter logo Share LinkedIn logo Share Facebook logo Share
AeonLucid/RocketLeaguePublic
github

AeonLucid

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

The workings of the Rocket League /Services endpoint.

1. RocketLeaguePublic

This repository contains all information necessary to consume the /Services API of the game Rocket League, which is also used by the game itself.

1.1. Terms of content

1.2. Endpoints

The game uses https://api.rlpp.psynet.gg/Services to grab configuration values and do authentication.
When authentication has been successful, it connects to a websocket at wss://rl-psy.net/ws?PsyConnectionType=Player.

It is possible to keep using the HTTP api instead of the websocket server. I have not looked at connecting to the websocket server yet, but I assume you send the same headers as you would for an authenticated request for the handshake and then send & receive json requests.

1.3. Intercepting requests

If you want to intercept HTTPS requests from the game itself, you have to make sure that the websocket connection fails. It will fallback to HTTPS after 10 failed attempts.

You can easily do this by using the provided script for fiddler.

Make sure you are using a tool that supports HTTPS such as Fiddler / Charles and have installed its SSL Root Certificate in your Trusted Root Certification Authorities. (Something similar should be done if you are on a mac)

1.4. Headers

Key Value Authenticated only
User-Agent RL Win/220128.58061.363257 gzip No
PsyBuildID -960700785 No
PsyEnvironment Prod No
PsyRequestID See Requests No
PsySig See Signing No
PsyToken See Authentication Yes
PsySessionID See Authentication Yes

Take note that fields like PsyBuildID, FeatureSet and GameVersion may all be changed on a new patch.
I will try to keep this repository updated.

You can find the most up-to-date values for these variables by reading the launch.log file generated by Rocket League. On windows with Steam, this file can be found in Documents\My Games\Rocket League\TAGame\Logs.

1.5. Signing

Rocket League uses two HMAC-SHA256 signatures, one for the request and one for the response. Both can be found in the PsySig header. The response has an extra header called PsyTime which is an unix timestamp.

The input format is just Unix timestamp, if any, else empty + - + request body.

1.5.1. Requests

Secret: c338bd36fb8c42b1a431d30add939fc7
Input: -(Request body)

1.5.2. Responses

Secret: 3b932153785842ac927744b292e40e52
Input: (Value of PsyTime)-(Response body)

The secret for rl-cdn.psyonix.com is cqhyz50f3c3j2pxhwo6b1kypxikah0wh and input (Response body).

1.6. Authentication

As of now, I do only know how to implement it for Steam. An example of this can be found in the demo/demo.js file.
The other platforms should use the same format, just with a different AuthTicket.

1.7. Requests

All requests have to be send as POST with the header Content-Type: application/x-www-form-urlencoded.

If you want to mimic the game as closely as possible, you need to keep track of two counters.

var requestIdCounter = 0; // Starts at 0, increments for every request and response.
var serviceIdCounter = 1; // Starts at 1, increments for every service.

The result of requestIdCounter++ should be used for the PsyRequestID request header, so it becomes something like "PsyNetMessage_X_" + requestIdCounter++.
The result of serviceIdCounter++ should be used for the ID field below.

A request body looks like this.

[
    {
        "Service": "Settings/GetStaticDataURL",
        "Version": 1,
        "ID": 1,
        "Params": {
            "Platform": "Steam",
            "Language": "INT"
        }
    },
    {
        "Service": "Products/GetPlayerProducts",
        "Version": 1,
        "ID": 2,
        "Params": {
            "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0"
        }
    }
]

About all fields like PlayerID, its format means <Platform>|<UniqueId>|<SplitscreenId>.

1.7.1. Ads/GetAds

Auth: Yes Version: 1 Params:

{
    "Language": "INT"
}

Result:

{
  "Ads": [
    {
      "ZoneID": 201,
      "Url": "https://rl-cdn.psyonix.com/Ads/Prod/124.7CjfwUcy/201.jpg",
      "UTCEndTime": 0000000000
    },
    {
      "ZoneID": 202,
      "Url": "https://rl-cdn.psyonix.com/Ads/Prod/124.7CjfwUcy/202.jpg",
      "UTCEndTime": 0000000000
    },
    {
      "ZoneID": 403,
      "Url": "https://rl-cdn.psyonix.com/Ads/Prod/124.7CjfwUcy/403.jpg",
      "UTCEndTime": 0000000000
    },
    {
      "ZoneID": 404,
      "Url": "https://rl-cdn.psyonix.com/Ads/Prod/124.7CjfwUcy/404.jpg",
      "UTCEndTime": 0000000000
    }
  ]
}

The ZoneIDs may look like status codes, but are actually the id used to match the corresponding advert location, like the billboards.

1.7.2. Auth/AuthPlayer Steam

Auth: No
Version: 1
Params:

{
    "Platform": "Steam",
    "PlayerName": "Your Steam display name",
    "PlayerID": "Your SteamID64",
    "GameVersion": 26,
    "Language": "INT",
    "AuthTicket": "Steam EncryptedAppTicket, see demo/demo.js for an example",
    "BuildRegion": "",
    "FeatureSet": "PrimeUpdate36_2",
    "bTrial": false,
    "bSkipAuth": false
}

Result:

{
    "SessionID": "sessionid", 
    "VerifiedPlayerName": "name", 
    "UseWebSocket": true, 
    "PerConURL": "url", 
    "PsyTag": {
        "Name": "name", 
        "Code": 0000
    }, 
    "CountryRestrictions": ["KeyCrate"]
}

1.7.2. Auth/AuthPlayer Epic

Auth: No
Version: 2
Params:

{
    "Platform": "Epic",
    "PlayerName": "Your Epic display name",
    "PlayerID": "Your Epic ID",
    "Language": "INT",
    "AuthTicket": "Epic EncryptedAppTicket, see demo/demo.js for an example",
    "BuildRegion": "",
    "FeatureSet": "PrimeUpdate36_2",
    "bTrial": false,
    "bSkipAuth": false,
    "bSetAsPrimaryAccount": false,
    "EpicAuthTicket": "Same as AuthTicket",
    "EpicAccountID": "Same as PlayerID"
}

Result:

{
    "SessionID": "sessionid",
    "VerifiedPlayerName": "name",
    "UseWebSocket": true,
    "PerConURL": "url",
    "PerConURLv2": "url version 2",
    "PsyToken": "Token",
    "PsyTag": {
      "Name": "name",
      "Code": 0000
    },
    "IsLastChanceAuthBan": false,
    "CountryRestrictions": []
}

1.7.3. Clubs/GetClubInvites

Auth: Yes
Version: 1
Params:

{}

Result:

{
    "ClubInvites": []
}

1.7.4. Clubs/GetPlayerClubDetails

Auth: Yes
Version: 2 Params:

{
    "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0"
}

Result:

{
    "ClubDetails": {
        "ClubID": 0000,
        "ClubName": "name",
        "ClubTag": "name",
        "MOTD": "desc",
        "PrimaryColor": -10092527,
        "AccentColor": -32816,
        "OwnerPlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0",
        "Members": [
            {
                "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0",
                "PlayerName": "name",
                "RoleName": "Owner",
                "CreatedTime": "1535573427",
                "DeletedTime": 0
            },
            {
                "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0",
                "PlayerName": "name",
                "RoleName": "Member",
                "CreatedTime": "1535575218",
                "DeletedTime": 0
            }
        ],
        "Flags": [],
        "bVerified": false,
        "CreatedTime": 1535573413,
        "LastUpdatedTime": 1562620061,
        "NameLastUpdatedTime": 0,
        "DeletedTime": 0
    }
}

1.7.5. Codes/RedeemCode

Attempts to redeem a code.

Auth: Yes
Version: 2
Params:

{
  "Code": "CODE",
  "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0"
}

Result if successful:

{
  "Result": {
    "Drops": [
      {
        "ProductID": "2879",
        "InstanceID": "00000000000000000000000579ed4c93",
        "Attributes": [],
        "SeriesID": 30,
        "AddedTimestamp": 1645825416,
        "UpdatedTimestamp": 1645825416
      }
    ]
  }
}

Result if code has already been claimed:

{
  "Error": {
    "Type": "CodeHasBeenRedeemed",
    "Message": ""
  }
}

Result if not valid:

{
  "Error": {
    "Type": "CodeIsNotValid",
    "Message": ""
  }
}

1.7.6. DLC/GetDLC

Gets all available DLC.

Auth: Yes
Version: 1
Params:

{}

Result:

{
    "DLC": []
}

1.7.7. Filters/FilterContent

This is the best call of them all.
Try it out for yourself.

Auth: Yes
Version: 1
Params:

{
    "Content": [
        "Some name",
        "Another name",
        "More names.."
    ]
}

Result:

{
    "FilteredContent": [
        "Some name",
        "Another name",
        "More names.."
    ]
}

1.7.8. GameServer/FindPrivateServer

This call happens when you try to join a private match with name and password.

Auth: Yes
Version: 1
Params:

{
    "ServerName": "SomeName..",
    "Password": "SomePassword.."
}

Result:

{
    "Servers": []
}

1.7.9. GameServer/GetGameServerPingList

Gets all server IPs, ports and their ping.

Auth: Yes
Version: 1
Params:

{}

Result:

{
    "Servers": [
        {
            "Region": "ASC",
            "Host": "ip43-239-136-105.datahound.com",
            "Port": "7830"
        },
        {
            "Region": "ASM",
            "Host": "ip103-23-210-172.datahound.com",
            "Port": "7838"
        }
    ]
}

1.7.10. GenericStorage/GetPlayerGenericStorage

You have to play with this call yourself a bit, because I don't know if it is useful.
The response looks pretty boring to me.

All possible categories: MusicPlayerSave_TA, SoundSettingsSave_TA, UISavedValues_TA, MapPrefsSave_TA, RankedReconnectSave_TA, NetworkSave_TA, TutorialSave_TA, BlogTileCache_TA, ProductsSave_TA, PlaylistSkillDataSave_TA, MatchmakingSettingsSave_TA, ClientXPSave_TA, TournamentSettingsSave_TA, SeasonSave_TA, GameplaySettingsSave_TA, ProductsFavoriteSave_TA, ExhibitionMatchSettingsSave_TA, PrivateMatchSettingsSave_TA, ServerBrowserSettingsSave_TA, ProductsOfflineSave_TA, EulaSave_TA, AchievementSave_TA, ProfileGameplaySave_TA, PlayerBannerSave_TA, PlayerAvatarBorderSave_TA, ProfileStatsSave_TA, ProfileControlsSave_TA, ProfileAimAssistSave_TA, ProfileCameraSave_TA, ProfileQuickChatSave_TA, ProfileLoadoutSave_TA, ProfileGamepadSave_TA, ProfilePCSave_TA

Auth: Yes
Version: 1
Params:

{
    "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0",
    "Items": [
        {
            "Category": "..",
            "Tick": 0,
            "Checksum": 0
        }
    ]
}

Result:

{
    "Items": [
        {
            "Category": "..",
            "Data": "..",
            "Tick": 1,
            "Checksum": "43523452345",
            "bChecksumMatch": false
        }
    ]
}

1.7.11. GenericStorage/SetPlayerGenericStorage

I would be really careful with this one if I were you.

Auth: Yes
Version: 2
Params:

{
    "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0",
    "Items": [
        {
            "Category": "..",
            "Tick": 0,
            "Checksum": 0,
            "Data": ".."
        }
    ]
}

1.7.12. Matchmaking/PlayerCancelPrivateMatch

Auth: Yes
Version: 1
Params:

{}

Result:

{}

1.7.13. Matchmaking/PlayerSearchPrivateMatch

This call happens when creating a private match.

Auth: Yes
Version: 2
Params:

{
    "Region": "EU"
}

Result:

{}

1.7.14. Metrics/RecordMetrics

Why would you use this? :')

1.7.15. Microtransaction/ClaimEntitlements

Auth: Yes
Version: 2
Params:

{
    "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0",
    "AuthCode": ""
}

Result:

{
    "Products": []
}

1.7.16. Players/GetChatBanStatus

Pretty self explanatory.

Auth: Yes
Version: 1
Params:

{}

Result:

{
    "BannedUntil": 0,
    "BannedMessage": null,
    "BannedCitations": null,
    "bPermanentlyBanned": false,
    "bContributedToBan": false
}

1.7.17. Players/GetXP

Gets the amount of XP of the given player.

Auth: Yes
Version: 1
Params:

{
    "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0"
}

Result:

{
    "XPInfoResponse": {
        "TotalXP": 536436546456356,
        "XPLevel": 642,
        "XPTitle": "",
        "XPProgressInCurrentLevel": 1501,
        "XPRequiredForNextLevel": 20000
    }
}

1.7.18. Population/UpdatePlayerPlaylist

Submits the amount of players in your party and the playlist you are playing.

Auth: Yes
Version: 1
Params:

{
    "Playlist": 0,
    "NumLocalPlayers": 1
}

Result:

{}

1.7.19. Products/GetContainerDropTable

Gets the possible outcome for all crates.

Auth: Yes
Version: 2
Params:

{
    "GameVersion": 25
}

1.7.20. Products/GetLoadoutProducts

Gets the information of specific product instance ids.

Auth: Yes
Version: 2
Params:

{
    "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0",
    "Loadout": [
        "ProductInstanceID",
        "AnotherProductInstanceID",
        "AnotherProductInstanceID.."
    ]
}

Result:

{
    "ProductData": []
}

1.7.21. Products/GetPlayerProducts

Gets the inventory of the given player. (Only yourself is allowed)

Auth: Yes
Version: 2
Params:

{
    "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0"
}

Result:

{
    "ProductData": [
        {
            "ProductID": 2363,
            "InstanceID": "6456765456",
            "Attributes": [],
            "SeriesID": 19,
            "AddedTimestamp": 1514740692,
            "UpdatedTimestamp": 1514740692,
            "TradeHold": -2
        }
    ]
}

1.7.22. RocketPass/GetPlayerInfo

Gets the current tier, premium status and xp multiplier.

Auth: Yes
Version: 2
Params:

{
    "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0",
    "RocketPassID": 1
}

1.7.23. RocketPass/GetPlayerPrestigeRewards

Auth: Yes
Version: 1
Params:

{
    "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0",
    "RocketPassID": 1
}

Result:

{
    "PrestigeRewards": [
        {
            "Tier": 71,
            "ProductData": [
                {
                    "ProductID": 3316,
                    "InstanceID": null,
                    "Attributes": [],
                    "SeriesID": 44,
                    "AddedTimestamp": null,
                    "UpdatedTimestamp": null
                }
            ],
            "RewardDrops": [],
            "CurrencyDrops": [],
            "ContainerDrops": []
        }
    ]
}

1.7.24. RocketPass/GetRewardContent

Gets all possible rewards of the battle rocket pass.

Auth: Yes
Version: 1
Params:

{
    "RocketPassID": 1,
    "TierCap": 0
}

Result:

{
    "TierCap": 70,
    "FreeRewards": [
        {
            "Tier": 1,
            "ProductData": [],
            "XPRewards": [],
            "CurrencyDrops": []
        }
    ],
    "PremiumRewards": [
        {
            "Tier": 1,
            "ProductData": [
                {
                    "ProductID": "3155",
                    "InstanceID": null,
                    "Attributes": [],
                    "SeriesID": 39,
                    "AddedTimestamp": null,
                    "UpdatedTimestamp": null
                }
            ],
            "XPRewards": [],
            "CurrencyDrops": []
        }
    ]
}

1.7.25. Settings/GetStaticDataURL

The response of this call is actually quite useful.

Auth: No
Version: 1
Params:

{
    "Platform": "Steam",
    "Language": "INT"
}

Result:

{
    "URL": "http://psyonix-rl.appspot.com/Static.json?BuildID=-1878310188&Platform=Steam&Language=INT&Environment=Prod"
}

1.7.26. Skills/GetPlayerSkill

Gets the ranking information for each ranked playlist of a specific player.

Auth: Yes
Version: 1
Params:

{
    "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0"
}

Result:

{
    "Skills": [
        {
            "Playlist": 0,
            "Mu": 42.3449,
            "Sigma": 2.8337,
            "Tier": 0,
            "Division": 0,
            "MMR": 42.3449,
            "WinStreak": 1,
            "MatchesPlayed": 0
        },
        {
            "Playlist": 10,
            "Mu": 25.6839,
            "Sigma": 8.13958,
            "Tier": 0,
            "Division": 0,
            "MMR": 25.6839,
            "WinStreak": 1,
            "MatchesPlayed": 0
        },
        {
            "Playlist": 11,
            "Mu": 45.2342,
            "Sigma": 3.5,
            "Tier": 0,
            "Division": 0,
            "MMR": 45.2342,
            "WinStreak": -1,
            "MatchesPlayed": 0
        },
        {
            "Playlist": 13,
            "Mu": 45.5141,
            "Sigma": 3.23682,
            "Tier": 0,
            "Division": 0,
            "MMR": 45.5141,
            "WinStreak": 2,
            "MatchesPlayed": 7
        },
        {
            "Playlist": 27,
            "Mu": 38.5532,
            "Sigma": 3.59969,
            "Tier": 0,
            "Division": 0,
            "MMR": 38.5532,
            "WinStreak": -5,
            "MatchesPlayed": 0
        },
        {
            "Playlist": 28,
            "Mu": 22.6323,
            "Sigma": 6.88745,
            "Tier": 0,
            "Division": 0,
            "MMR": 22.6323,
            "WinStreak": 1,
            "MatchesPlayed": 0
        },
        {
            "Playlist": 30,
            "Mu": 44.6283,
            "Sigma": 4.79466,
            "Tier": 0,
            "Division": 0,
            "MMR": 44.6283,
            "WinStreak": -5,
            "MatchesPlayed": 0
        }
    ],
    "RewardLevels": {
        "SeasonLevel": 0,
        "SeasonLevelWins": 5
    }
}

1.7.27. Skills/GetSkillLeaderboard

Gets the top 100 players for the given playlist.

Auth: Yes
Version: 1
Params:

{
    "Playlist": 10,
    "bDisableCrossPlay": true
}

1.7.28. Skills/GetSkillLeaderboardValueForUser

Gets the ranking info of a specific player in the given playlist.

Auth: Yes
Version: 1
Params:

{
    "Playlist": 10,
    "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0"
}

Result:

{
    "LeaderboardID": "Skill10",
    "bHasSkill": true,
    "MMR": 25.6839,
    "Value": 0
}

1.7.29 Stats/GetStatLeaderboard

Gets the top 100 players for the given stat.

Auth: Yes
Version: 1
Params:

{
    "Stat": "Wins",
    "bDisableCrossPlay": true
}

1.7.30. Stats/GetStatLeaderboardValueForUser

Gets the ranking info of a specific player in the given stat leaderboard.

Auth: Yes
Version: 1
Params:

{
    "Playlist": 10,
    "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0"
}

1.7.31. Tournaments/Status/GetTournamentSubscriptions

Auth: Yes
Version: 1
Params:

{
    "PlayerID": "Steam|XXXXXXXXXXXXXXXXXX|0"
}

Result:

{
    "CreatorOf": [],
    "Registered": [],
    "Tournaments": []
}

1.8. Possible Frequently Asked Questions

Hello, can I make a trade bot with this???

No, you need more information. But it is definitely possible :')

Can you help me make one??????

No.

1.9. Issues / Contributions

Feel free to open up an issue for discussion about the API.
You may also submit a PR to improve the README or the demo.

I would like to keep this repository mostly used for documentation purposes.

1.10. Implementations

None yet.

More Repositories

1

AndroidNativeEmu

Allows you to partly emulate an Android native library.
Python
1,266
star
2

POGOProtos

A central repository for all proto files of PokémonGO.
Python
726
star
3

MagiskFrida

Runs frida-server on boot as root with magisk.
Shell
203
star
4

frida-syscall-interceptor

TypeScript
137
star
5

frida-il2cpp

An helper library for those that want to play around with Unity il2cpp games.
TypeScript
98
star
6

POGOLib

A community-driven PokémonGo API Library written in C#.
C#
88
star
7

SnapHide

An iOS tweak to hide jailbreak and hooks from Snapchat.
Logos
65
star
8

Prospect

The Cycle: Frontier server emulation / Unreal Engine 4 server emulation
C#
32
star
9

Artour

Android ART hooking native library supporting Android 5.0 to 10.0
C++
18
star
10

FortniteApi

An C# client library for the TrackerNetwork Fortnite API.
C#
15
star
11

UnicornNet

Alternative Unicorn bindings because the original did not work and I don't know F#.
C#
14
star
12

MusicallyRE

Educational reverse engineering project for https://www.musical.ly/.
C#
12
star
13

OnePlusOTA

Download OnePlus OTA updates
Python
11
star
14

ClownHook

Experimental iOS Arm64 hooking
Objective-C
10
star
15

Kitsu.Bundle

Plex metadata agent that use the API of https://kitsu.io/ for metadata.
Python
8
star
16

WolfteamRE

An educational Wolfteam reverse engineering project.
C#
8
star
17

IpaModifier

Python
6
star
18

CHIP-8_Emulator

Trying to get into the world of emulation.
C#
6
star
19

Parroter

A control panel for your Parrot Zik 3.
C#
6
star
20

XamarinXposed

Why
C#
5
star
21

SteamworksSharp

Yet another C# steamworks library.
C#
5
star
22

DiscordSync

Small mod for Minecraft Forge 1.18.2 that sends messages of in-game events to a channel in your Discord server. This mod also enables cross-chatting between Minecraft and Discord.
Java
4
star
23

CapstoneNet

Bindings for https://github.com/aquynh/capstone
C#
4
star
24

DowngradePls

TypeScript
4
star
25

RootBad

Android hooking using all the cool stuff
C
3
star
26

BrainFuck-Interpreter-CSharp

C# BrainFuck interpreter because I was bored.
Brainfuck
3
star
27

KitsuScrobble.bundle

Plex Plug-in to scrobble anime to Kitsu.
Python
3
star
28

GunfireRebornMods

Collection of QoL Gunfire Reborn mods
C#
3
star
29

PlexBird

Marks anime watched on https://hummingbird.me/ based on PMS (Plex Media Server).
C#
3
star
30

AnimeSea

HTML
3
star
31

SWLauncher

SoulWorker launcher that removes the need for a Japanese VPN when launching the game.
C#
3
star
32

CallOfDutyApi

An C# client library for the TrackerNetwork Call Of Duty API.
C#
3
star
33

ProxyBroker

Scrapes and tests free proxies, then offers a rotating proxy
C#
3
star
34

DiscordDataAnalyzer

Small C# console application that parses the Discord data package
C#
3
star
35

AniSync

Syncs watched Anime from Tautulli to Kitsu or Anilist.
C#
3
star
36

Socks5Wrap.NET

A C# library to consume SOCKS5 proxies.
C#
2
star
37

POGOProtos.NetStandard1

Precompiled protobuf files for communication with PokémonGo.
PowerShell
2
star
38

RoR2-Mods

C#
1
star
39

HvA-API-Java

An Java API to authenticate with and request data from the Hogeschool van Amsterdam.
Java
1
star
40

pterodactyl-docker

Dockerfile
1
star
41

Pingu

This is a private server for the flash game "BomberPengu" developed by qforge.
C#
1
star
42

Sparky

A media player like Plex / Emby / Netflix, for fun.
TypeScript
1
star