Awesome

🤖 quizquickanswer-telegram-game-bot

Funny quiz game, play with friends on your telegram group!

🎁 Support: Donate

This project is free, open source and I try to provide excellent free support. Why donate? I work on this project several hours in my spare time and try to keep it up to date and working. THANK YOU!

📎 Menu

💡 Features
👔 Screenshot
🚀 How to use
🎮 How to play
🔨 Developer Mode
- 🏁 Run Project
- 💾 Setup Project
- 🚀 Deploy
📚 Documentation
👨‍💻 Contributing
🐛 Known Bugs
🍻 Community:
- <img src="https://raw.githubusercontent.com/ptkdev/quizquickanswer-telegram-game-bot/main/.github/assets/social_telegram.png" height="18px"> Telegram (🇬🇧 English | 🇮🇹 Italian)

💡 Features

[✔️] Easy to use
[✔️] MIT License
[✔️] Powered by Grammy Telegram API Framework
[✔️] Quiz game, play with friends on your telegram group

👔 Screenshot

🚀 Installation

Add @QuizQuickAnswerBot to your Telegram group
Make @QuizQuickAnswerBot admin of your group
Run /start or /start@QuizQuickAnswerBot
Make yourself master of game, run /master @nickname
Follow instructions and Play with friends!

🎮 How to play

Set a master with /master @nickname
Master send private message to @QuizQuickAnswerBot
Master write question with syntax: QUESTION ## TIP, example: gameboy ## '90s' portable console
Friends try to answer quickly in the telegram group. Who reply with right answer is the new master!

⏱ Official Group

If you have no telegram groups of friends you can play in the official one, you will find new friends and kind people:

🔨 Developer Mode

🏁 Run Project

Clone this repository or download nightly, beta or stable.
Write to @botfather on telegram and create new bot (save token and set bot username)
Set bot token: export BOT_TOKEN=1234:asdfghjkl
Set mongodb connection url: export MONGODB=mongodb://localhost:27017/quizquickanswerdb
Run npm install
Run npm run dev
Write /start on telegram bot.

🚀 Deploy

Deploy bot to your server and:

Set bot token: export BOT_TOKEN=1234:asdfghjkl
Set mongodb connection url: export MONGODB=mongodb://localhost:27017/quizquickanswerdb
Run init npm install
Generate release npm run release
Start bot npm run start-pm2

📚 Documentation

Run npm run docs

👑 Backers and Sponsors

Thanks to all our backers! 🙏 Donate 3$ or more on paypal, ko-fi, github or patreon and send me email with your avatar and url.

👨‍💻 Contributing

I ❤️ contributions! I will happily accept your pull request! (IMPORTANT: Only to nightly branch!) Translations, grammatical corrections (GrammarNazi you are welcome! Yes my English is bad, sorry), etc... Do not be afraid, if the code is not perfect we will work together 👯 and remember to insert your name in .all-contributorsrc and package.json file.

Thanks goes to these wonderful people (emoji key):

<table> <tbody> <tr> <td align="center" valign="top" width="16.66%"><a href="https://ptk.dev"><img src="https://avatars1.githubusercontent.com/u/442844?v=4?s=100" width="100px;" alt="Patryk Rzucidło"/><br /><sub><b>Patryk Rzucidło</b></sub></a><br /><a href="https://github.com/ptkdev/ptkdev/quizquickanswer-telegram-game-bot/commits?author=ptkdev" title="Code">💻</a> <a href="#translation-ptkdev" title="Translation">🌍</a> <a href="https://github.com/ptkdev/ptkdev/quizquickanswer-telegram-game-bot/commits?author=ptkdev" title="Documentation">📖</a> <a href="https://github.com/ptkdev/ptkdev/quizquickanswer-telegram-game-bot/issues?q=author%3Aptkdev" title="Bug reports">🐛</a></td> <td align="center" valign="top" width="16.66%"><img src="https://avatars1.githubusercontent.com/u/50172746?v=4?s=100" width="100px;" alt="Alì Shadman"/><br /><sub><b>Alì Shadman</b></sub><br /><a href="https://github.com/ptkdev/ptkdev/quizquickanswer-telegram-game-bot/commits?author=AliShadman95" title="Code">💻</a> <a href="#translation-AliShadman95" title="Translation">🌍</a> <a href="https://github.com/ptkdev/ptkdev/quizquickanswer-telegram-game-bot/commits?author=AliShadman95" title="Documentation">📖</a> <a href="https://github.com/ptkdev/ptkdev/quizquickanswer-telegram-game-bot/issues?q=author%3AAliShadman95" title="Bug reports">🐛</a></td> <td align="center" valign="top" width="16.66%"><a href="https://instagram.com/den_karina"><img src="https://avatars1.githubusercontent.com/u/91738047?v=4?s=100" width="100px;" alt="Denise Scazzari"/><br /><sub><b>Denise Scazzari</b></sub></a><br /><a href="#translation-DeniseKarina" title="Translation">🌍</a></td> </tr> </tbody> </table>

💰 In the future, if the donations allow it, I would like to share some of the success with those who helped me the most. For me open source is share of code, share development knowledges and share donations!