Live Role Diagnostics
WARNING
This document pertains to Live Role v3 and is a work-in-progress. Information may be incomplete, outdated, or otherwise incorrect. Use at your own risk!
The Live Role diagnostic tool is a powerful troubleshooting tool that can diagnose potential configuration errors with Live Role.
How to run Live Role Diagnostics
- Visit the Preview Dashboard
- Choose your server from the list.
- Click "Live Role".
- Click "Tools".
- Click "Run Diagnostics".
Interpreting Diagnostic Results
Fixing Potential Issues
The diagnostic result for each Live Role configuration contains a list of potential issues checked for.
"No members are eligible to receive the live role."
Either:
- Nobody in your server is live, or
- Everyone in your server who is live does not pass the filter rules.
This could be caused by one of two issues:
- Someone in your server is live, but Discord is not displaying their stream properly. Make sure that the member has the purple streaming status on Discord. If they don't, follow the Live Role Troubleshooting Guide.
- Your filter rules are too strict. Make sure no rules contradict (e.g. having a whitelist rule and a blacklist rule set to the same value) and that the rules accurately represent the streams you want to filter.
You can use the Live Role Event Logs to see how Streamcord behaves for each individual member in your server.
- If the member doesn't appear in the event logs at all, their stream is not being recognized by Discord, and you should follow option 1 above.
- If the member appears in the event logs, but it says "skipped adding ... to ... because they didn't meet the filter conditions", your filter rules are set up incorrectly, and you should follow option 2 above.
"... eligible members do not have the live role."
"... ineligible members have the live role."
Most likely, you recently made changes to your Live Role configuration and your members' statuses have not yet updated to reflect the new rules.
In this case, you should run the /liverole forceupdate command in your server.
"Streamcord does not have permission to manage roles."
Streamcord must have the Manage Roles permission for Live Role to work correctly.
In your Discord app, go to your Server Settings > Roles and give the Manage Roles or Administrator permission to any role that Streamcord has.
Learn more about permissions on Discord
"Streamcord's topmost role is not positioned above the live role."
Discord's permissions system prevents accounts (including bots like Streamcord) from adding and removing roles that are positioned above its highest role in the server hierarchy.
In your Discord app, go to your Server Settings > Roles and either:
- Reorder the live role below Streamcord's highest role, or
- Reorder Streamcord's highest role above the live role.
Learn more about permissions on Discord
If the diagnostic tool fails to run
If, when attempting to run diagnostics, you receive an error that starts with "An error occurred whilst running Live Role Diagnostics", refer to the listing below to determine its cause.
| Code | Explanation |
|---|---|
no_config | Live Role is not set up in your server. |
For any codes not listed here, please contact our support team.