Live Roles

What Are Live Roles?

Live Roles automatically detect when members of your Discord server go live on Twitch and assign them a special role. When they stop streaming, the role is automatically removed.

Use Cases:

• Highlight members who are currently streaming
• Give streamers special permissions while live
• Create a "Currently Streaming" category in your member list
• Send notifications when community members go live

How It Works

1. Detection: Streamlinx monitors your server members' Discord presence
2. Twitch Connection: When a member with a connected Twitch account goes live, Discord updates their presence
3. Role Assignment: Streamlinx detects this and assigns the configured "live role"
4. Notification (optional): A notification is sent to a configured channel
5. Role Removal: When the member stops streaming, the role is automatically removed

Requirements:

• Member must have Twitch connected to their Discord account
• Member must be streaming on the connected Twitch channel
• Discord must be open (presence updates require Discord running)

Setting Up Live Roles

Live Roles are configured through the Web Portal.

Step 1: Access the Web Portal

/portal

Navigate to your server and click on "Live Roles" in the sidebar.

Step 2: Create a Live Role Configuration

1. Click "Add Live Role Configuration"
2. Select the Discord role to assign when members go live
3. Configure filter settings (optional)
4. Set up notifications (optional)
5. Click "Save"

Step 3: Enable the Configuration

Toggle the configuration to "Enabled" to start detecting live members.

Configuration Options

Live Role Selection

Choose which Discord role should be assigned to members when they go live.

Recommendations:

• Create a dedicated role like @Currently Streaming or @Live Now
• Position the role high in your role list if you want it to show prominently
• Give the role a distinctive color so live members stand out

Member Filters

Control which members are eligible for the live role using filters.

Whitelist Mode

Only members with a specific role can receive the live role.

Example Use Case:

• Only verified community streamers get the live role
• Create a @Verified Streamer role and set it as the whitelist

How to Configure:

1. Set Filter Mode to "Whitelist"
2. Select the required role from the dropdown
3. Only members with this role will be eligible

Blacklist Mode (Premium Only)

Members with a specific role are excluded from receiving the live role.

Example Use Case:

• Exclude moderators or staff from the live role
• Block certain members from being highlighted

How to Configure:

1. Set Filter Mode to "Blacklist"
2. Select the role to exclude
3. Members with this role will never receive the live role

Notification Settings

Optionally send a notification when a member goes live.

Notification Channel

Select a Discord channel to receive notifications when members go live.

Leave empty to disable notifications (role assignment still works).

Notification Template

Customize the notification message using variables:

Available Variables:

• {member} - The Discord member's display name
• {username} - The member's Discord username
• {role} - The live role being assigned
• {twitch_username} - The member's Twitch username
• {twitch_url} - Direct link to their Twitch stream

Example Template:

{member} just went live on Twitch!
Watch at {twitch_url}

Tier Limits

Why Multiple Configurations?

Premium users can create multiple live role setups:

• Different roles for different member tiers
• Separate configurations for different games/categories
• VIP streamers get a special role, regular members get a standard one

Best Practices

Create a Distinctive Role

Use Whitelist for Verified Streamers

If you only want community streamers (not random members) to get the live role:

1. Create a @Community Streamer role
2. Manually assign it to verified streamers
3. Set this role as the whitelist filter
4. Only verified streamers will get the live role

Combine with Notification Channels

Create a dedicated channel for member streams:

1. Create #member-streams channel
2. Configure live role notifications to post there
3. Members can follow the channel to get notified
4. Use the template to include the Twitch link

Troubleshooting

Role Not Being Assigned

Check These:

1. Twitch Connected: Member must have Twitch linked to their Discord account

   • Discord User Settings → Connections → Twitch

2. Bot Role Position: Streamlinx bot role must be above the live role

   • Server Settings → Roles → Drag Streamlinx higher

3. Configuration Enabled: Make sure the live role config is toggled on

   • Check in Web Portal → Live Roles

4. Filter Passed: If using whitelist, member must have the required role

   • Verify member has the whitelist role

5. Discord Presence: Member must have Discord open for presence updates

   • Streaming with Discord closed won't trigger detection

Role Not Being Removed

Possible Causes:

• Discord presence hasn't updated yet (wait 1-2 minutes)
• Member is still streaming
• Bot restarted during stream (manual removal may be needed)

Solution:

• Wait a few minutes after stream ends
• Manually remove the role if needed
• Check bot status in support Discord

Notifications Not Sending

Check These:

1. Notification channel is set
2. Bot has "Send Messages" permission in channel
3. Notification template is valid (not empty)
4. Configuration is enabled

Wrong Members Getting the Role

If unexpected members are getting the live role:

1. Enable whitelist filter
2. Create a dedicated role for eligible members
3. Only assign that role to members you want to have the live role

Frequently Asked Questions

Does this work with YouTube?

No, Live Roles only work with Twitch. YouTube doesn't provide the same Discord integration for live stream detection.

Do members need to do anything?

Members need to:

1. Connect their Twitch account to Discord (User Settings → Connections)
2. Have Discord running while streaming
3. Have the whitelist role (if whitelist filter is enabled)

Can I have different roles for different streamers?

With Premium, you can create up to 5 different live role configurations. Each can use a different role and different filter settings.

Will this work for all Twitch streamers?

Only members of your Discord server who have connected their Twitch account. This doesn't track external streamers - use the regular streamer tracking for that.

How quickly is the role assigned?

Role assignment typically happens within 30-60 seconds of the member going live. Detection depends on Discord updating the member's presence status.

Can I use this with streamer tracking?

Yes! Live Roles and streamer tracking are separate features:

• Live Roles: For members of your server who stream
• Streamer Tracking: For any Twitch/YouTube channels (don't need to be in your server)

You can use both together.

Live Roles vs Streamer Tracking

Use Both Together:

• Track your favorite streamers with streamer tracking
• Highlight community members with live roles
• Different notification channels for each

Need Help?