Atlanta

This bot is used by more than 130,000 Discord users and more than 800 servers.

Atlanta is an open source Discord bot coded in TypeScript with Discord.js and Mongoose by Androz2091.
Feel free to add a star ⭐ to the repository to promote the project!

What's new in v5

Atlanta v5 is a ground-up rewrite of the original JavaScript codebase (which I started when I was 13!):

• 🔷 Entire codebase rewritten from JavaScript to TypeScript
• ⚡ All commands migrated to slash commands via discord-sync-commands
• 📦 Modern dependencies: Discord.js v14, Mongoose 8, discord-player v6, i18next v24, dayjs
• 🔒 Configuration moved from config.js to .env encrypted with dotenvx
• 🐳 Docker support with multi-stage Dockerfile

Features

Complete Bot

Atlanta offers (non-exhaustive list):

• ⚡ All commands are Discord slash commands -- no prefix needed
• 🇫🇷 Support for translations (9 languages out of the box)
• ⚙️ Guild configuration (language, welcome/goodbye, autorole, automod, etc...)
• 😀 Commands made pleasant thanks to the many emojis
• 🗳️ Support for top.gg votes with rewards

Many commands

Atlanta has a lot of features, with 8 main categories and 96 slash commands:

• 👩‍💼 Administration (17): welcome, goodbye, autorole, automod, backup, setlang, slowmode and 10 more!
• 🚓 Moderation (14): ban, kick, mute, warn, clear, giveaway, sanctions and 7 more!
• 🎵 Music (13): play, skip, queue, np, lyrics, filter, autoplay and 6 more!
• 💰 Economy (15): profile, work, slots, rob, leaderboard, marry, achievements and 8 more!
• 👻 Fun (8): 8ball, ascii, flip, lovecalc, findwords, number and 2 more!
• 🖨️ General (20): help, serverinfo, userinfo, translate, remindme, minecraft and 14 more!
• 🖼️ Images (6): avatar, qrcode, love, facepalm, captcha, clyde
• 👑 Owner (3): eval, reload, servers-list

A powerful Dashboard

Atlanta has its own dashboard which also offers many features! The dashboard runs with Express and EJS!

You can directly edit your configuration, manage your servers, view rankings, modify your profile and much more!

Find the code in the dashboard folder!

Installation

Prerequisites

• Node.js v22 or later
• MongoDB instance
• Yarn package manager
• A Discord application with a bot token

Setup

1. Clone the repository and install dependencies:

git clone https://github.com/Androz2091/AtlantaBot.git
cd AtlantaBot
yarn install

2. Fill the .env with your values:

At minimum, set your bot token, MongoDB URI, and owner ID in .env.

3. (Optional) Encrypt your config with dotenvx:

brew install dotenvx/brew/dotenvx
dotenvx encrypt

4. Build and start:

yarn build
yarn start

For development with hot reload, use yarn dev instead.

Docker

A Dockerfile is included for containerized deployments:

docker build -t atlantabot .
docker run -d --env-file .env atlantabot

Links

• Discord
• Github
• Patreon

Contributing

Before creating an issue, please ensure that it hasn't already been reported/suggested.
And if you have a question, please ask it in the Discord server instead of opening an issue. If you wish to contribute to the Atlanta codebase or documentation, feel free to fork the repository and submit a pull request!

License

Atlanta is licensed under the GPL 3.0 license. See the file LICENSE for more information. If you plan to use any part of this source code in your own bot, I would be grateful if you would include some form of credit somewhere.