Installation & Setup Guide

First, we need to get the bot files onto your server.

1. Open your Pterodactyl Panel.
2. Navigate to the File Manager tab.
3. Upload the downloaded .zip file.
4. Click the three dots (⋮) next to the file and select Decompress / Unarchive.

/home/container
├── attachments/
├── backups/
├── bot/
├── dashboard/
├── database/
├── locales/
├── utils/
├── .env
├── jest.config.js
├── main.js
└── package.json

Open the .env file in the File Manager. Replace values with your real credentials.

BOT_TOKEN=YOUR_DISCORD_BOT_TOKEN
CLIENT_ID=YOUR_CLIENT_ID
CLIENT_SECRET=YOUR_CLIENT_SECRET
CALLBACK_URL=http://YOUR_SERVER_IP:PORT/auth/callback
BASE_URL=YOUR_SERVER_IP:PORT
SESSION_SECRET=RANDOM_SECRET_STRING

BOT_TOKEN=YOUR_DISCORD_BOT_TOKEN
CLIENT_ID=YOUR_CLIENT_ID
CLIENT_SECRET=YOUR_CLIENT_SECRET
CALLBACK_URL=https://your-domain.com:80/auth/callback
BASE_URL=https://your-domain.com:80
SESSION_SECRET=RANDOM_SECRET_STRING

To ensure the dashboard works on Pterodactyl, we need to bind the port dynamically. You need to change the default port to the one assigned by your server.

1. Open the file main.js.
2. Scroll to line 66 (or search for const PORT).
3. Replace that line completely with the code below:

const PORT = process.env.PORT || 3000;

For the login system to work, Discord needs to know your website address.

1. Go to the Discord Developer Portal.
2. Open your Application.
3. Navigate to the OAuth2 tab.
4. Under Redirects, add the following URL:

http://YOUR_SERVER_IP:PORT/auth/callback

https://your-domain.com:80/auth/callback

You are ready to launch!

1. Return to your Pterodactyl Panel.
2. Open the Console tab.
3. Click the Start button.

If configured correctly, the console will show that the bot has logged in and the server is running.

Once the bot is running, you can access the management dashboard here:

http://YOUR_SERVER_IP:PORT

https://your-domain.com:80

Double-check that the PORT is the same in these 3 places:

• Your .env file
• The Pterodactyl Network tab (Allocation)
• The Discord Developer Portal OAuth2 Redirects