Role sync

How MGS Link decides what Discord roles a verified member should have based on their Roblox group ranks.

Mapping shape

Each mapping is a tuple of (roblox group, minimum rank, discord role, priority). The condition is "if the user is at rank ≥ this in this group, grant this role."

12345678 · ≥ 1   → @Member       priority 0
12345678 · ≥ 50  → @Moderator    priority 10
12345678 · ≥ 100 → @Admin        priority 50
12345678 · ≥ 254 → @Owner        priority 100

Resolution modes

You can flip these in the dashboard at any time. The change applies on the next sync.

Additive (default)

Every mapping the user satisfies grants its role. A rank-50 mod also keeps their rank-1 member role. Safe and predictable.

When to use

Most communities. Especially when roles double as cosmetic ladder badges.

Highest-rank only

Per Roblox group, the user only gets the role for their highest matched rank. Other mapped roles are removed.

When to use

Tight role lists where you don't want a clutter of stacked badges per member.

Single role across mappings

Across all groups, the highest-priority mapping wins. Useful when one role represents the user's overall rank.

When to use

You have a "primary" group and the rest are auxiliary.

Safety rails

Protected roles

Roles in this list are never added or removed by MGS Link, even if a mapping references them. Use this for roles that get assigned via other systems (ticket bots, Patreon, etc).

Ignored roles

A softer guardrail: MGS Link won't ADD these roles, but won't pretend they don't exist either. Useful for purely-decorative roles you assign manually.

Hierarchy check

The bot can only manage roles below itself in the role list. We surface a warning in the dashboard if a mapped role is positioned higher than MGS Link's integration role.

When sync runs

Right after a successful verification.
On manual triggers: /verify refresh for one user, /mgslink resync user for an admin-targeted refresh, /mgslink resync all for a guild-wide pass.
Whenever you change settings or mappings in the dashboard.
Periodically for active members on Pro and Enterprise plans.

Next · Nickname sync