First Time Setup

Use this checklist to get the bot online from a fresh install.

1

Step 1: Setting Up Your Bot

1.1 Obtain Your Bot Token

1. Visit the Discord Developer Portal.

2. Click New Application and give it a name.

3. Go to the Installation tab:

• Uncheck User Install

• Set Install Link to None

1. Navigate to the Bot tab:

• Click Add Bot

• Under Privileged Gateway Intents, enable:

  • PRESENCE INTENT

  • SERVER MEMBERS INTENT

  • MESSAGE CONTENT INTENT

• Under Public Bot settings:

  • Disable Public Bot

  • Uncheck Require OAuth2 Code Grant

• Click Save Changes

• Copy your Bot Token from the Token section

Note: All of these options are found under the Bot tab.

Keep your bot token private. Treat it like a password.

2

Get Your License Key

Join our Discord Server and navigate to the ✅┃verify-purchase channel to verify your purchase and receive your license key.

3

Step 2: Configuring Your Bot

Update your bot’s configuration file core.yml with the following parameters:

core.yml

Version: "1.8.6"
BotToken: "YOUR_BOT_TOKEN"
LicenseKey: "YOUR_LICENSE_KEY"
MongoURI: "YOUR_MONGO_URI"
GuildID: "YOUR_GUILD_ID"
BotName: "Aegis Bot"
LogCommands: true
Statistics: true
Timezone: "America/New_York"

How to Find Your Guild ID

1. In Discord, go to User Settings > Advanced

2. Enable Developer Mode

3. Right-click your server name in the sidebar

4. Click Copy Server ID

Paste this value into the GuildID field in your config.

4

Step 3: Setting Up MongoDB

Aegis Bot uses MongoDB for data storage.

Follow the steps in the MongoDB Setup Guide to:

• Create a MongoDB Atlas account

• Set up a new cluster and database

• Obtain your connection string (MongoURI)

Important: Do not skip this step! It is required.

5

Step 4: Installing Node.js

Download and install Node.js v21.7.3:

Download Node.js v21.7.3

Follow the installation prompts to complete the setup.

Note: Use our Pterodactyl Setup Guide if you aren’t hosting locally.

6

Step 5: Inviting Your Bot

1. In the Discord Developer Portal, go to OAuth2 > URL Generator

2. Under Scopes, select:

• bot

• applications.commands

1. Under Bot Permissions, select:

• Administrator

1. Copy the generated URL and open it in your browser

2. Select your server and authorize the bot

7

Step 6: Running Your Bot

6.1 Navigate to the Bot Directory

Open Command Prompt or Terminal and navigate to the folder where your bot files are located:

Command

cd path/to/your/bot

Video Tutorial: https://www.youtube.com/watch?v=neQUxiLPglg

6.2 Install Dependencies

Install required dependencies using npm:

Install dependencies

npm install

6.3 Start the Bot

Start your bot with:

Start bot

npm start

If npm isn't recognized, restart your terminal and try again.

Support and troubleshooting

If you hit issues during setup, join our support server and open a ticket.