Documentation
Learn how to use Kudibot to give kudos and manage rewards in your server.
Getting Started
Start recognizing your team members in just a few simple steps:
1. Add Kudibot to Your Server
Click the button below to invite Kudibot to your Discord server. The bot requires specific permissions to function properly:
- View Channels
- Send Messages
- Read Message History
- Use Application Commands
- Embed Links
- Mention Everyone
2. Configure Your Server
Set up a dedicated channel for kudos notifications:
/kudichannel
This channel will receive all kudos notifications and reward updates. When someone gives kudos:
- The kudos announcement will appear in this channel
- The person giving kudos will receive a private confirmation
Giving Kudos
Recognize your teammates with these simple methods:
Quick Kudos
To give kudos, mention someone and add ++
:
@teammate++ Great work today! 🌟
Multiple Kudos
Give kudos to multiple people in one message:
@teammate1++ @teammate2++ Awesome collaboration on the project! 🚀
When you give kudos:
- A public announcement will be made in the configured channel
- You'll receive a private confirmation showing your total kudos given
- Recipients will see their updated kudos count in the announcement
Rewards System
Create and manage rewards to encourage participation:
Setting Up Rewards
First, set an admin password for managing rewards:
/kudiadmin set_password
Then create a new reward period:
/kudireward create
You'll need to specify:
- Name and description of the reward
- A unique short name for easy reference
- Prize for winners
- Start and end dates
- Required kudos to receive and give
- Maximum number of winners
Managing Rewards
View active rewards and their status:
/kudireward list
Check specific reward progress:
/kudireward status [short_name]
Delete a reward (admin only):
/kudireward delete [short_name]
Available Commands
Here's a complete list of commands you can use:
General Commands
-
/kudistats
View kudos statistics and rankings. Options:
sort
: 'received' or 'given' kudoslimit
: Number of users to show (1-25)
-
/kudichannel
Set the current channel for kudos notifications
-
/kudireport
Submit your daily status report
Admin Commands
-
/kudiadmin set_password
Set or update the admin password for rewards management
Reward Commands
-
/kudireward create
Create a new reward period
-
/kudireward list
View all active rewards
-
/kudireward status [short_name]
Check the status of a specific reward
-
/kudireward delete [short_name]
Delete a reward (admin only)
Usage Examples
Here's how teams are using Kudibot effectively:
Recognition Examples
Celebrating Success
@teammate++ Amazing presentation today! You really knocked it out of the park 🎯
Helping Others
@teammate++ Thanks for helping me debug that issue! 🐛
Team Collaboration
@teammate1++ @teammate2++ Great pair programming session today! 💻
Tips & Tricks
Best Practices
- Be specific in your kudos messages - explain why you're recognizing someone
- Use rewards to create friendly competition and boost engagement
- Check kudos stats regularly to ensure everyone's contributions are recognized
- Set up a dedicated kudos channel to keep other channels focused
Getting Help
Need Assistance?
If you need help or have questions:
- Check our GitHub Issues for known problems
- Join our Discord Server for community support
- Report bugs through our Issue Tracker