To get started, first set up your own Red Discord Bot. Then, run these commands:
[p]repo add coffee-cogs https://github.com/coffeebank/coffee-cogs
[p]cog install coffee-cogs loveplay
This cog does not store any End User Data.
loveplay
Send love to other members of the server with reaction gifs from Purrbot API. Does not require a user @mention (say '=hug server' all you like!). Includes: blush, cuddle, dance, hug, kiss, lick, neko, nom, pat, poke, slap. Also includes a custom reaction gif builder that works for any gif type from the Purrbot API. To replace built-in hug command, unload 'General' cog and install 'coffeetools' cog.
- love
- hug
- kiss
- catgirls
Install
loveplay
Send love to other members of the server with reaction gifs from Purrbot API. Does not require a user @mention (say '=hug server' all you like!). Includes: blush, cuddle, dance, hug, kiss, lick, neko, nom, pat, poke, slap. Also includes a custom reaction gif builder that works for any gif type from the Purrbot API.
⚠️ Because this cog replaces the hug command, you may need to unload the General cog from your Red bot. coffeetools cog is a drop-in replacement for General cog.
Custom Commands
Loveplay is flexible. You can create a custom command at any time.
The Purrbot Image API lists all image types at https://docs.purrbot.site/api/.
In the [p]loveplay command, you can use any image type as your "action" and insert a description (in quotes if there are multiple words).
When you are done, you can use [p]alias command to create any custom Loveplay command you'd like.
Example
[p]loveplay bite "nom 🤤" @PuddingUser
- action: bite, description: "nom 🤤"
- alias command: [p]bite
-
![Running the command [p]loveplay bite "nom 🤤" @PuddingUser](/coffee-cogs/assets/loveplay-example-01.jpg "Running the command [p]loveplay bite \"nom 🤤\" @PuddingUser")
![Running the command [p]alias add bite loveplay bite "nom 🤤", which adds a new command [p]bite](/coffee-cogs/assets/loveplay-example-02.jpg "Running the command [p]alias add bite loveplay bite \"nom 🤤\", which adds a new command [p]bite")
FAQ
The GIF doesn't appear, only some text and a link...
Please check if you have given Embed Links permission to the bot, in the channel.
The slash command isn't working!
The slash command fails if the image API is too slow (max. 3 seconds).
Please try again using @bot command instead.
My aliases are returning something weird!
On 18 June 2023, a breaking change to the main Loveplay command switched the user input to the end of the command. Loveplay has decided to enable this change to make custom aliases easier and allow for smoother multi-word use of the Loveplay command.
This may have affected certain aliases that have been already set up. Please update/edit your aliases and remove the {0}. With this change, the user parameter is automatic, and supports multi-word entries without needing "" double-quotes.
Please note the description still needs to be in "" double-quotes if it is multi-word, when setting up the alias.