> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.ggcircuit.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🪙 Coin configuration

The **ggLeap Loyalty System** uses "Coins" that customers can earn and redeem for prizes. This guide walks you through how to configure the system to enhance your customers' gaming experience.

---

### 📑 Table of Contents


* [Coin Configuration](#2-coin-configuration)
* [Coin Formula Tester](#2-coin-formula-tester)
* [Resetting All Users' Coins](#2-resetting-all-users-coins)
---

## 🔧 Coin Configuration

Access this section from:  
**Web Admin → Settings → Loyalty System → Coin Configuration**

|| Don’t forget to click "Save changes" at the bottom after making any updates!
![](https://ggcircuit.atlassian.net/wiki/download/attachments/15860211/image-20250329-022447.png?version=1&modificationDate=1743215090687&cacheVersion=1&api=v2)

---

### 1. **Coin Name**

* Customize the name of your loyalty currency.
* Upload a custom **coin icon** to personalize the look.

---

### 2. **Base Amount**

* Sets the **default coin earning rate per minute** when customers are logged into a PC.

|| Setting the Base Amount to 0 will disable coin earning. Only use this if you don’t plan on offering prizes.

---

### 3. **Coins Earned by Offer (GamePass)**

* Apply a **multiplier** to the base rate for specific GamePass offers.

---

### 4. **Coins Earned by User Group**

* Apply a **multiplier** for specific **User Groups** (e.g., VIPs earn more coins).

---

### 5. **Coins Earned by PC Group**

* Apply a **multiplier** for specific **PC Groups** (e.g., premium setups earn more coins).

|| Multipliers can increase or decrease earnings.
|| A multiplier value of 0 will disable coin earning for that group.

---

## 🧪 Coin Formula Tester

The **"Coin Formula Tester"** tool lets you preview how many coins a customer would earn based on your configuration.

This is especially useful to:

* Test **stacked multiplier scenarios**
* Plan fair **prize pricing**
* Ensure your system is balanced

> **Formula Used:**

```typescript
Coins = (Offer Multiplier × User Group Multiplier × PC Group Multiplier) × (Base Coin Rate × Minutes Logged In)
```
|| If any multiplier is set to 0, the user will not earn any coins.

---

## Resetting All Users' Coins

The **"Reset all users' coins"** button will set every registered user’s coin balance back to **zero**.

|| This action is permanent and cannot be undone.

---