📎Setup Guide

Useful guide in setting up our bot.

Part 1 - Creating a discord bot application

  1. Click the "New Application" button at the top right

  2. Proceed by entering the name of your bot

  3. You should now have created an application, assuming you've been forwarded to the app page (if not click you're bot app).

  4. Navigate to the sidebar and click "Bot".

  5. Under "Authorization Flow" disable "Public Bot" - you don't want anyone to be able to invite your bot to their discord server.

  6. Under "Privileged Gateway Intents" enable: a) PRESENCE INTENT b) SERVER MEMBERS INTENT c) MESSAGE CONTENT INTENT

🎊 Well done! You've now completed the first part of setting up the bot!

Part 2 - Inviting the bot

  1. Using the link below replace the "INSERT_CLIENT_ID_HERE" part with the "Application ID" which we asked for you to save in Part 1. https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=8

  2. Go ahead and paste that link with your ID in the browser, click your discord server and follow the steps provided on that page.

🎊 Well done! Your discord bot should now have joined your discord server!

Part 3 - Choosing your host

You will need a Java 17+ environment.

Below we will explore 3 options of how to host the bot:

  1. Using a Host/VPS/Dedi (recommended) We highly recommend using a host as this will ensure your bot will be online 24/7. There are many hosts out there, we recommend using https://billing.sparkedhost.com/aff.php?aff=2015 as they have reliable bot hosting for as low as $1 monthly (I suggest upgrading if you are using the music module as it uses more cpu power).

  2. On a BungeeCord server (use bot jar, not launcher) If you have a bungeecord server and it's running Java 17+ you are able to add the provided jar file in the server's plugin folder. (You will not be able to use the interactive console unlike the other two options)

  3. Self-Hosted (not recommended) You'll need to ensure you have Java 17 installed, and ensure you are using it's environment. When you're computer is offline, the bot will be offline.

🎉 By now you should have somewhere to host our bot.

Part 4 - Hosting our bot

  1. Using a host (recommended) Change your startup parameter to java -jar <jarname>.jar (e.g. java -jar bot.jar) Ensure you are on a Java 17+ environment. Now start the host!

  2. On a BungeeCord server Assuming you've already dragged the bot jar file into the plugin folder, simply restart your bungeecord server. (Bot folder located in the same area as the bot jar, not in the plugin folder)

  3. Self-Hosted (not recommended) Open up terminal / console. Ensure you are on a Java 17+ environment, type java --version to check. Type the command java -jar <jarname>.jar (e.g. java -jar bot.jar) and click enter.

It should have created a folder called "bot", navigate into that folder. You will see all the configuration files which you can explore and edit. (Restarting the bot, or using /reload in discord is required to apply changes)

Open "config.yml":

  1. Fill "license" with your license key generated within our discord.

  2. Fill "bot-token" with the token you saved in Part 1.

Fill free to navigate the rest of the config and make the appropriate changes, make sure to save!

Start/Restart the bot to apply the changes.

🎉 By this stage, your bot should be in your discord and online, type /help (<- via slash command) in your discord to navigate its commands!

Part 5 - Adding modules

In our discord there will be some free modules, to load them navigate to the bot folder, within the bot folder there will be a "modules" folder. Within that upload the module jar files, and then proceed to restart, after the restart the modules should be loaded and would have created a configuration file.

Creating your own module

You are able to create your own module in a Java 17+ environment, use our ExampleModule template https://github.com/Mantic-Development/ExampleBotModule (API jar is within the project)

Last updated