Discord Role Assignment
Discord role assignment is a Pro feature that assigns Discord roles from Replay Analyzer score results.
This feature uses the FN-Tools BOT, FN-Tools Link, and a FN-Tools Link token. Players whose Epic Games account is not linked to a Discord account through FN-Tools Link are skipped during execution.
Setup
- Invite the FN-Tools BOT to the target Discord server.
- Use FN-Tools Link to link your Discord account and Epic Games account.
- Use a FN-Tools Link token for the target Discord server from the FN-Tools Link dashboard.
- Analyze a replay in Replay Analyzer and create score results.
When a server appears
The Discord role assignment server selector shows only Discord servers that meet all of these conditions:
- The signed-in Discord account is a member
- The FN-Tools BOT is also a member
- A FN-Tools Link token is used for the server in the FN-Tools Link dashboard
This feature uses the Discord OAuth2 guilds scope.
After joining a server or inviting the BOT, use the Refresh button in the screen to update the list.
Requirements
| Target | Required state |
|---|---|
| Person using the FN-Tools Link token | Is on the Pro plan |
| Target server | Uses a FN-Tools Link token |
| Operator | Is in the target server |
| FN-Tools BOT | Is in the target server |
| Operator | Has Manage Roles permission or Administrator permission |
| FN-Tools BOT | Has Manage Roles permission or Administrator permission |
| Role to assign | Is below the operator’s highest role |
| Role to assign | Is below the FN-Tools BOT’s highest role |
| Role to assign | Is not a managed role |
FN-Tools excludes @everyone and managed roles from assignable role options.
How to run it
- Analyze the target replay in Replay Analyzer.
- Create score results in Score Totalling.
- Open Discord Role Assignment.
- Select the target server.
- Configure rank ranges and roles.
- Execute the assignment.
When executed, roles are assigned to players that match the configured rank ranges. If the same role would be assigned to the same user more than once, FN-Tools deduplicates it during execution.
Unlinked players
Players whose Discord account and Epic Games account are not linked through FN-Tools Link are skipped during Discord role assignment.
Use the FN-Tools Link Status tab in the Discord role assignment screen to check whether target players are linked.
If servers or roles do not appear
| Situation | What to check |
|---|---|
| Server is not shown | Both the operator and the FN-Tools BOT are in the server, and a FN-Tools Link token is in use |
| Role is not shown | Operator/BOT permissions, role position, and whether the role is managed |
| Player is skipped | The player is linked through FN-Tools Link, and the Discord user is in the target server |
If it still does not work after checking permissions, grant Administrator permission to the FN-Tools BOT.