For the complete documentation index, see llms.txt. This page is also available as Markdown.

Invite Roles

The Invite Roles system rewards members with roles when they invite others to your server. It’s automatic, scalable, and encourages community growth.

Configure config/modules/invites.yml.

Basic Configuration

InviteRoles:
  Enabled: true
  Tiers:
    1:
      Roles: ["ROLE_ID"]   # Example: Newbie Role
      Amount: 1            # Role unlocked at 1 invite
    2:
      Roles: ["ROLE_ID"]   # Example: Trusted Role
      Amount: 10           # Role unlocked at 10 invites

Replace each ROLE_ID with real role IDs from your server.

How It Works

  • The bot tracks new joins via Discord’s invite system.

  • When a user reaches the invite count of a tier, they get the corresponding role.

  • With InviteRoles.Stack: false, users keep only their highest qualifying tier. Set it to true to keep all earned tier roles.

Commands

  • /invites user → Check your own invites

  • /invites user user:@user → Check another user’s invites

  • /inviter user:@user → See who invited a user

Last updated