R
R
Ready SDK Documentation
v0.2.3
Search
⌃K

User Authentication

Benefits and Use Cases

Feature Overview

Ready's User Authentication Module allows a player to create a new Ready account or log in to their existing one with email and password. Players with an account have their progress saved non-locally, which triggers several benefits both for you and your players. This feature also serves as the foundation for enabling Web3 functionality to leverage in your game.

Key Benefits

  1. 1.
    Restore Game Progress: Players who uninstall the game can pick back up where they left off by logging in with their account. No lost progress! This functionality is doubly important if the player has made non-consumable purchases in your game.
  2. 2.
    Multiple Device Play: Players can play the game on whatever devices they have available and switch between them as desired.
  3. 3.
    Simple Sign-In: Players simply choose an email and password to create an account.
  4. 4.
    Cross-Game/Platform Friends with Web3: If your game has multiplayer or social components and as such has a friends feature - players who log in with an existing ready account will automatically have access to their friends. For example, Alice is friends with Bob in Game A. They log in to Game B with the same credentials they used in Game A. Bob and Alice are now in each other's friends list in Game B!
  5. 5.
    Casual, Mobile-Friendly NFTs & Crypto Wallet: Ready's Web3 Tech Stack is enabled by the user authentication feature. For example, a player needs a crypto wallet to hold any NFTs they purchase or earn in your game. Ready's modules allow for a super simple wallet creation flow once a player has an account. For more details and images of how the NFT flow is managed in-game see the GDG for the Store.​

In-Game Implementation: No Previous User Authentication

The below describes the general approach to adding user authentication to a game that previously had no user authentication. For titles that already have a way for players to create an account, see the next section. When it comes to triggering user authentication to prompt a player to make an account there are two primary approaches commonly seen in games today.
Note that the below screenshots are intended to only be illustrative of the trigger point - currently, User Authentication with Ready supports email and password creation only.
​
This is to provide maximum compatibility and ease for RGN players - whether they play on mobile, console, or PC.
​
When integrating RGN tapping to create an account will open a web portal for the player to enter their email and password.
  1. 1.
    On Game Launch: When a player loads your game for the first time a title screen is shown with buttons prompting the player to either make an account or continue as a guest. The Guest option is often relegated to normal text while the account creation options are given larger more enticing buttons. If a player chooses to proceed as a guest the account creation options can be accessed from a menu (like settings) in-game.
On Game Launch User Authentication Example
On mobile platforms, this method is usually seen in titles related to extremely strong IP related to well-known brands. If you are not affiliated with such a brand it would be wise to monitor your onboarding funnel with analytics events for each step that the player will tap or click through. It is not uncommon to lose a significant portion of players at the account creation step when it is triggered on the launch/title screen!
  1. 2.
    Player Triggered: This represents the most common approach. When a player starts the game they are automatically playing as a guest account and must trigger account creation themselves. The game's settings menu is the most common location to allow the player to sign in and out.
Settings Menu User Authentication Example (Remember to indicate the method the player signed in with!)
A third less common approach can be seen in mobile titles which have social systems integrated into their core loop: A hard currency bonus gifted to the player for creating an account. This strategy allows developers to call attention to their login options (usually still in the settings menu) and also increase the number of players that create an account.

In-Game Implementation: Existing Account Creation

The following describes the approach for adding RGN account creation & login to a game or project that already has account creation.
This case is not much different than when no account creation exists already, the primary difference is that RGN account creation is recommended to be triggered by players either manually via a "Connect to RGN" access button or when they require the account for to complete claiming or purchasing an NFT.
  1. 1.
    ​