Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/sanquinary/discord-active-developer-badge-forever

A Discord bot that automatically sends a command monthly to maintain the Discord Active Developer Badge without manual intervention. Quick 5-minute setup, no server or programming required!
https://github.com/sanquinary/discord-active-developer-badge-forever

active-dev-badge active-developer-badge discord discord-active-badge discord-active-dev-badge discord-active-developer discord-active-developer-badge discord-bot discord-developer-badge discord-js discordbot discordjs

Last synced: 4 months ago
JSON representation

A Discord bot that automatically sends a command monthly to maintain the Discord Active Developer Badge without manual intervention. Quick 5-minute setup, no server or programming required!

Awesome Lists containing this project

README 

        
# Discord Active Developer Badge Forever



![Node.js](https://img.shields.io/badge/node.js-339933?style=flat&logo=node.js&logoColor=white)

![License](https://img.shields.io/github/license/Sanquinary/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



- [x] **Easy Setup**: Interactive setup script for configuration.

- [x] **Input Validation**: Ensures correct configuration during setup.

- [x] **Scheduled Command**: Automatically sends a scheduled command in a specified channel monthly, weekly, daily or custom. ([cron](https://crontab.guru/))

- [x] **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](https://discord.com/developers/applications)

    - Click `New Application` found in the top-right

2. A Bot for the [Discord Developer Application](https://discord.com/developers/applications)

    - 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](https://support.discord.com/hc/en-us/articles/360047132851-Enabling-Your-Community-Server)



For local hosting (optional):

- [git](https://git-scm.com/downloads)

- [Node.js](https://nodejs.org/) (v16.6.0 or higher)

- [npm](https://www.npmjs.com/)



Decide if you would like to run the bot [locally](#remote-hosting-on-replit-option-1) or [remotely](#remote-hosting-on-replit-option-1).



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: [![Run on Repl.it](https://replit.com/badge/github/Sanquinary/discord-active-developer-badge-forever)](https://replit.com/new/github/Sanquinary/discord-active-developer-badge-forever)

   - 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](#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](#retrieving-the-badge)**



### Local Hosting (Option 2)



   Steps for Local Hosting



1. **Clone the repository:**



   [Download](https://github.com/Sanquinary/discord-active-developer-badge-forever/archive/refs/heads/main.zip) the repository directly or open your terminal in your desired folder, copy/paste and execute the following:

    ```sh

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

    cd discord-active-developer-badge-forever

    ```



3. **Install dependencies:**

    ```sh

    npm install

    ```



4. **Start the bot:**



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

    ```sh

    node index.js

    ```



6. **(Optional) Start the bot with [PM2](https://pm2.keymetrics.io/):**

    ```sh

    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](https://discord.com/developers/applications) -> YOUR_APPLICATION -> Bot Tab -> Reset Token -> `Copy this token`



2. **Bot Client ID**:

   - Go to: [Applications](https://discord.com/developers/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](https://support-dev.discord.com/hc/en-us/articles/10113997751447-Active-Developer-Badge) for the Active Developer Badge



Wait at least 24 hours and check this page: [Active Developer Badge](https://discord.com/developers/active-developer) to claim your badge.



![Claim your badge](https://i.imgur.com/DM4Hvie.png)



## 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.