Set up your server
Six steps and about five minutes. Your server becomes a Node of the Song: its members are a crew, their progress carries into the game, and the crew shows up across Resonance. Free for every server.
1
Add the bot to your server
Use the button below. Discord asks which server to add it to and which permissions it gets: keep them all, they are what the setup needs (read and post in channels, embed links, add reactions, and Manage Roles for the milestone roles).
Adding it from Discord’s own Add App button works too, but pick Add to Server. Add to My Apps installs Resonance to your account instead: the slash commands show up, but the bot never joins the server.
Add the bot to Discord2
Check the bot is a member
Open your server’s member list and look for Resonance with the APP tag. If you can run its slash commands but it isn’t in the list, it was added to your account rather than the server. Add it again with the button above.
3
Run /setup node and pick the Signal channel
In any channel, type
/setup node. It opens a private setup panel only you can see. Its first step is the Signal channel: the channel where your crew’s moments, the live feed from across Resonance and new milestone rungs are posted.Pick a text or announcement channel. The bot needs to be able to see it and post in it, with embedded links.
4
Create the milestone roles
Press Create milestone roles. The bot makes one role for every rung of the milestone ladder, which is the same in every server. Members get each role automatically as they reach it by playing.
It needs Manage Roles, and Discord only lets it hand out roles below its own. In Server Settings → Roles, drag the Resonance role above the milestone roles, then press the button again.
5
Name your crew (optional)
Your crew shows up next to every member’s name across Resonance, and in the feed. By default it uses your server’s name. Press Rename crew on the panel to give it its own name, once a season (every 28 days). Use server name goes back at any time.
Names are 2 to 32 characters. Names that impersonate Resonance or a partner, copy another crew, or contain offensive words are turned down, and the panel says why. Your crew’s mark is your server icon: change it in Discord’s server settings.
6
Tell your members how to join in
Members count toward the crew once they have a Resonance account. They log in at play.rsnc.network and link their Discord in the app. Nothing is stored for anyone who hasn’t, and the bot tells them how to join in.
A member’s first server becomes their home crew.
/homeshows it or switches it (every 3 days), and/milestonesshows the ladder and their progress.
Running the server for a brand?
Do the steps above first. Then, in the partners portal, get a connect code and run /setup connect with it in the same server. Linked servers show your live event’s art in their panels, and your crew may use your brand’s name.
If something doesn’t work
The setup panel says what’s wrong in plain words. Here is what each message means.
- “Add the bot to this server first”
- The bot can run commands but isn’t a member of the server. Use the button on that message (or the one on this page) and pick your server.
- “The bot needs the Manage Roles permission”
- In Server Settings → Roles → Resonance, turn on Manage Roles, then press Create milestone roles again.
- “Drag the Resonance role above the milestone roles”
- Discord only lets a bot give out roles below its own. In Server Settings → Roles, drag Resonance above the rung roles, then press the button again.
- “… already exist here with permissions”
- A role with the same name as a rung already exists and grants permissions, so the bot won’t hand it out to everyone. Remove its permissions or rename it, then press the button again.
- The Signal channel gets nothing
- Check the bot can see that channel and has Send Messages and Embed Links there. Moments arrive as they happen in the game, so a quiet hour can pass without a post.
- “You need Full Admin”
- Setup is for server admins. Anyone with Manage Server counts, or an admin can grant a role with /config admin-roles.
Still stuck? Ask in the Resonance Discord.