# Custom Response Bot (INACTIVE)

A programmable response bot, which can be set to respond to messages in any way you like.

Make sure to give him a nickname when you invite him!

# NOT ACTIVE ANYMORE

## Donations

I pay a monthly fee to host my bots for everyone to use for free. Please consider making a one-time donation 😊 Send to `titusharda@gmail.com` on Paypal

Any amount is appreciated, $1 is fine too!

## Uses

* This can be used for **fun/memes**, so you can create a custom bot for your server which responds in any way you want it to.
* It can also be used for **help/support**, so you can make the bot respond with help messages, when users post certain queries.

# Documentation

## Creating a Response

By saying `rbot`:

```rbot when I say "cats are cute", you say "definitely!"```

By pinging the bot:

```@rbot when I say "dogs are nice", you say "for sure!"```

("Quotes" are optional, as is the comma)

Now whenever any member posts "cats are cute", the bot will respond with "definitely!".
You can also make it respond with links. Multi-line text is accepted too!

## Say vs. Mention (IMPORTANT!)

### Say
When you use `say`, the response is only applied to messages that are exactly equal to the trigger.

```rbot when I say "bob", you say "yes"```
    
This way, the bot will only respond to messages that are exactly "bob". It will not detect "bob" mentioned within a longer message.

### Mention
When you use `mention`, the response is applied to messages that contain the trigger.

```rbot when I mention "bob", you say "yes"```

This way, the bot will respond to all messages containing bob (so it will respond to "hi bob", because it includes the trigger).

## Multiple Responses

Whenever you create a response, it's added to a list of responses for the trigger.

Example:

```rbot when I say apple, you say mango```

```rbot when I say apple, you say banana```

When you say "apple", the bot will now respond with either "mango" or "banana", at random! You can add as many replies as you like.

## Deleting a Response

This will clear all responses for the trigger "apple", assuming it was a `say`:

	```rbot when I say "apple", don't say anything```

If the original trigger was a `mention`, then you have to specify that:

	```rbot when I mention "apple", don't say anything```

## Checking Responses

Write `rbot show responses` to see a list of all your triggers and their responses. It also specifies whether a trigger is a 'say' or a 'mention'.

## Who Can Edit?

By default, everyone in your server will be able to edit the bot.

You can ask rbot to allow only certain roles to edit responses:

	```rbot allow only @Role1 @Role2 @Role3```
    
Now, only these three roles will be able to add/remove responses from the bot (in addition to users that have the Manage Server permission).

**Note**: Only users with the Manage Server permission can use this command.

## Resetting Roles

If you want to allow everyone to edit the bot again, you can ask rbot to do that too:

	```rbot allow all```

**Note**: Only users with the Manage Server permission can use this command.

## Deleting all data (WARNING: IRREVERSIBLE)

If you want to delete all Response Bot data for your server, you can ask rbot to do so:

	```rbot delete all data```

He will ask for confirmation, make sure to mention him when you give that confirmation.

**Note**: Only users with the Manage Server permission can use this command.

## Reactions

The bot reacts with 👍 when it accepts a command.

The bot reacts with 👎 when a command fails. You may get it if:
* Your new trigger-response pair already exists
* A trigger you're trying to remove, does not exist

# FAQ

### I don't want the bot responding in certain channels!

Give the bot a role, and make sure that role cannot read/write to certain channels.
The bot will not be able to access those channels, as long as it has the restricting role.


Voting for Response Bot

Do you want to support us?