Discord Active Developer Badge Forever

A simple Discord bot built with discord.js that automatically sends a scheduled command monthly to keep the Discord Active Developer Badge forever.

Discord removes Active Developer badges for inactive applications after 60 days. This project solves this issue for you so you never have to manually intervene or worry about losing the badge again!

Features

• Easy Setup: Interactive setup script for configuration.
• Input Validation: Ensures correct configuration during setup.
• Scheduled Command: Automatically sends a scheduled command in a specified channel monthly, weekly, daily or custom. (cron)
• Persistent Scheduling: Maintains the schedule even after stops or restarts.

Getting Started

Follow these steps to set up and run your own Discord Active Developer Badge bot in less than 5 minutes.

Prerequisites

1. A Discord Developer Application
   • Click New Application found in the top-right
2. A Bot for the Discord Developer Application
   • Click the Bot tab inside your Application
3. A Discord server and Discord account with server permissions to add and manage bots
   • Your Discord Server needs to be a Community Server

For local hosting (optional):

• git
• Node.js (v16.6.0 or higher)
• npm

Decide if you would like to run the bot locally or remotely.

Click one of the arrows below to reveal the steps.

---

Remote Hosting on Replit (Option 1)

Steps for Remote Hosting on Replit

1. Go to Replit
   • Import this repo by clicking this button:
   • You will need a Replit account. Sign up with Google/GitHub for quick registration.
2. Click the Run button
3. Answer the 5 prompts
   • Answer the 5 prompts in the console in the bottom-right.
   • Don't know the answers? No worries! Check the Interactive Configuration section.
4. You're done!
   • The bot should already have sent a command, if not use /ping
   • The schedule to maintain active status is logged in src/schedule.json.
5. Retrieving the Badge

Local Hosting (Option 2)

Steps for Local Hosting

1. Clone the repository:

   Download the repository directly or open your terminal in your desired folder, copy/paste and execute the following:

   git clone https://github.com/Sanquinary/discord-active-developer-badge-forever.git
   cd discord-active-developer-badge-forever

2. Install dependencies:

   npm install

3. Start the bot:

   Run start-app.bat or start-app.sh or execute from your terminal:

   node index.js

4. (Optional) Start the bot with PM2:

   npm install pm2 -g
   pm2 start index.js --name "discord-bot"
   pm2 save
   pm2 startup

---

Interactive Configuration

When you run the project for the first time, you will be prompted to provide the following:

1. Bot Secret Token:

   • Go to: Applications -> YOUR_APPLICATION -> Bot Tab -> Reset Token -> Copy this token

2. Bot Client ID:

   • Go to: Applications -> YOUR_APPLICATION -> Application ID -> Copy this ID

3. Discord Server (Guild) ID:

   • Open Discord -> Navigate to your server -> Right-click the server name -> Copy Server ID
   • If Copy Server ID doesn't show, enable Developer Mode in Settings -> Appearance -> Developer Mode

4. Discord Channel ID:

   • Open Discord -> Navigate to your server -> Right-click the desired text channel -> Copy Channel ID

5. Choose Schedule:

   • Choose between a monthly (recommended), weekly, daily or custom cron schedule.
   • The schedule will be stored and a command displaying your server stats will be executed on the schedule date.
   • The schedule automatically renews once it has passed.

---

Retrieving the Badge

To retrieve the badge:

• Make sure your bot have executed a command in your Discord Server after starting your bot in Replit with Run or with node index.js locally.
• Ensure you meet Discord's requirements for the Active Developer Badge

Wait at least 24 hours and check this page: Active Developer Badge to claim your badge.

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any changes.

License

This project is licensed under the MIT License. See the LICENSE file for details.