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:- Role Bindings
- Group Binds
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 page1
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!
How Bindings Work
Trigger Conditions
Group Binds trigger when:- User verifies their Roblox account
- User receives a Discord role that has a binding
- User manually syncs with
/sync - Admin force-syncs with
/force_sync @user
Rank Assignment Logic
When a user has multiple bindings: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
- 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
Match Discord role hierarchy
Match Discord role hierarchy
Set priorities to match your Discord role hierarchy. Higher Discord roles = higher priorities.
Leave gaps
Leave gaps
Use priorities like 1, 5, 10, 15 instead of 1, 2, 3, 4. This gives you room to insert new bindings later.
Document your system
Document your system
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
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
Development Team
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
Group not appearing in list
Group not appearing in list
Causes:
- API key doesn’t have access to the group
- API key doesn’t have Group Members permissions
- Group ID is incorrect
- Verify your API key has Group Members Read/Write for the group
- Check the Group ID is correct
- Regenerate API key with correct permissions
Binding not applying
Binding not applying
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
- Ensure user verified with
/verify - Check user is in the Roblox group
- Review binding priorities
- Verify API key is still valid
- Try
/force_sync @useras admin
Wrong rank assigned
Wrong rank assigned
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
Can't remove group
Can't remove group
Solution:
- Delete all bindings for that group first
- Then remove the group
- This prevents orphaned bindings
Security & Permissions
Recommended Permissions
For Group Binds, your API key needs:- ✅ Group Members - Read
- ✅ Group Members - Write
- ❌ Group Settings (not needed)
- ❌ Universe/Game permissions (not needed)
Best Practices
Test with a test account first
Test with a test account first
Before going live, create a binding and test with an alt Discord account to ensure it works as expected.
Use descriptive priorities
Use descriptive priorities
Document what each priority level means (e.g., Priority 1 = Junior Staff, Priority 5 = Senior Staff)
Monitor group audit logs
Monitor group audit logs
Regularly check your Roblox group audit logs to ensure bindings are working correctly and no unauthorized changes occur.
Keep bindings simple
Keep bindings simple
Don’t create overly complex binding systems. Simpler is easier to maintain and troubleshoot.
Combine with Role Bindings
Combine with Role Bindings
Use Role Bindings for members and Group Binds for staff. This gives you the best of both worlds.
Next Steps
Role Bindings
Learn about the reverse: Discord roles from Roblox ranks
Staff Management
Configure staff permissions and access levels
Best Practices
Security and organization tips
Troubleshooting
Solutions to common binding issues
Group Binds automate rank assignment between Discord and Roblox. Set them up once, and promotions sync automatically.
