Interested in learning how to use Max? See the Usage documentation here.

• Git
• Node JS
• MariaDB

git clone git@github.com:reactivepixel/Max-Bot.git

Create an .env file with the following sensitive information. Replace the "xxx"'s with some unique information for your local Environment.

!verify will not work unless you additionally configure your own Gmail account to work with this bot. The Official Max email info will not be distributed.

NODE_ENV=development
DEBUG_MODE=3

DISCORD_BOT_TOKEN=xxx_bot_token_from_next_step_xxx

MYSQL_ROOT_PASSWORD=xxx
MYSQL_USER=xxx
MYSQL_PASS=xxx
MYSQL_DATABASE=max
MYSQL_HOST=localhost

EMAIL_USERNAME=xxx
EMAIL_PASS=xxx
GOOGLE_APP_PASSWORD=xxx

Update DISCORD_BOT_TOKEN with the token you receive from the next step.

Add a new App and create a Bot User then obtain the Discord App Bot Token from the created Bot User or contact a Release Manager for Max's Dev Bot token.

Update the DISCORD_BOT_TOKEN in the .env file with the token provided to you.

Run $ gulp pm2 to create a max.config.js file within your root directory.

As an authorized user of the bot you will need to add it to a server.

1. Go to the Discord developer pages (login if you haven't).
2. Go to the application with the bot you want to add to your channel.
3. Copy the Client/Application ID.
4. Go to https://discordapp.com/oauth2/authorize?client_id=```CLIENT_ID_GOES_HERE```&scope=bot&permissions=0
5. Select server and click authorize.

Source

Max uses Nodemailer to send verification emails to users joining the Armada server. to work proper locally please follow these steps to create a new gmail account to locally test with:

1. Create a new gmail.com account
2. Once logged in with this account enable less secure application access.
3. fill in the EMAIL_USERNAME & EMAIL_PASS values on the .env file with this new gmail account's info.

npm install
npm start

The AirBnB javascript style guide has been put in place and will be enforced through active and passive linting.

Ensure your local IDE has the ability to add eslint plugins. Atom is recommended.

Source

Install the linter-eslint package for Atom.

apm install linter-eslint

Removing a semi-colon from any line of Javascript will trigger the linter to automatically flag the edited line.

Instead of console.log() require the tool.js file and call the .debug() method passing in three arguments (title, output, level)

[code] to call a debug() [code] to activate debug_mode

Should be a string that will prefix the output argument in the resulting console.log()

Any object that will be suffixed onto the title argument in the resulting console.log()

A number that indicates how fine grained the output of this particular output should be. Reference the Debug Level Chart

0. Production Environment Level Output
1. Staging Environment Level Output
2. General Debug Information for Development
3. Very Detailed and in-depth Output.
4. Highly Fine Grained Detailed and in-depth Output.