Installation

Clone codumpus

Now let the real fun begin! In the terminal of your VS Code you run the powershell command to clone the codumpus repository and install it.

CMD	git clone https://github.com/codump/codumpus . && npm install
PowerShell for VS Code	git clone https://github.com/codump/codumpus . ; npm install

The complete repository will now be copied to your local(PC) and installed.

Config.json

Rename empty-config.json to config.json and open the file, fill in the fields with the correct details. More details and guidance about these fields further down the guide when they become relevant.

{
 "masterUid": "Discord user ID of the master account.",
 "masterGuild": "Discord guild ID of the master guild.", 
 "botClientId": "Discord bot ID / Application ID.",
 "botToken": "Discord bot token.",
 "botServerId": "Bot-Hosting.net server ID.",
 "botServerApiKey": "Bot-Hosting.net server API key."
}

Tip

For VS Code: Also open the index.js file, this is the main file that will make your bot start and keeps running. It will be opened in a new tab, right click this tab select split & move and then split down. You can store these kind of changes for VS Code in a workspace. Simply click file in the top left corner and then save workspace as. You can always restore these preferences by opening the workspace file in VS Code.

Creating the discord bot

1. Open Discord developer portal and create a new application.
2. Get your Application ID from the general information tab and fill it in the botClientId field in the config.json.
3. Go to the bot tab and press the reset token button. Enter this token into the botToken field in the config.
4. Open the OAuth2 tab and create an invite link via the OAuth2 URL Generator, confirm the Bot field under scopes.
5. Give the bot permissions: will change during development.
6. Copy the link on the bottom of the page and use it to invite the bot to your master server.

Create a server on Bot-Hosting.net

1. Login on Bot-Hosting.net.
2. Earn or buy coins.
3. Create a server for Node.js, then click manage server.
4. Open the server: View on control panel (need to login again).
5. Select your server, it will take you to the console.
6. Check the URL to get your server ID. https://control.bot-hosting.net/server/YOURSERVERID
7. Fill in the server id in the field botServerId of the config.json.
8. Go to your account settings and then to API credentials.
9. Give a Description and leave the IP section blank, click create.
10. Save the API key in the botServerApiKey field in the config file.

Deploying commands

First, we need to restrict the /botserver Discord command so that no one else can access the Bot-Hosting.net API and shut down your server. To do this, obtain your Discord user ID (see this guide ) and add it to the masterUid field in the config file.

Next, limit the command to your own guild only. Retrieve your Discord guild ID using the same guide and enter it into the masterGuild field in the config.

Once these values are set, run the following command in your terminal: node deploy-master.js

After that, deploy the remaining commands by running: node deploy-commands.js

By default, all other commands are deployed globally. If you want to change this behavior, you will need to modify the logic in the deploy-commands.js file. Keep in mind that every time you add a new command, you must rerun the deployment script.

Run local and test

Start your bot with the command npm start in the terminal. And test if the slash command /code is working, Don't use the /botserver function yet! We gonna use that to restart your server and pull the code from GitHub.

Use GitHub to deploy to Bot-Hosting.net

Do it!