Adonis Promote Plugin

--[[
?? Panora Promote 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 recentPromotions = {}

-- 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 findNextRank(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 promoteViaPanora(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 Promotion Failed:", response and response.Body or response)
		return false
	end
end

server.Commands.PanoraPromote = {
	Prefix = server.Settings.Prefix;
	Commands = {"panorapromote", "ppromote"};
	Args = {"player"};
	Description = "Promotes a player to the next 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 Promote"; 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 Promote"; Message = "Player not found."})
		end

		local last = recentPromotions[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 promoted. Wait ${waitTime} seconds.`
			})
		end

		local currentRankName = target:GetRoleInGroup(GROUP_ID)
		local nextRank = findNextRank(currentRankName)

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

		local requestData = {
			rankerName = plr.Name;
			rankerId = plr.UserId;
			rankeeName = target.Name;
			rankeeId = target.UserId;
			newRankId = nextRank.rankId;
			oldRankName = currentRankName;
			command = "promote | 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 = promoteViaPanora(requestData)
		if success then
			recentPromotions[target.UserId] = os.time()
			server.Remote.MakeGui(plr, "Notification", {
				Title = "Promotion Successful";
				Message = `Promoted {target.Name} to {nextRank.rankName}.`;
				Time = 10;
				Icon = 'rbxassetid://7495462987';
			})
		else
			server.Remote.MakeGui(plr, "Notification", {
				Title = "Promotion Failed";
				Message = `Could not promote {target.Name} to {nextRank.rankName}. Check logs or API Key.`;
				Time = 10;
				Icon = 'rbxassetid://7501176860';
			})
		end
	end;
}
end