# Ranking Center

**Requirements:**

* Active **Elite Plan**
* Valid **API Key** (see **API Reference Documents**)
* Whitelisted Roblox game where the Rank Center will run (see **API Reference Documents**)

### Accessing the Rank Center

1. Log in to the **Panora Dashboard**.
2. Navigate to the **ELITE section** in the sidebar.
3. Select **Rank Center**.
4. You can download the **Rank Center Roblox Studio file** and view your current configuration.

***

### How It Works

1. **Purchase Gamepasses**
   * Users purchase the Gamepasses you set up in your group game.
   * Each Gamepass is tied to a specific rank promotion.
2. **Automatic Rank Up**
   * Upon successful purchase, the Rank Center uses your API Key to automatically promote the user to the linked rank.
3. **Single Featured Rank (Optional)**
   * You can mark one Gamepass as **featured** to highlight it to users inside your experience.
4. **Elite Plan Required**
   * The Rank Center only functions if your game is whitelisted and you have an active Elite Plan.

***

### Using the Downloaded File

1. **Run the File**
   * Open the downloaded `.rbxl` file in Roblox Studio.
2. **Configure Script Settings**
   * Navigate to `ServerScriptService → PANORA_CONFIG`
   * Replace the placeholder **API Key** with your own
   * Set your **Roblox Group ID**
   * Add your **Gamepass IDs** and corresponding **Rank IDs**
   * Mark one Gamepass as `featured = true` (optional, recommended)
3. **Enable Required Permissions**
   * In Studio, go to **Home → Game Settings → Security**
   * Enable:
     * **HTTP Requests**
     * **Third Party Teleports**
4. **Publish to Group**
   * Publish the game under your Roblox Group to activate integration.

***

### Script Configuration

Below is the configuration script included in the downloaded file:

```lua
--[[ 
=======================================
📝 PANORA RANK CENTER CONFIG
=======================================

This script initializes the Panora Rank Center Module.
Follow the instructions to configure it for your Roblox group.

✅ WHAT TO DO:
1. Replace the API Key with your Panora Dashboard API Key.
2. Replace the Group ID with your Roblox Group ID.
3. Replace Gamepass IDs and corresponding Rank IDs.
4. Ensure only ONE Gamepass has `featured = true`.

⚙️ BEFORE PUBLISHING:
- Go to Home → Game Settings → Security:
  - Enable “Allow HTTP Requests”
  - Enable “Enable Third Party Teleports”

🚫 DO NOT:
- Change the module `require()` line unless instructed by Panora staff.
- Use the same Rank ID for multiple passes.
]]

local PanoraRankCenterModule = require(90080033642759)

local panoraInstance = PanoraRankCenterModule.init(
  "PANORA-••••••••••••••••••••••••••••••••-API-••••••••••••••••", -- Replace with your API Key
  {
    GroupId = 123456789, -- Replace with your Roblox Group ID
    Passes = {
      { passId = 123456789, rankId = 120, featured = true },
      { passId = 987654321, rankId = 130, featured = false },
      -- Add more passes as needed
    }
  }
)

-- Notes:
-- API Key is private; do not share publicly.
-- Group ID is in the Roblox group URL: https://www.roblox.com/groups/GROUPID/Group-Name
```

> Only **one Gamepass** should have `featured = true`. This pass will be highlighted in the user interface.