Treasure Hunt Bot
Source code of the Code Hunting Games bot for Telegram. Visit the official website for further information on how to play the game and how to organize your own games.
Developed at the University of Urbino (Italy) for the CodeMOOC course.
Are you organizing Code Hunting Games in your country and the bot is not yet localized? Check out the bot’s translation project on CrowdIn.
Source code pull requests are welcome. Please also check out issues to give feedback on errors, possible bugs, or improvements.
Deploy your own bot
A Code Hunting Games session can very easily be organized for free using our @treasurehuntbot.
If you want to deploy your bot on your own, requirements are as follows:
- A Telegram bot,
- Server with a public IP,
- PHP 7,
In order to install the bot, please proceed as follows:
- Get the code from this repository and ensure that your Web server correctly serves the source files at directory
/srcthrough the PHP interpreter.
- Copy the
/src/config.phpand edit if as follows:
TELEGRAM_BOT_TOKENto your Telegram bot's token,
- Set all
DATABASEconstants to point to your local MySQL and ensure that the database user you are setting has read/write access,
BOTNAMEwith your Telegram bot's nickname.
- Install the database schema, running the
- Check whether the bot works, by running
php pull.php(in directory
/src): this will attempt to process Telegram messages you send to your bot in pull mode.
- If everything works correctly, setup a webhook to your bot through the Telegram bot API:
curl -F "url=https://YOURDOMAIN/PATH-TO-BOT/src/hook.php" https://api.telegram.org/botBOTTOKEN/setWebhook
(Make sure to replace the URL with the correct path to your server and the
TOKEN with your Telegram bot's token.)
That is all: the bot should now respond to your messages automatically. You're all set and ready to create your own Code Hunting Games.