Adonis Demote Plugin

This feature requires:

An active Elite Plan
A valid API Key
See API Key
A whitelisted game where your admin is located
See Whitelist

📥 Installation

Open Roblox Studio

Navigate to your Adonis Admin Adonis_Loader in Roblox Studio.

Inserting Script

Create a ModuleScript named Server-PanoraDemote.lua under Config in the Plugins folder, delete everything in it, and paste the code below.

Panora Demote Command

Server-PanoraDemote.lua

--[[
?? Panora Demote Plugin - Adonis Integration

?? INSTALLATION & CONFIGURATION INSTRUCTIONS

1. Insert this ModuleScript under the "Plugins" folder in your Adonis Admin system.
2. Navigate to https://app.panora.cc and obtain your unique API key. Replace the API_KEY variable below with that key.
3. Set your Roblox Group ID that is linked to your Panora Workspace in the GROUP_ID variable.
4. In the Panora dashboard, under the "Panora API" tab, whitelist your game's Universal Game ID to allow API access.
5. Update the `ranks` table to reflect your group's rank IDs and their exact corresponding names.
6. Set a cooldown period for promotions. We recommend a minimum of 20 seconds due to delay in Roblox rank updates, which can cause incorrect behavior if users are promoted too rapidly.

?? WARNING:
Do not modify any backend logic or functionality unless you are experienced with Lua and BAE plugin structures.
Panora support will not assist with issues caused by unauthorized script modifications. You may only safely modify:
- API Key
- Group ID
- Rank definitions
- Cooldown time

??? This plugin allows authorized users to promote a player to the next rank within your defined hierarchy using the Panora API.

--]]

return function(Vargs)
local server, service = Vargs.Server, Vargs.Service
local HttpService = service.HttpService

-- ✅ REQUIRED CONFIGURATION
local API_KEY = "YOUR_PANORA_API_HERE" -- Replace with your Panora API key
local GROUP_ID = 000000 -- Replace with your Roblox group ID

local COOLDOWN_TIME = 20 -- Cooldown in seconds
local recentDemotions = {}

-- Define your group rank structure in order (from lowest to highest)
local ranks = {
	{rankId = 1, rankName = "Member"},
	{rankId = 2, rankName = "Moderator"},
	{rankId = 3, rankName = "Admin"},
	-- Add more ranks as needed in ascending order
}

-- DO NOT MODIFY BELOW, UNLESS YOU KNOW WHAT YOU'RE DOING!

local function findPreviousRank(currentName)
	for i, rankData in ipairs(ranks) do
		if rankData.rankName == currentName and ranks[i - 1] then
			return ranks[i - 1]
		end
	end
	return nil
end

local function demoteViaPanora(data)
	local url = "https://api.panora.cc/v1/ranker?placeid=" .. game.GameId
	local payload = HttpService:JSONEncode(data)

	local success, response = pcall(function()
		return HttpService:RequestAsync({
			Url = url,
			Method = "POST",
			Headers = {
				["Authorization"] = "Bearer " .. API_KEY,
				["Content-Type"] = "application/json",
			},
			Body = payload,
		})
	end)

	if success and response.Success then
		return true
	else
		warn("Panora Demotion Failed:", response and response.Body or response)
		return false
	end
end

server.Commands.PanoraDemote = {
	Prefix = server.Settings.Prefix;
	Commands = {"panorademote", "pdemote"};
	Args = {"player"};
	Description = "Demotes a player to the previous group rank using the Panora API";
	AdminLevel = "Moderators";
	Function = function(plr, args)
		if not args[1] then
			return server.Remote.MakeGui(plr, "Output", {Title = "Panora Demote"; Message = "Please specify a player."})
		end

		local target = service.GetPlayers(plr, args[1])[1]
		if not target then
			return server.Remote.MakeGui(plr, "Output", {Title = "Panora Demote"; Message = "Player not found."})
		end

		local last = recentDemotions[target.UserId]
		if last and os.time() - last < COOLDOWN_TIME then
			local waitTime = COOLDOWN_TIME - (os.time() - last)
			return server.Remote.MakeGui(plr, "Output", {
				Title = "Cooldown";
				Message = `{target.Name} was recently demoted. Wait ${waitTime} seconds.`
			})
		end

		local currentRankName = target:GetRoleInGroup(GROUP_ID)
		local prevRank = findPreviousRank(currentRankName)

		if not prevRank then
			return server.Remote.MakeGui(plr, "Output", {
				Title = "Already Lowest Rank";
				Message = `{target.Name} is already at the lowest rank or not found in the rank list.`
			})
		end

		local requestData = {
			rankerName = plr.Name;
			rankerId = plr.UserId;
			rankeeName = target.Name;
			rankeeId = target.UserId;
			newRankId = prevRank.rankId;
			oldRankName = currentRankName;
			command = "demote | Adonis Integration";
			prefix = server.Settings.Prefix;
			webhookUrl = nil; -- Add webhookUrl if you want to send Ranking Logs (Format: "https://discord.com/api/webhooks/id/token")
		}

		local success = demoteViaPanora(requestData)
		if success then
			recentDemotions[target.UserId] = os.time()
			server.Remote.MakeGui(plr, "Notification", {
				Title = "Demotion Successful";
				Message = `Demoted {target.Name} to {prevRank.rankName}.`;
				Time = 10;
				Icon = 'rbxassetid://7495462987';
			})
		else
			server.Remote.MakeGui(plr, "Notification", {
				Title = "Demotion Failed";
				Message = `Could not demote {target.Name} to {prevRank.rankName}. Check logs or API Key.`;
				Time = 10;
				Icon = 'rbxassetid://7501176860';
			})
		end
	end;
}
end

API Key

Visit https://app.panora.cc and copy your API Key.
See API Key
Replace the API_KEY in the script with your actual API key.
Under the Panora Dashboard > Panora API, whitelist your game’s Universal Game ID.
See Whitelist

Roblox Group

Set your GROUP_ID to match the Roblox group linked to your Panora workspace.
See Initial Setup
Configure your group ranks in the ranks table in ascending order.
Set a cooldown time to avoid rapid promotions (recommended: 20 seconds).

⚙️ Configuration

Variable	Description	Required
`API_KEY`	Your Panora API key from app.panora.cc	✅
`GROUP_ID`	Roblox Group ID linked to your workspace	✅
`ranks`	An ordered table of your group ranks	✅
`COOLDOWN_TIME`	Seconds to wait before promoting a user again	⚠️ Recommended

Example ranks table:

local ranks = {
  {rankId = 1, rankName = "Member"},
  {rankId = 2, rankName = "Moderator"},
  {rankId = 3, rankName = "Admin"},
}

Panora API

Roblox Admin Integration

API References

Adonis Demote Plugin

📥 Installation

⚙️ Configuration

Panora API

Roblox Admin Integration

API References

​📥 Installation

​⚙️ Configuration

📥 Installation

⚙️ Configuration