Skip to content
This repository has been archived by the owner. It is now read-only.
DEPRECATED - A Discord bot that does all the things. Here are some emojis πŸ”¨πŸš€
Branch: master
Clone or download
Latest commit dcbd318 Feb 12, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
locales New Crowdin translations (#32) Feb 11, 2019
src fix(tags): dont assume msg is present Feb 11, 2019
test fix: fix tests, dont autofetch language info Feb 2, 2019
.dockerignore Update README, move to @sentry/node for errors, remove sharder Jan 8, 2019
.editorconfig Add helpful links Oct 3, 2018
.env.example fix: reaction emojis with funky emojis like numbers Jan 19, 2019
.eslintignore feat: new command loader with better-er loading Jan 2, 2019
.gitignore fix: fix tests, dont autofetch language info Feb 2, 2019
Atlas.js fix: store atlas' profile in db to fix infractions Feb 7, 2019
Dockerfile hopefully probably fix some things Jan 11, 2019
LICENSE add deprecated notice Feb 12, 2019
crowdin.yml feat: use %locale% over %two_letters_code% so pirate english plays nice Jan 31, 2019
docker-compose.yml Replace mongoose with monk Jan 11, 2019
index.js fix: fix tests, dont autofetch language info Feb 2, 2019
lavalink.env Update README, move to @sentry/node for errors, remove sharder Jan 8, 2019
mongo.env Merge branch 'levels' Nov 30, 2018
package.json fix(tags): dont assume msg is present Feb 11, 2019
yarn.lock feat: move back to mongoose for db, better caching Jan 26, 2019


You won't get support, security patches, features or bug fixes if you choose to use this version. If you have questions, join us on Discord -



Yet another Discord bot that tries to do everything -

This is all the code that runs the bot portion of Atlas. The dashboard, API and other secret sauce will remain closed source for now. Contributions are welcome.


* Required for development. If you're self-hosting, you can skip these requirements.


Linux is recommended, but Docker means macOS, Windows and more or less anything that runs Docker will work. For development, anything that runs Node.js and Docker will work.


  1. Install Docker and docker-compose

  2. Clone this repo

    git clone
  3. Open a terminal in the cloned folder

  4. Copy .env.example to .env and fill in the required env variables. See below for what most do. Google is your friend.

  5. Start the bot with docker-compose up -d. If you did everything right, then congratulations - you now have your own instance of Atlas.


  1. Install Docker, docker-compose and Node.js

  2. Clone this repo

    git clone
  3. Open a terminal in the cloned folder

  4. Run npm install to install dependencies

  5. Copy .env.example to .env and replace any variables you would like. Setting NODE_ENV to development will enable extra features and help debugging things.

  6. Start Lavalink, Redis and Mongo via docker-compose up -d mongo lavalink redis

    If you are using docker-compose to host these services, you can leave the defaults in .env.example for those services and it should be gucci.

  7. Start the bot with npm run dev

  8. Start breaking things. Once you save a file change, the bot will restart with the changes. Do npm run start to start the bot without watching files.

Environment Variables

Name Description
PREFIXES A list of all prefixes the bot will listen for by default, split by commas. @mention will be replaced with the bot's mention.
DEFAULT_PREFIX The default prefix for Atlas to use. By default, this is "a!"
NODE_ENV The environment the bot is in, should be "production" or "development".
TOKEN The bot token to login with.
MONGO_URI A MongoDB Connection URI.
VERBOSE Whether or not to use verbose logging (e.g, logging commands) - you'll probably want this disabled in a production environment.
OWNER The bot's owner ID. For security, this should only be set to user ID's that already have direct access to the host server.
DEFAULT_LANG The default language to use for everything. Valid languages are in /locales
LAVALINK_NODES An array of Lavalink nodes. See example for more info.
GOOGLE_CX * A Google CX key for custom searches. Google is your friend.
GOOGLE_KEY * A Google key for custom searches. See above.
REDIS_HOST * The host for Redis.
REDIS_PASS * The password for the Redis server
REDIS_PORT * The port for the Redis server
DBL_KEY * A API Token, used to get information about other bots πŸ•΅
PATREON_KEY * Used to tell who is a patreon and who isn't.
LASTFM_KEY * Used to find related songs for autoplay.
SPOTIFY_CLIENT_ID * Used to hack spotify support into music.
DEBUG * A lot of packages come with debugging enabled via the "debug" variable. Set DEBUG=* to get debug messages from all the things.

* Optional, but some features may not work without them.

Development "Features"

The NODE_ENV environment variable must be set to development for these to work.

  • To run a filter without it being enabled, include Atlas:forceFilter:filter with whatever you want to test. E.g, Atlas:forceFilter:invites will the "invites" filter to execute even when it's action type is 0.

Disclaimer / Warning

If you're going to self-host Atlas, you won't get help with setting it up. We may refuse to support you with general issues. You are responsible if you break anything. Seriously, if you don't know what you're doing, just use the public instance.


You can’t perform that action at this time.