> For the complete documentation index, see [llms.txt](https://gamelauncher.cloud/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://gamelauncher.cloud/help/add-ons/login-system.md).

# Auth System

Add user authentication and management to your game launcher

## What is the Auth System?

The **Auth System** (also called Login System) is an add-on service that adds user authentication to your game launcher. Allowing players to create accounts and sign in before accessing your game. You can manage and see analytics of these accounts.

{% hint style="info" %}
**Auth System Addon** is a separate subscription service. **FREE PLAN AVAILABLE**\
See plans [here](https://app.gamelauncher.cloud/choose-plan#login-system-features)
{% endhint %}

***

## How It Works

### Without Auth System

Your launcher starts directly, and players can immediately access and play your game without any account required.

### With Auth System Enabled

1. When players open your launcher, they see a **login/registration window** first
2. Players can **create an account**, **sign in**, or continue as a **guest** (if enabled)
3. After authentication, they access the launcher normally
4. You get access to a **dedicated user database** and **management tools**

<figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FKKMwUFSUTWS5rL4gDweC%2Fimage.png?alt=media&amp;token=02f7f168-9a1d-4582-9e29-9e93f6fc505a" alt=""><figcaption><p>Auth System - Login Screen</p></figcaption></figure>

***

## What's Included

Adds the Login Screen when the Launcher starts:

* Login
* Register

<figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FaZSjop6wVgiKxLH6aQZa%2Fimage.png?alt=media&amp;token=cd0bc8b9-9832-4242-9575-709180166b4d" alt=""><figcaption><p>Auth System - Register</p></figcaption></figure>

* Forgot Password

<figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2F1XnwO1ZNq82b0yHnY3sy%2Fimage.png?alt=media&amp;token=6cfce3f3-d810-46a2-818f-a5ddfed968d0" alt=""><figcaption><p>Auth System - Forgot Password</p></figcaption></figure>

* Change Password

<figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FYd9mL8MRYLsSZ4VPWhRr%2Fimage.png?alt=media&amp;token=efd77739-9a54-4193-ad1c-35206ea92893" alt=""><figcaption><p>Auth System - Change Password</p></figcaption></figure>

### Multiple Login Methods

Offer your players flexible ways to sign in:

| Method                 | Description                                               |
| ---------------------- | --------------------------------------------------------- |
| **Email & Password**   | Traditional account creation with email verification      |
| **Guest Login**        | Let players try your game without registration (optional) |
| **Google**             | One-click sign in with Google accounts                    |
| **Discord**            | Sign in with Discord (great for gaming communities)       |
| **Patreon**            | Perfect for supporter/patron verification                 |
| *And more incoming...* |                                                           |

{% hint style="success" %}
You can **enable or disable** each login method individually from your launcher settings.
{% endhint %}

<div data-full-width="true"><figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FbIsxay5i9svjL24T1TIE%2Fimage.png?alt=media&amp;token=81562a33-cf95-4c87-9a25-2ea8d4e72537" alt=""><figcaption><p>Auth System Addon on Dashboard</p></figcaption></figure></div>

***

### User Management

Manage your player community from the dashboard:

| Feature                | Description                                                 |
| ---------------------- | ----------------------------------------------------------- |
| **Registered Users**   | View and search your complete user database                 |
| **Active Users**       | Monitor who's currently online and their session info       |
| **Ban Users**          | Moderate your community by banning problematic players      |
| **Email Verification** | Automatic email confirmation for new registrations          |
| **Managed Access**     | Restrict registration/login to pre-approved email addresses |

<div data-full-width="true"><figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FazhgQtd83kupDumc75DI%2Fimage.png?alt=media&amp;token=40762227-2ccc-4c3f-bfc8-c4486adc01ce" alt=""><figcaption><p>Registered Users on Dashboard</p></figcaption></figure></div>

***

### Managed Access (Enable/Disable)

<div data-full-width="true"><figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FRCvoqCIXsrNg1gfJiT4V%2Fimage.png?alt=media&amp;token=cc0c98c7-b229-49bc-8614-3b12001d610f" alt=""><figcaption><p>Auth System Managed Access</p></figcaption></figure></div>

Control exactly who can access your launcher:

### **Pre-approved Email List**

* Create a whitelist of email addresses
* Only emails on your list can register or login
* Perfect for closed alphas, beta tests, or VIP access
* Manage your whitelist directly from the dashboard

{% hint style="warning" %}
When enabled, users with emails not on your whitelist will be **blocked** from registering or logging in.
{% endhint %}

**Coming Soon**

* **Invite Codes** - Generate and manage invite codes for registration
* **Donor Sync** - Auto-sync access with Patreon/Ko-fi donor status

<div data-full-width="true"><figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FCRwkEuqLEvsUru9AwvvV%2Fimage.png?alt=media&amp;token=fc610b26-6660-46fa-a5ef-5b4718f41ec9" alt=""><figcaption><p>Auth System Managed Access - Email Whitelist</p></figcaption></figure></div>

***

### Analytics & Insights

Track your user engagement:

* **Active players** in real-time
* **Total registered users**
* **Session tracking** (playtime, platforms, versions)
* **Email delivery metrics** (sent, open rates, bounces)

<div data-full-width="true"><figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FTf27yIz3SSclzipNUYmP%2Fimage.png?alt=media&amp;token=95552951-7e09-4218-b958-f599634b4915" alt=""><figcaption><p>Auth System Analytics</p></figcaption></figure></div>

<div data-full-width="true"><figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FNv7mUo1KkbsyubCEmeQk%2Fimage.png?alt=media&amp;token=441e881d-bdfc-49ba-869e-106c3be7aba5" alt=""><figcaption><p>Auth System Detailed Analytics</p></figcaption></figure></div>

***

### Email Analytics

<div data-full-width="true"><figure><img src="https://4241524842-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnNH3XbUy7pSptjMVADb2%2Fuploads%2FrYyrhZJPQw8NeRwNC4vu%2Fimage.png?alt=media&amp;token=64a9e942-6a5d-4358-af86-50db616e958f" alt=""><figcaption><p>Email analytics</p></figcaption></figure></div>

Automatic emails are sent for:

* **Email address verification**
* **Password reset/recovery**

#### Email Limits

Each launcher includes email sending capacity:

| Limit        | Amount     |
| ------------ | ---------- |
| **Per Hour** | tier-based |
| **Per Day**  | tier-based |

{% hint style="info" %}
**Need more emails?** [Contact us](mailto:support@gamelauncher.cloud) to upgrade your limits for higher-volume launchers.
{% endhint %}

#### Custom Email Branding (soon)

{% hint style="info" %}
Emails are send using\
**From:** *<no-reply@gamelauncher.cloud>*\
**Sender name:** *Your Launcher Title*
{% endhint %}

Make emails match your brand:

* Use your own **SMTP server**
* Configure a **custom email domain**
* Add your **logo and colors**
* Customize the **sender name and address**

🚧 In Development

***

## Pricing

See <https://gamelauncher.cloud/choose-plan/>

*The Auth System addon can be added to any Game Launcher Cloud plan.*\
\&#xNAN;*You can enable or disable it at any time from your subscription settings.*

***

## How to Enable

1. Go to **Subscription** in your dashboard
2. Enable the **Auth System** addon
3. Configure your preferred **login methods** in Launcher Settings
4. Build and deploy your launcher

That's it! Your next launcher build will include the login window.

***

## Passing User Identity to Your Game

Want your game to know **who** is playing? Use **App Launch Tokens** to securely pass the authenticated user's identity to your game at launch time.

➡️ [App Launch Tokens](/help/add-ons/login-system/app-launch-tokens.md)

***

## Need Help?

If you have questions about the Login System or need custom email limits, [contact our support team](mailto:support@gamelaunchercloud.com).