Have a Cookie! 🍪 (or any emoji)

The Discord bot that fosters better communities through rewards and peer recognition.

Website • Twitter • Documentation

Have a Cookie is a simple alternative to HeyTaco!, Karma Bot, and Karl (KudosBot) that is:

• Free
• Open-source
• Self-hosted
• Highly customizable (down to the emoji currency)
• Available on Discord

To use it, simply set up the bot, @ mention another member along with the emoji to give them points, and exchange your points for custom prizes!

(PROMO VIDEO)

Features

Give kudos to your community-members

• ⚡ Celebrate your server members and teammates by giving them props & kudos in the form of limited 🍪 emoji currency.
• ⚡ Keep your members engaged by encouraging helpful contributions and peer-to-peer support.
• ⚡ Foster a happier server where members show their appreciation and praise to each other in a fun way.
• ⚡ Use the leaderboards to build some friendly competition.

Redeem points for prizes

• ⚡ Create a custom catalogue of prizes which can be purchased with the 🍪 currency.
• ⚡ Members can browse through the list of prizes and makes purchases by messaging the bot.

Customize everything!

• ⚡ Don't like the "cookie" 🍪 points? Give your team members a 🥭, 🥝, 👍, 🍔, 🙌, etc. instead. The choice of emoji is yours!
• ⚡ Create your own rewards: give them a name, set the "price", provide instructions, and more!
• ⚡ Set your own limit for the amount of tacos your server members can give per day.
• ⚡ Choose your own prefix for bot interactions.

Screenshots

Getting Started (Railway.app)

Video Tutorial

Written Instructions (Railway.app)

Creating your Discord Bot (based on discordpy docs)

1. Make sure you’re logged on to the Discord website.
2. Navigate to the application page.
3. Click on the blue "New application" button at the top-right.
4. Give the application a name and click “Create”.
5. In the left sidebar, click on the "Bot" tab and select "Add bot"
6. Give your bot a cool username and icon. This is what how it'll appear in the server.
7. Take note of the bot token, as you will need to add it to your code in the next section.
8. You can leave the remaining "Authorization Flow" and "Privileged Gateway Intents" options unchecked, unless you believe they apply to your project.
9. It's now time to invite your bot to your server. Head to the left sidebar and click on OAuth2 > URL Generator.
10. In "Scopes", check the "bot" option
11. Under "Bot Permissions", select "Administrator". I have not tested other permissions, but feel free to select other ones if you wish.
12. Copy the Generated URL, and open the link.
13. Add the bot to the respective server.

Creating your Code Repository

1. Create a private clone of this repository on GitHub. Make sure this repo is set to private, as you will be adding sensitive information in the later steps.
2. In your repo, select the data folder, and click on config.json
3. Edit the variables for your custom bot. You can customize the emoji, prefix, max per day, prizes, and prize channel. Note that for the prizes, the "redeemInstructions" text is only visible once the prize has been successfully purchased.
4. IMPORTANT: Make sure to add the bot token (from the previous section), and database URL (next section)

Hosting your bot

1. If you don't have one already, create a Railway.app account
2. Create a new Project, and select "Deploy from GitHub repo".
3. In the same "New Project" window, also select "Provision PostgreSQL".
4. Once everything is deployed in Railway, select the project and click on the rectangle with the GitHub repo's name.
5. On the right window, click on the "Settings" tab, and in the "Environment" section, make sure the automatic deployment trigger is enabled.
6. Afterwards, click on the PostgreSQL rectangle.
7. On the right window, click on the "Connect" tab, and copy the "Postgres Connection URL".

Updating code with Database URL

1. In your GitHub repository, return to config.json and paste the Postgres Connection URL as the value for "databaseUrl" :. For example:
2. Saving these changes will trigger the deployment of an updated Railway project.
3. Your bot should now be live and working.

Testing the Bot

1. Give a reward: In any channel where the bot is present, @ mention a fellow user followed by the emoji. For example, "thanks for the help @candidexmedia :cookie:"
2. List of Prizes: Direct message the bot using your prefix set in config.json followed by prizes (no space) (ie: "!prizes").
3. Purchase a Prize: Direct message the bot using your prefix set in config.json followed by prizes and the prize number (ie: "!prizes 1" for the first prize listed in the prize list).
4. Leaderboard + Check Balance: @ mention the bot in any channel where it's present.

About the project

I commissioned this bot from a freelancer on Fiverr named mdaniels6758. I made some modifications and decided to open source the project in the hopes that it will benefit other Discord users, and that improvements can be brought to the project collectively.

Wishlist / Bugs to Fix

Help, Suggestions, and Pull Requests are much appreciated! Consult the list of bugs and feature requests here: https://github.com/havecookie/haveacookie/issues

Support

Do you enjoy this software? If so, consider supporting me so that I can bring more open source ideas and tutorials to life!

https://ko-fi.com/candidexmedia