Reward members for repping your server
Give a perk role to everyone whose custom status mentions your server, and take it back when they change it.
- About 3 minutes
- In Discord and on the dashboard
- 5 steps
Before you start
- Administrator
- A role to give, below Element's own role
Decide what to look for
Pick the text members should put in their custom status, like your invite .gg/element or your server's name.
Matching ignores capital letters. Text that starts or ends with a letter or number matches whole words only, so cat won't match "education", while text like .gg/element matches anywhere, even inside a link.
Create a panel on the dashboard
Open Status role and click New panel. Name it, add the statuses to match (press Enter after each), and pick up to 10 roles to give.
Type a status into Try a status to check what would match before you save.
New panel
Only you and other admins see this. It can't be changed later.
A member matches when their custom status contains any of these, in any case.
Create a panel with commands
Run /statusrole add with a panel name, the role, and the statuses. Put a status with spaces in quotes.
/statusrole addrole adds more roles to the panel, up to 10, and /statusrole setstatuses replaces its statuses.
Commands matching /statusrole
/statusrole addCreate a new panel with one role and a list of statuses.ElementAPP- /statusrole settingsView the current StatusRole panels and settings for this server.ElementAPP
Soften it with a grace period
Element only sees the status of members who are online, so without a grace period the role comes off when someone goes offline or invisible.
A grace period lets members keep the role for a while, from 1 hour to 7 days. Set it on the panel, or with /statusrole setgrace, like 2h30m.
Supporters
How long members keep the roles after their status stops matching or they go offline.
Element posts here when it gives or takes these roles.
Reward your server tag too
Members can wear a server's tag next to their name. The Server tag role gives one role to everyone wearing yours, with its own log channel.
Set it at the top of the Status role page, or with /statusrole tag and the role.
Server tag role
Give a role to everyone who wears this server's tag next to their name.
Clearing the role turns this off.
Check everyone now
Element updates members as their statuses change. To check everyone at once, after creating a panel or changing its statuses, run /statusrole forcecheck.
Commands matching /statusrole forcecheck
- /statusrole forcecheckForce a manual evaluation of status panels, the clan tag, or both.ElementAPP
1/5 Decide what to look for