Skip to main content

Group Binds

Group Binds automatically assign Roblox group ranks when users get specific Discord roles. This is the reverse of Role Bindings—instead of Discord roles based on Roblox ranks, you assign Roblox ranks based on Discord roles.

Group Binds vs. Role Bindings

Understanding the difference is crucial:
Direction: Roblox → DiscordWhat it does: Gives Discord roles based on Roblox group rankExample: User is rank 100 in Roblox group → Gets @Moderator role in DiscordUse case: Automatic role assignment for verified members
Most servers use Role Bindings. Group Binds are for advanced automation where you want Discord to control Roblox ranks.

Prerequisites

Before setting up Group Binds, you need:
1

Roblox Group Ownership

You must own or have admin access to the Roblox group
2

Open Cloud API Key

Create an API key with Group Members Read/Write permissions Roblox Open Cloud
3

Discord Server Admin

You need Manage Server or Administrator permission in Discord

Getting Started

Onboarding

When you first visit the Group Binds page, you’ll see an empty page
1

Add an Group

Click on Add Group
2

Enter Group ID

Type in your Roblox Group ID
3

Type in your Open Cloud API key

Enter your API key
4

Click Save

Your Goup should now appear
5

Setup a binding

Select a Discord role and choose your Roblox Group
6

Select a roblox rank

Select a Roblox rank and Click save and thats it!
Technified will automatically show your Roblox group in the Dashbaord after Saving!

How Bindings Work

Trigger Conditions

Group Binds trigger when:
  1. User verifies their Roblox account
  2. User receives a Discord role that has a binding
  3. User manually syncs with /sync
  4. Admin force-syncs with /force_sync @user

Rank Assignment Logic

When a user has multiple bindings:
User Roles:
  - @Helper (binding: rank 50, priority 1)
  - @Moderator (binding: rank 100, priority 2)
  - @Admin (binding: rank 200, priority 3)

Result: User gets rank 200 (highest priority)
Priority is key! If a user has multiple roles with bindings, the binding with the highest priority is applied. If priorities are equal, the highest rank is applied.

Priority System Explained

Priority determines which rank to assign when a user has multiple qualifying roles.

Example Scenario

Bindings:
1. @Staff        → Rank 10  (Priority 1)
2. @Moderator    → Rank 50  (Priority 2)
3. @Admin        → Rank 100 (Priority 3)
4. @Senior Admin → Rank 150 (Priority 4)
If user has:
  • Just @Staff → Gets rank 10
  • @Staff + @Moderator → Gets rank 50 (priority 2 beats priority 1)
  • @Moderator + @Admin → Gets rank 100 (priority 3 beats priority 2)
  • All four roles → Gets rank 150 (priority 4 wins)

Best Practices for Priorities

Set priorities to match your Discord role hierarchy. Higher Discord roles = higher priorities.
Use priorities like 1, 5, 10, 15 instead of 1, 2, 3, 4. This gives you room to insert new bindings later.
Keep a note of which priority corresponds to which staff tier. Makes troubleshooting easier.

Multiple Groups

You can connect up to multiple Roblox groups to one Discord server.

Managing Multiple Groups

Each group can have its own set of bindings:
  • Group A: Development Team
  • Group B: Moderation Team
  • Group C: Community Group
Users can have different ranks in different groups based on their Discord roles.

Cross-Group Bindings

You cannot create a binding that assigns ranks in Group A based on ranks in Group B. Each binding is per-group only.

Common Configurations

Community Server with Staff Promotion

Discord Roles → Roblox Ranks:

@Trial Mod    → Rank 10  (Priority 1)
@Moderator    → Rank 50  (Priority 2)
@Senior Mod   → Rank 75  (Priority 3)
@Admin        → Rank 100 (Priority 4)
@Head Admin   → Rank 200 (Priority 5)
Use case: When you promote someone to @Moderator in Discord, they automatically get rank 50 in your Roblox group.

Development Team

Discord Roles → Roblox Ranks:

@Junior Dev   → Rank 100 (Priority 1)
@Developer    → Rank 150 (Priority 2)
@Senior Dev   → Rank 200 (Priority 3)
@Lead Dev     → Rank 250 (Priority 4)
Use case: Development team ranks stay in sync between Discord and Roblox.

Combined Systems

You can use both Role Bindings AND Group Binds: Role Bindings: Roblox group members automatically get Discord roles Group Binds: Discord staff promotions automatically update Roblox ranks This creates a bidirectional sync for staff members.

Troubleshooting

Causes:
  • API key doesn’t have access to the group
  • API key doesn’t have Group Members permissions
  • Group ID is incorrect
Solution:
  • Verify your API key has Group Members Read/Write for the group
  • Check the Group ID is correct
  • Regenerate API key with correct permissions
Causes:
  • User hasn’t verified their Roblox account
  • User isn’t in the Roblox group
  • User has another binding with higher priority
  • API key expired or revoked
Solution:
  • Ensure user verified with /verify
  • Check user is in the Roblox group
  • Review binding priorities
  • Verify API key is still valid
  • Try /force_sync @user as admin
Cause: Priority conflict or user has multiple rolesSolution:
  • Check which roles the user has
  • Review priorities of all matching bindings
  • Highest priority wins - adjust if needed
Solution:
  • Delete all bindings for that group first
  • Then remove the group
  • This prevents orphaned bindings

Security & Permissions

Group Binds require high-privilege API keysYour API key can:
  • Change member ranks
  • more coming soon
Security measures:
  • Only share API keys with trusted admins
  • Use API keys from alt accounts if possible
  • Regularly rotate API keys
  • Monitor group audit logs for unexpected changes
  • Revoke keys immediately if compromised
For Group Binds, your API key needs:
  • Group Members - Read
  • Group Members - Write
  • ❌ Group Settings (not needed)
  • ❌ Universe/Game permissions (not needed)
Only grant what’s necessary.

Best Practices

Before going live, create a binding and test with an alt Discord account to ensure it works as expected.
Document what each priority level means (e.g., Priority 1 = Junior Staff, Priority 5 = Senior Staff)
Regularly check your Roblox group audit logs to ensure bindings are working correctly and no unauthorized changes occur.
Don’t create overly complex binding systems. Simpler is easier to maintain and troubleshoot.
Use Role Bindings for members and Group Binds for staff. This gives you the best of both worlds.

Next Steps


Group Binds automate rank assignment between Discord and Roblox. Set them up once, and promotions sync automatically.