Role Link Cog

See also: Moderation for mute and role management best practices.

The Role Link cog automatically mirrors a target role when a configured source role is added or removed. This makes it easier to keep booster perks and special access separated from moderation roles such as Muted.

Features

  • Configure up to 5 linked role pairs
  • Automatically add a target role when the source role is granted
  • Automatically remove the target role when the source role is removed
  • Ignore role link behavior when a member has any configured ignored role
  • Log linked role changes to a channel or thread for audit tracking

Commands

Command Description
/rolelink config Open the RoleLink configuration panel
/config cog RoleLink Configure RoleLink using the shared cog settings UI
/rolelink help Display help and usage guidance for RoleLink

Configuration

The Role Link cog uses the standard cog config interface. The key settings are:

  • enabled — Turn RoleLink automation on or off for this server.
  • role_link_1_source through role_link_5_source — The source role to watch for additions/removals.
  • role_link_1_target through role_link_5_target — The target role to add or remove when the source role changes.
  • linked_role_change_logs — A channel or thread where automatic role link adds/removals are logged.
  • ignored_roles — Roles that disable role linking when a member has them.

Booster Perk Separation and Mute Behavior

Role Link is especially useful when you want to keep booster perks separate from moderation flows. For example, if a Nitro booster role should grant a perks role, but a Muted role should prevent that access, configure the Muted role in ignored_roles.

That way, users who are muted or otherwise restricted will not receive the linked target role even if they temporarily get the source role.

Best Practices

  1. Keep booster-role source and target roles distinct from punishment roles.
  2. Use ignored_roles for Muted, Restricted, or other access-limiting roles.
  3. Enable linked_role_change_logs to audit exactly when linked role automation occurs.
  4. Use /rolelink help if you need a quick reminder of how the feature works.