Session 42 Studios has put together this automatic ranking system to make ROBLOX group ranking bots much easier. Using this, you can automatically promote, demote, and rank your group members using a classic ROBLOX Studio script.


This is how to use this system in ROBLOX Studio scripts: https://session42studios.freshdesk.com/support/solutions/articles/101000393997



Required data


  • Username (string)
    • this is the username of the target player - the player that will be ranked.
  • Group ID (number)
    • this should be the ID of your group.
  • Role ID (number) - only when ranking to a specific rank
    • this should be the rank ID/number of the target rank when ranking to a specific role.
  • Bot account cookie (string)
    • this should be the .ROBLOXSECURITY cookie of the account you want to use for ranking (read security disclaimer below)




How the ranking system works


The Session 42 Studios ranking system works via webhooks. You can make a request to our application via a URL containing the data you need. Accessing the link via a browser will also trigger the application.


The application will run a Python code that will connect to your bot account via the cookie you provide, and rank the target user to the specified rank. The script will not stay connected to your account. There is nothing to worry about.




Making ranking requests (direct link)


Our application API server is https://session42-ranking.herokuapp.com/. Every request will be done via this domain name.



A. Promotion requests


https://session42-ranking.herokuapp.com/group/promote?user_name={TARGET_USERNAME_HERE}&groupid={GROUP_ID_HERE}&cookie={BOT_ACCOUNT_COOKIE_HERE} 


  • Replace {TARGET_USERNAME_HERE} with the username of the player to be ranked.
  • Replace {GROUP_ID_HERE} with the ID of your group.
  • Replace {BOT_ACCOUNT_COOKIE_HERE} with the .ROBLOSECURITY cookie of the bot account responsible with ranking.


This will set the specified user's rank to the one above them (if the bot has permission to rank them).


B. Demotion requests


https://session42-ranking.herokuapp.com/group/demote?user_name={TARGET_USERNAME_HERE}&groupid={GROUP_ID_HERE}&cookie={BOT_ACCOUNT_COOKIE_HERE}


  • Replace {TARGET_USERNAME_HERE} with the username of the player to be ranked.
  • Replace {GROUP_ID_HERE} with the ID of your group.
  • Replace {BOT_ACCOUNT_COOKIE_HERE} with the .ROBLOSECURITY cookie of the bot account responsible with ranking.


This will set the specified user's rank to the one below them (if the bot has permission to rank them).


C. Ranking requests (set specific rank)


https://session42-ranking.herokuapp.com/group/rank?user_name={TARGET_USERNAME_HERE}&groupid={GROUP_ID_HERE}&role_number={TARGET_RANK_ID}&cookie={BOT_ACCOUNT_COOKIE_HERE}


  • Replace {TARGET_USERNAME_HERE} with the username of the player to be ranked.
  • Replace {GROUP_ID_HERE} with the ID of your group.
  • Replace {TARGET_RANK_ID} with the ID of the role the user should be ranked to.
  • Replace {BOT_ACCOUNT_COOKIE_HERE} with the .ROBLOSECURITY cookie of the bot account responsible with ranking.


This will set the specified user's rank to the one specified in the URL (if the bot has permission to rank them).




Usage


This can be used to make ranking requests from ROBLOX Studio scripts or any other scripts (e.g. Discord bot scripts).




Security


The system operates using very confidential log-in information: the account cookie. This cookie shouldn't be shared because it allows the log-in to the account. However, this is the only way this system can work. Your cookie is not being stored, nor logged. The system is 100% secured and doesn't have any breaches.