Skip to main content
Promote users in-game using Lumira’s API alongside Basic Admin Essentials.
Any Rank Abuse, coming internally from your end does not make us liable. Read our terms at lumiraranking.co.uk/terms & /privacy.

​
What this plugin does

  • Promotes a player to their next Roblox group rank
  • Sends promotion requests through the Lumira API
  • Supports promoting:
    • A single user (by username)
    • Multiple users (ex: trustfundi, abthecooldood, Twitch_OliPlayz)

​
Folder Structure

Your Roblox Studio hierarchy must match this structure: 
Lumira Ranking
│
├── Plugin Scripts
│   ├── Lumira Demote
│   ├── Lumira Promote
│   └── Lumira SetRank
│
├── ReplicatedStorage
│   └── LumiraRanking

​
Where do I get the Plugin?

You can download the plugin here.
  • Once you download the plugin, you can now continue on setting up the product.

​
1) Open Roblox Studio

  • Launch Roblox Studio
  • Open the place where Basic Admin Essentials is installed

​
2) Insert / Edit the Promote Plugin Script

  1. In the Explorer, locate:
    Lumira Ranking → Plugin Scripts
  2. Select Lumira Promote
  3. Open the script

​
1) Configure the Plugin

At the top of the script, replace the configuration values:

​
Required

  • ApiKey → your Lumira API key
  • GroupId → your Roblox group ID

​
2) Get your API Key

  1. Join your the Lumira server
  2. Generate your API key using the bot command
    (example: /apikey create )
  3. Copy your API key
  4. Go to Lumira Ranking in Replicated Storage
  5. Paste it into: 
    ApiKey  = 'YOUR_API_KEY'

​
3) Ensure Roblox Settings Are Correct

To allow API requests:
  • Go to Game Settings → Security
  • ✅ Enable Allow HTTP Requests
Also make sure:
  • Your Roblox Group ID is correct
  • Your API Key is correct
  • The group has a proper rank structure
  • Your system has permission to promote users

​
4) How to Use the Command (In-Game)

​
Promote One Player

Use your Basic Admin prefix (commonly :) Example: 
:promote username
The command name is based on the Script name.
If you rename it, the command changes accordingly.

​
Troubleshooting

​
“API error” / Promotions failing

  • Ensure HTTP Requests are enabled
  • Verify your API key is correct
  • Make sure Lumira services are reachable
  • Confirm your group ID is valid and properly configured
  • Check that your system has permission to promote users