Documentation

Everything you need to know about using the Discord Role Link Bot.

  1. 1

    Add the Bot to Your Server

    Click the "Add to Discord" button and select your server. The bot requires "Manage Roles" permission to function properly.

  2. 2

    Set Up Logging

    Use the /set-log command to specify a channel for bot activity logs.

  3. 3

    Create Your First Role Link

    Use the /create-rl command to set up your first role link.

Role Links

Create automatic role assignments triggered by specific roles. Link up to three roles to a single trigger role.

Secure Management

Administrator-only commands and detailed logging ensure secure role management.

Scheduled Roles

Set up time-based role assignments with custom schedules and durations.

Templates

Save and reuse role configurations with templates for quick setup.

Commands Reference

Detailed information about all available bot commands.

/create-rl

Create a new role link that automatically assigns roles when a trigger role is given.

Usage:

/create-rl trigger:@role linked1:@role1 [linked2:@role2] [linked3:@role3]

Example:

/create-rl trigger:@Member linked1:@Access linked2:@General
/list

View all active role links in your server.

Usage:

/list
/delete-rl

Remove an existing role link configuration.

Usage:

/delete-rl trigger:@role

Example:

/delete-rl trigger:@Member
/set-log

Set up a logging channel for bot activity.

Usage:

/set-log channel:#channel

Example:

/set-log channel:#bot-logs
/schedule-rl

Create time-based role assignments with custom schedules.

Usage:

/schedule-rl trigger:@role linked:@role start:HH:mm end:HH:mm days:day1,day2

Example:

/schedule-rl trigger:@Event linked:@Access start:09:00 end:17:00 days:mon,wed,fri
/create-template

Save your current role configuration as a reusable template.

Usage:

/create-template name:string description:string

Example:

/create-template name:staff-roles description:"Standard staff role configuration"

Security Features

Permission Control

Admin-only commands ensure only authorized users can modify role configurations.

Role Hierarchy

Respects Discord's role hierarchy to prevent unauthorized role modifications.

Audit Logging

Detailed logs of all role changes and command usage for accountability.

Role Scheduling

Time-Based Roles

Automatically assign and remove roles at specific times of the day.

Day Selection

Choose specific days of the week for role assignments to occur.

Recurring Schedules

Set up recurring role assignments that repeat on a regular basis.

Frequently Asked Questions

How many role links can I create?

You can create up to 3 role links per server, each with up to 3 linked roles.

What permissions does the bot need?

The bot requires "Manage Roles" permission and its role must be higher than the roles it manages.

Can I use the same role multiple times?

No, each role can only be used once per role link to prevent conflicts.