Note: If you do not have access to the server GUI, you can still use this quide, but will need to input the required values manually. Copy the config template file in the config folder of your server, name it "DiscordLink.eco" and fill in the values directly in the file. Documentation for doing this can be found in the configuration guide.
If you encounter problems, remember that Discordlink has troubleshooting commands and that you can get support in the Eco Modding Discord, just scroll down to the DiscordLink section and post in the help channel!
1. Download and install EM Framework from eco.mod.io. This is a required dependency for DiscordLink.
2. Download the latest DiscordLink release .zip file from Github or eco.mod.io.
3. Go to your server's main folder (The one with the .exe), extract the .zip there. Do NOT unzip into a separate folder.
5. When the server has loaded, navigate to the DiscordLink configuration tab. You'll see a configuration box labelled "BotToken". We need to go create one.
If you are not using the server GUI, you instead need to fill out this field in the "DiscordLink.eco" config file.
6. Navigate to https://discordapp.com/developers/applications/me. Login to Discord and click "New Application".
7. Name your bot appropriately (this will be the bot's name on your Discord server). Note that the name may not contain the word "Discord".
10. This section will now contain the token we need. Click the copy button to get the token into your clipboard.
12. Enter the ID of your Discord server into the "Discord Server ID" field. To get this ID, right click your server in Discord and select "Copy ID" and it will be copied to your clipboard.
14. Navigate back to the bot's page and the "General Information" tab on the Discord website (see above). Copy the "Application ID" - you will need it in the next section.
15. Before you leave the bot's page, enable the "Server Members Intent" and "Message Content Intent" for your bot.
- The Server members intent allows DiscordLink to search for users in your Discord server when trying to link an Eco account to a Discord account.
- The Message Content Intent is needed for DiscordLink to read chat messages.
16. Go to https://discordapi.com/permissions.html#268659776. Paste the Application ID in the bottom left field labelled "Client ID", and add any extra permissions you want the bot to have. Click the link at the bottom.
Offline
Online
19. Set up a Chat Channel Link. If you do not have access to the server GUI, use this guide instead.
20. Verify that the config is correct by running the VerifyConfig command or by selecting it in the DiscordLink dropdown in the server GUI.
21. Make sure that the bot has the required permissions by running the VerifyPermissions command or by selecting it in the DiscordLink dropdown in the server GUI.
22. Run the "Echo" command in the Discord channel specified in the Chat Channel Link to see that it is properly sending message to Eco and receiving messages back.
Echo command
Discord server GUI chat display showing that the message reached the Eco server.
Crosspost back to Discord showing that DiscordLink caught the message and forwarded it as configured in the Chat Channel Link cofiguration.
