Prerequisites
Before you begin, ensure your hosting environment has the following installed:- Java 17 or higher (Required for modern JDA versions).
- A database solution (MongoDB cluster, SQL database, or local storage access for JSON).
- A Discord Bot Token (obtained from the Discord Developer Portal).
Deployment Steps
1
Discord Application Setup
- Go to the Discord Developer Portal and create a New Application.
- Navigate to the Bot tab and click Add Bot.
- Critical: Select Bot and scroll down to Privileged Gateway Intents and enable:
Server Members Intent(Needed for checking roles).Message Content Intent(Needed for FAQ keyword detection).
- Save your changes and copy your Bot Token. Keep this secret!
- Invite the bot to your server by going to OAuth2 and scroll down to the OAuth2 URL Generator. Make sure you check both
botandapplications.commands(required for Slash Commands), checkAdministratorunder General Permissions and paste in the browser the URL that is provided under Generated URL.
2
Server Preparation
- Create a new folder on your host machine for the bot (for example,
TicketBot). - Download the latest release and place it inside the folder.
- Run the bot for the first time to generate the configuration files:
- The bot will automatically shut down and inform you that a
config.ymlhas been generated.
3
Configuration
- Open the newly generated
config.yml. - Paste your Bot Token and your personal Discord Owner ID.
- Configure your Database URI (if using MongoDB or SQL).
- Fill out your server-specific settings, including Role IDs, Channel IDs, and your Category configurations (refer to the Configuration Guide for details).
- Save the file.
4
Final Boot
Start the bot again using your preferred startup script, If configured correctly, the console will log a successful database connection and confirm that your Slash Commands have been registered globally.
screen, or Pterodactyl panel: