UnRankTemp function, Remove temporary ranks, not permanent ones!

@OneBlueHat · 2025-07-13 · 3 votes · 1 comments · imported from Discord · marked done by @ForeverHDTeam on 2026-09-23

The :unRank function sets a user's rank to NonAdmin, even if they were permRanked to Vip or Mod, which is not ideal.

The :unRankTemp function would basically just remove any tempRanks given to a player.
This is intended for the API 🙃

Solved by @ForeverHDTeam · See the solution

Comments

@ForeverHDTeam · 2026-09-23Solution

good news, v2 does exactly this. temp and permanent roles are now separate things with their own commands, so taking one never touches the other:

via chat / interface

;giveServerRole <player> <role> and ;takeServerRole <player> <role> - a role for this server only, gone when they leave
;givePermRole <user> <role> and ;takePermRole <user> <role> - a saved role that follows the user across every server. these work on offline users too, so you can use a username or user id of someone who isn't in the game

;takeServerRole only removes a server role. if the person also holds that role permanently, the permanent one stays exactly as it was, which is the bit v1's :unRank got wrong and has been great to finally solve with v2

from the api

local hd = game:GetService("ReplicatedStorage"):WaitForChild("HD Admin")
local ServerAPI = require(hd.Core.ServerAPI)

-- this server only
ServerAPI.giveRoleAsync(player, "Mod", { scope = "server" })
ServerAPI.takeRoleAsync(player, "Mod", { scope = "server" })

-- saved permanently, works for offline players too
ServerAPI.giveRoleAsync(player, "VIP")
ServerAPI.takeRoleAsync(player, "VIP", { scope = "perm" })

-- a role that removes itself, here a 24 hour trial
ServerAPI.giveRoleAsync(player, "Mod", { scope = "expire", duration = 24 * 3600 })

docs for all of this at hdadmin.com/server-api/#giveroleasync-server and hdadmin.com/server-api/#takeroleasync-server