# 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.


Votando por Response Bot

¿Quieres apoyarnos?