First Time Setup

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

    • Untick 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.

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)

Follow the guide here

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: You can use our Pterodactyl Guide if you aren't hosting it 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 run into any issues during setup, join our Support Server and open a ticket. We're happy to help.

Next: How to Update

Last updated 11 days ago

PreviousWelcome & LeaveNextlegal

Last updated