# Login System

## What is the Login System?

The **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" %}
**Login System Addon** is a separate subscription service. **30 DAYS FREE TRIAL AVAILABLE**\
See plans [here](https://app.gamelauncher.cloud/choose-plan#login-system-features)
{% endhint %}

***

## How It Works

### Without Login System

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

### With Login 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&#x26;token=02f7f168-9a1d-4582-9e29-9e93f6fc505a" alt=""><figcaption><p>Login 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&#x26;token=cd0bc8b9-9832-4242-9575-709180166b4d" alt=""><figcaption><p>Login 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&#x26;token=6cfce3f3-d810-46a2-818f-a5ddfed968d0" alt=""><figcaption><p>Login 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&#x26;token=efd77739-9a54-4193-ad1c-35206ea92893" alt=""><figcaption><p>Login 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&#x26;token=81562a33-cf95-4c87-9a25-2ea8d4e72537" alt=""><figcaption><p>Login 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&#x26;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&#x26;token=cc0c98c7-b229-49bc-8614-3b12001d610f" alt=""><figcaption><p>Login 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&#x26;token=fc610b26-6660-46fa-a5ef-5b4718f41ec9" alt=""><figcaption><p>Login 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&#x26;token=95552951-7e09-4218-b958-f599634b4915" alt=""><figcaption><p>Login 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&#x26;token=441e881d-bdfc-49ba-869e-106c3be7aba5" alt=""><figcaption><p>Login 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&#x26;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

***

## Coming Soon

| Feature                 | Status            |
| ----------------------- | ----------------- |
| **Achievements System** | 🚧 In Development |
| **Cloud Saves**         | 🚧 In Development |

***

## Pricing

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

*The Login 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 **Login 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](https://gamelauncher.cloud/help/add-ons/login-system/app-launch-tokens)

***

## Need Help?

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