Join the Piñata Discord Server!
<aside> 🌟 Piñata is open for sponsorships! 🌟By becoming a sponsor, you'll receive a superlative happy smile 😊 priority support and get the chance to discuss custom features. Your support will help to afford infrastructure costs (AWS hosting and domain) Your supports means a lot to me! 🙌
</aside>
<aside> <img src="/icons/cursor_gray.svg" alt="/icons/cursor_gray.svg" width="40px" /> Piñata is a bot built for Discord which creates random groups of two users. It’s a perfect icebreaker for new ****comunity members to know each others. You may choose English, Italian, French and Spanish as the default language.
</aside>
<aside> 🙋 Do you want to help translating Piñata to a different language? Feel free to contact me.
</aside>
<aside> <img src="/icons/mail_blue.svg" alt="/icons/mail_blue.svg" width="40px" /> Contact me on Discord and Linkedin.
</aside>
Table of contents
UPDATES[2026/08/20] 🎊 Late matching & endless pairings! Two big features in this release. Late matching: users who join the server (or the channel) after the piñata was opened are no longer left out — when they use /pinata, if there is another unmatched user available, they will be paired on the spot and added to the current round. It's enabled by default and admins can turn it off with the new /late command. Endless pairings: /match no longer stops working when everyone in your community has already met. When no fresh combination exists, Piñata now repeats pairs smartly, always choosing the people who haven't seen each other in the longest time. No more "No groups found", and no need to /reset your history. Also includes several bug fixes and stability improvements.
[2023/10/31] 📢 Piñata is now Open Source! I’m thrilled to let you all know that Piñata, my beloved bot, is now Open Source! 🥳This means that you can now dive into its workings, improve it or customize it to better suit your community’s unique needs. Of course you can keep using the current free version if you want. Check out the project on GitHub!
[2023/06/12] Bug fix. Piñata was using a wrong approach (my bad) to retrieve all members in a specific channel. For that reason, certain users (not cached ones) weren’t appearing in the match. That has been fixed now. Code has been improved and that shouldn’t happen again (I hope). Enjoy!
[2022/11/26] Piñata messages will now show user mentions in plain text. Usernames are not clickable anymore. This workaround will avoid an error on mobile phones when users would see an id instead a name (a known old issue in Discord. Hopefully they will fix it soon).
[2023/01/01] New support server on Discord. Feel free to join Piñata on Discord if you need support, talk to the creator, report any bug or give feedback. Join today using this invite https://discord.gg/XMdrNExKRJ
INSTRUCTIONS<aside>
⚠️ Piñata needs these permissions: see channel and send messages on the channel you will be using it. If you see errors like “Application not responding” or it keeps waiting forever when using the /match command, make sure you have granted these permissions to the role “Piñata” or directly to the bot. Enjoy 😊
</aside>
Instructions are pretty simple.
/match there. The bot will match the people that are currently in that channel in pairs and once it’s finished, it will post a message like this one below. Piñata bot must have permission to send messages in that channel.
Users now may click the button “Open the Piñata!” to know who’s been matched with. Now your community members can know each other 👋 do business 💼 or whatever they want 💃🕺
Anytime you want (e.g. every week or so) you may run the command /match command again. Another round will kick in and no users will be matched together again.
COMMANDS/matchUse this command to kick a new round of pairings. Piñata will retrieve the list of users which are currently on the channel where you issued the command. It will create random groups of two people. Once it’s finished, it will post a message informing users that the Piñata is ready!