About BlueSphere

Project BlueSphere is a replacement PSN-style backend for PS4 and PS5 game integrations. It provides the account services, presence relay, and web API endpoints that games can call when they need player identity, authentication, online status, friends, notifications, and game session data.

What it does

BlueSphere gives games a muliplayer account features for PS4 and PS5 Jailbroken consoles. A game plugin can log in with a BlueSphere account token, receive short-lived auth credentials, publish live presence over UDP, and call web APIs for friends list, sessions, etc.

At a high level, BlueSphere provides:

• Account identity through accountId, onlineId
• Login token exchange through POST /api/loginAuth.
• Auth code verification through POST /api/verify.
• UDP presence heartbeats for online/offline state and current game reporting.
• Friend-facing notifications when a player comes online, goes offline, or changes game state.
• Web API endpoints that game plugins using NP Web API can interact with to provide friends functionality, and matchmaking functionality.

How games use it

A game integration typically starts by calling the login endpoint with a BlueSphere login token. The backend returns an authCode for authenticated HTTP calls and a udpToken for the presence relay.

After login, the game keeps the player online by sending UDP heartbeat packets to the relay. Those heartbeats update the user's current game state and queue notifications for online friends. When the relay tells the client that notifications are available, the client pulls them from the HTTP notification endpoint with the user's auth code.

An example plugin will be provided at a later date.