Skip to main content

Core Concepts

Before diving into advanced features, it helps to understand how RoleLogic thinks about role automation. This section covers the fundamental building blocks.

The Big Picture​

RoleLogic operates on a simple principle: rules. Each rule has two parts:

  1. Condition (IF) — When should this rule trigger?
  2. Action (THEN) — What should happen when it triggers?

When a member's roles change, RoleLogic checks every rule to see if any conditions match. If they do, it performs the corresponding actions.

Core Building Blocks​

Rules​

A rule is a complete instruction that tells RoleLogic what to do. Think of it as an automated if-then statement:

"IF a member has the Booster role, THEN add the VIP role"

Rules have additional settings like priority (which rule runs first) and can be enabled or disabled at any time.

Learn more about Rules →

Conditions​

A condition is the "IF" part of your rule. It defines which members the rule applies to based on their current roles.

Conditions can be simple:

"If the member has the Verified role"

Or more complex:

"If the member has at least 3 roles from [Bronze, Silver, Gold, Platinum]"

Learn more about Conditions →

Actions​

An action is the "THEN" part of your rule. It defines what happens when a member matches the condition.

Actions can either:

  • Add roles to the member
  • Remove roles from the member

You can even do both in a single rule!

Learn more about Actions →

Role Hierarchy​

Discord's role hierarchy determines which roles a bot can manage. RoleLogic can only add or remove roles that are positioned below its own role in your server settings.

Learn more about Role Hierarchy →

Quotas​

Quotas are limits on how many rules and roles you can use. Free accounts have generous limits, while premium plans offer more capacity for larger servers.

Learn more about Quotas →

How It All Connects​

Here's the flow of how RoleLogic processes your rules:

Member's roles change
        ↓
RoleLogic checks all enabled rules
        ↓
For each rule where the condition matches:
        ↓
    Execute the action (add/remove roles)
        ↓
Check rules again (changes might trigger more rules)
        ↓
Continue until no more rules match

This "cascading" behavior is powerful—one rule's action can trigger another rule, allowing for complex automation chains.

Key Principles​

Rules Run Continuously​

Your rules don't run just once. RoleLogic monitors your server 24/7 and reacts whenever any member's roles change, whether from you, another moderator, another bot, or Discord features like Server Boosting.

Order Matters (Priority)​

When multiple rules could apply to the same member, priority determines which runs first. Lower numbers run earlier (priority 0 runs before priority 1).

Rules Can Chain​

When Rule A adds a role, that change might cause Rule B to match. RoleLogic handles this automatically, processing rules in priority order until everything stabilizes.

Testing Is Your Friend​

The sandbox feature lets you test any combination of roles to see exactly what would happen—without affecting real members. Always test complex setups before going live.

What's Next?​

Start with Understanding Rules to learn how to create effective automation, then explore Conditions and Actions to unlock the full power of RoleLogic.