📬Setup Guide
Useful guide in setting up our bot.
Last updated
Useful guide in setting up our bot.
Last updated
Click the "New Application" button at the top right
Proceed by entering the name of your bot
You should now have created an application, assuming you've been forwarded to the app page (if not click you're bot app).
You should now be in "General Information", note down the "Application ID" - we will need it to later to invite your discord bot to your server.
Navigate to the sidebar and click "Bot".
You should see a page like this, click "Reset Token", then save that token somewhere. Do not share your token!
Under "Authorization Flow" disable "Public Bot" - you don't want anyone to be able to invite your bot to their discord server.
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!
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
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!
You will need a Java 17+ environment.
Below we will explore 3 options of how to host the bot:
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).
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)
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.
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!
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)
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":
Fill "license" with your license key generated within our discord.
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!
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.
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)
