hubot-discord-ng/README.md

Hubot adapter for discord

# A [Hubot](https://github.com/github/hubot) adapter for [Discord](https://discordapp.com/)

Forked from [thetimpanist](https://github.com/thetimpanist) and merging changes by [aliasfalse](https://github.com/aliasfalse)

## Installation instructions

    npm install -g yo generator-hubot hubot-discord
    mkdir mybot
    cd mybot
    yo hubot

## Configuring variables on *nix
You will need to create a Discord account for your hubot and then invite the bot
to the channels you wish it to be present in

    % export HUBOT_DISCORD_TOKEN="..."
    % export HUBOT_MAX_MESSAGE_LENGTH="2000"

Environment Variable | Description | Example
--- | --- | ---
`HUBOT_DISCORD_EMAIL` | email for your discord hubot | `hubot@example.org`
`HUBOT_DISCORD_PASSWORD`  | password for your discord hubot | `password`
`HUBOT_DISCORD_TOKEN` | bot token for your oauth hubot | `MMMMMMMM`
`HUBOT_MAX_MESSAGE_LENGTH` | maximum message length to send at once | `2000`
`HUBOT_DISCORD_STATUS_MSG` | Status message to set for "currently playing game" | `/help for help`

The OAuth token can be created for an existing bot by [following this guide](https://github.com/DoNotSpamPls/repository/wiki/How-to-convert-your-bot-account-in-the-API).

## Launching your hubot

    cd /path/to/mybot
    ./bin/hubot -a discord

## Communicating with hubot
The default behavior of the bot is to respond to its account name in Discord

    botname help