<h1>QuoteBot</h1>

QuoteBot is a Bot that helps you quoting full or partial messages on your server to follow up on something a user previously said.

<hr />
<h1>Commands:</h1>

<p><strong>Help:</strong> Use <code>!quotebothelp</code> to show the help information.</p>

<p><strong>Quote Emoji</strong> Use <code>!setquotebotprefix</code> and the Emoji you want to use to quote messages with reactions (for example: <code>!setquotebothelp 💬</code> would set the emoji to 💬). This also works for server and global emojies.
  
<p><strong>Enable/Disable Direct Quotes</strong> Use <code>!enabledirectquotes</code> or <code>!disabledirectquotes</code> to enable or disable Direct Quotes (see more about that below).

<hr />

<h3>Quote a complete Message</h3>

Use > as a prefix and the complete message to quote it (not case sensitive)

To quote "This is a test message":

<h6>Example: <code>> This is a test message</code></h6>

If you want to quote a complete message with a part of it, use >>. The latest message that contains your quote message is quoted.

To quote the message "This is a test message" with "test message", you would use: 

<h6>Example:<code>>> test message</code></h6>

You can also react with the emoji to quote a message (Default is 💬). You must have Send Messages privileges to quote a message.

<hr />
<h3>Quote parts of a message</h3>

If you only want to quote a part of the message, use >>> and the part of the message you want to quote. 

To quote "test" of the message "This is a test message", you would use: 

<h6>Example: <code>>>> test</code></h6>

You can also quote longer parts of a message by using a start and an end word (the first appearance is selected), using |-| as a delimiter. Please note that the search words are case sensitive.

To quote "This is a test" of the message "This is a test message", you would use: 
<h6>Example: <code>section> This |-| test*</code></h6>

<hr />
<h3>Quote message with ID</h3>

You can quote a message by using id> and the ID of the message you want to quote.

<h6>Example: <code>id> 589156106027270144</code></h6>

<hr />
<h3>Respond to messages</h3>
You can quote a message and respond with an answer - Quotebot will combine both messages and show you the quote and the answer. 

To respond to a quote, quote the message as described above and use r> and your answer to respond! :) 

If you want to respond to a message with "This is my answer", you would use: 

<h6><code>r> This is my answer</code></h6>

to answer to the latest quoted message. You have 60 seconds to respond to a quote. 

<h3>Direct Quotes</h3>

Sometimes, you want to respond to an answer without using a prefix when you type in your answer.

If you enable Direct Quoting (see <i>Commands</i> above), the next message you send after you quoted something is automatically used as the response!

For now, this only works when quoting with Reactions, other quote methods will be supported soon. 

If you enabled Direct Quotes and want to quote without adding a response, simply send <code>></code> to quote without a response.

<hr />
<h3>Information</h3>

Messages from Bots and Messages starting with one of our prefixes are ignored to prevent quoting failed quote attempts.

When quoting with reactions, a rate limit of 5 seconds or 10 messages since the last quote is enforced to prevent spamming channels over the reactions.

<h3>Permissions</h3>

QuoteBot requires the following permissions to work: 

- Read Messages: Used to check for our prefixes and send a quote if appropriate.
- Send Messages: Respond to a quote request
- Manage Messages permissions (remove trigger messages, optional)

To manage QuoteBot, you must have the following privileges: 

- Manage Server

<h3>Feature Requests</h3>

If you have any suggestions please join our Support Server and we will do our best to help as soon as possible.


Voting for QuoteBot

Do you want to support us?