> For the complete documentation index, see [llms.txt](https://docs.tryludo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tryludo.com/gaming-getting-started/getting-set-up-with-custom-integration/game-integration-setup-guide.md).

# Game Integration Setup Guide

**Objective:** To enable users to connect their game accounts to Ludo Rewards, access their rewards, and integrate with Discord.

**Step 1: User Login**

* **Action:** Implement a 'Login to Ludo Rewards' button in your game's user interface.
* **Process:** When this button is clicked, initiate an HTTP GET request to the Ludo Rewards login endpoint with the player's unique ID and customer ID.
* **Parameters:**
  * `playerId` (Player's unique ID)
  * `customerId` (Player's unique customer ID from Ludo)
* **Example Endpoint:** `https://{ludorewards_url}/api/v1/auth?playerId=12345&customerId=67890`
* **Expected Response:** The response will include **`session_token`** , **`discord_user_id`** and **`player_id`** which is used for further authentication.

**Sample Code:**

```javascript
document.getElementById('loginButton').addEventListener('click', function() {
  const playerId = '12345'; // Replace with actual player ID
  const customerId = '67890'; // Replace with actual customer ID from Ludo
  const url = `https://{ludorewards_url}/api/v1/login?playerId=${playerId}&customerId=${customerId}`;
  
  fetch(url)
    .then(response => response.json())
    .then(data => {
      // Store sessionToken from data for further requests
      const sessionToken = data.session_token;
      // Handle successful login
    })
    .catch(error => {
      // Handle errors
    });
});
```

**Step 2: Checking Login Status**

* **Action:** After logging in, call the `/me` endpoint to confirm the user's login status.
* **Headers:** Include the received `session_token` in the request headers for secure authentication.
* **Expected Response:** The response includes `playerId` and `id`, the Ludo user ID.

**Sample Code:**

```javascript
const sessionId = 'YOUR_SESSION_TOKEN'; // Replace with the session token from login

fetch('https://{ludo_url}/api/v1/auth/me', {
  headers: { Authorization: `Bearer ${sessionId}` }
})
.then(response => response.json())
.then(data => {
  // Handle successful user data retrieval
})
.catch(error => {
  // Handle errors
});
```

**Step 3: Logging Out**

* **Action:** Implement a logout functionality.
* **Process:** Call the `/logout` endpoint with the user's `session_token` to log the user out.
* **Headers:** Include the `session_token` in the request headers.

**Sample Code:**

```javascript
javascriptCopy code// JavaScript code for logging out
const sessionId = 'YOUR_SESSION_TOKEN'; // Replace with the session token from login

fetch('https://{ludo_url}/api/v1/logout', {
  headers: { Authorization: `Bearer ${sessionId}` },
  method: 'POST'
})
.then(response => {
  // Handle successful logout
})
.catch(error => {
  // Handle errors
});
```

**Additional Steps:**

* **Storing User Data:** Securely store the received `session_token`, `playerId`, and `ludoUserId` in your game's database.
* **Error Handling:** Implement error handling to manage scenarios where the connection process fails.
* **Displaying Rewards and Discord Integration:** Provide options in your game's UI for users to view their rewards and check their Discord integration status.

**Note:** Ensure that the provided URLs, endpoints, and parameter names align with your specific implementation. Test thoroughly to ensure a smooth user experience.