{"id":37147591,"url":"https://github.com/evassilyev/chgk-telebot","last_synced_at":"2026-01-14T17:24:46.978Z","repository":{"id":137082164,"uuid":"134775231","full_name":"evassilyev/chgk-telebot","owner":"evassilyev","description":"Телеграм-бот для игры в \"Что? Где? Когда?\"","archived":false,"fork":false,"pushed_at":"2019-08-17T12:56:27.000Z","size":14520,"stargazers_count":0,"open_issues_count":3,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2024-06-21T17:57:33.256Z","etag":null,"topics":["telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/evassilyev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-05-24T22:31:47.000Z","updated_at":"2019-08-17T12:56:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"dbcded1e-9e79-446d-9f4c-af42d762421e","html_url":"https://github.com/evassilyev/chgk-telebot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/evassilyev/chgk-telebot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evassilyev%2Fchgk-telebot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evassilyev%2Fchgk-telebot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evassilyev%2Fchgk-telebot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evassilyev%2Fchgk-telebot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/evassilyev","download_url":"https://codeload.github.com/evassilyev/chgk-telebot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/evassilyev%2Fchgk-telebot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28427422,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T16:38:47.836Z","status":"ssl_error","status_checked_at":"2026-01-14T16:34:59.695Z","response_time":107,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["telegram","telegram-bot"],"created_at":"2026-01-14T17:24:46.333Z","updated_at":"2026-01-14T17:24:46.968Z","avatar_url":"https://github.com/evassilyev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# chgk-telebot\nTelegram bot for \"What? Where? When?\" game.\n\n[Телеграм бот для игры в \"Что? Где? Когда?\"](https://github.com/evassilyev/chgk-telebot#%D0%91%D0%BE%D1%82-%D0%B4%D0%BB%D1%8F-%D0%B8%D0%B3%D1%80%D1%8B-%D0%B2-%D0%A7%D1%82%D0%BE-%D0%93%D0%B4%D0%B5-%D0%9A%D0%BE%D0%B3%D0%B4%D0%B0)\n\n### Description\n\nThe bot lets you to play \"What? Where? When?\" in the group Telegram chat in a text mode. \nIt downloads the set of questions from [the questions database](https://db.chgk.info) and shows them to you one by one hiding answers until your request or until the time is over. \nYou can configure the timer duration and the number of questions in the set. \nThe whole interaction and configuration process is carried out via text commands in the Telegram chat.\n\n### Installation\n\n1. [Create your telegram bot](https://core.telegram.org/bots#3-how-do-i-create-a-bot) or use the one you already have. \n   Create a group chat for gaming and add your bot there. \n   You need to know the token of your bot and the group chat ID. \n   You can get the token by @BotFather (You have already used it while creating your bot). \n   You can get the chat ID by following the link: `https://api.telegram.org/bot*YourBOTToken*/getUpdates`, where you need to change the _YourBOTToken_ to the token of your bot beforehands. \n   In the JSON responce you will find the ID of the group chat. Usually it is a negative integer number.\n1. Prepare the configuration file. Download _config.example.json_, rename it to _config.json_. Then, write your bot's token (in the double quotes) and the chat ID (just like a number) there.\n1. Download the executable file from the _Builds/v1.0/_ folder and place it in the same directory with the configuration file _config.json_.\n1. Just run it as a console application. You can set the path to configuration file using the _-config_ console argument.\n\n### Playing\n\nYou can get the list of all available commands by texting **/?** or **/HELP** in the chat.\nBefore the play you should load the set of questions by the comand **/get_packet** then text **/start** for starting the game.\n\n##### List of commands\n\n* __/?__ __/HELP__ - show help on commands\n* __/get_packet N__ __/получить_пакет N__ - load the packet of N questions\n* __/start__ __/начать__ - start the game\n* __/next__ __/след__ - go to the next question\n* __/prev__ __/пред__ - go to the previous question\n* __/question N__ __/вопрос N__ - go to the quesiton number N\n* __/answer__ __/ответ__ - show the answer\n* __/info__ - show the additional question's information (author, sources etc.)\n* __/set_timer__ - set the timer in minutes (fractional values available)\n\n### Notes \n\n* When loading the questions set for the first time after launching the application you have to set the number of questions. In the next loading the number of questions will be the same as it was during the previous loading by default.\n* Minimal timer value is 0.25 (15 seconds). After setting the timer for the first time it is impossible to switch it off. You can imitate the switching off by setting the timer for a big period.\n* The application loads the random sets of questions for the whole store period. All the questions in the set have a random complexity and only two types: \"What? Where? When?\" and \"Brain-ring\".\n\n# Бот для игры в \"Что? Где? Когда?\"\n### Описание\n\nТелеграм бот позволяет вам играть в _\"Что? Где? Когда?\"_ прямо в групповом чате Телеграм. \nДля игры используются вопросы, которые загружаются напрямую из [базы вопросов](https://db.chgk.info) ЧГК.\nПроцесс игры представляет из себя отправку ботом вопроса с последующей отправкой ответа по таймеру либо по запросу пользователя.\nТаймер и количество вопросов в пакете - настраиваемые параметры. Всё взаимодействие с ботом в процессе игры и настройки осуществляется посредством текстовых команд в чате.\n\n### Установка\n\n1. Для начала вам необходимо [создать Телеграм бота](https://core.telegram.org/bots#3-how-do-i-create-a-bot) или использовать уже имеющийся. Создайте групповой чат в Телеграм и добавьте туда своего бота.\n   Вам необходимо узнать токен вашего бота и идентификатор группового чата. Токен бота можно получить при помощи служебного бота _@BotFather_ (Им вы уже пользовались при создании своего бота).\n   Идентификатор группового чата вы можете получить, пройдя по ссылке `https://api.telegram.org/bot*YourBOTToken*/getUpdates` в которой вам необходимо предварительно заменить YourBOTToken на токен вашего бота.\n   Ссылка вернет вам структуру в формате JSON, где вы сможете найти идентификатор группового чата, в который вы добавили бота. Обычно это целое отрицательное число.\n1. Далее, подготовьте конфигурационный файл. Скачайте или скорпируйте из репозитория файл _config.example.json_, переименуйте его в _config.json_, затем, впишите в него в двойных кавычках токен вашего бота и идентификатор группового чата.\n1. Загрузите готовый исполняемый файл из папки _Builds/v1.0/_ и разместите его в одной папке с конфигурационным файлом _config.json_.\n1. Запустите исполняемый файл как консольное приложение. Так же, вы можете указать путь к конфигурационному файлу с помощью аргумента командной строки _-config_. \n\n### Процесс игры\n\nЗагрузите пакет написав в групповом чате команду **/get_packet** или **/получить_пакет**. После чего начните игру с помощью комады **/start** или **/начать**.\n\n##### Список доступных команд\n\n* __/?__ __/HELP__ - Показать справку по командам\n* __/get_packet N__ __/получить_пакет N__ - загрузить пакет из N вопросов\n* __/start__ __/начать__ - начать игру\n* __/next__ __/след__ - следующий вопрос\n* __/prev__ __/пред__ - предыдущий вопрос\n* __/question N__ __/вопрос N__ - перейти к вопросу под номером N\n* __/answer__ __/ответ__ - показать ответ\n* __/info__ - показать информацию о вопросе (автор, источники и т.д.)\n* __/set_timer__ - установить таймер в минутах (возможно установить дробные значения)\n\n### Замечания\n\n* При первой загрузке пакета после запуска приложения необходимо обязательно указать число вопросов в пакете, при последующих загрузках по умолчанию будет загружаться то число вопросов как и в предыдущей загрузке пакета.\n* Минимально допустимое значение таймера 0.25 минут (15 секунд). После первой установки таймера полностью отключить его невозможно. Сымитиовать отключение таймера можно установив его на большой период времени.\n* Из базы загружаются только случайные пакеты состоящие из вопросов за весь хранимый период (c 1990 года) произвольной сложности. В пакет включаются вопросы только типов \"Что? Где? Когда?\" и \"Брейн-ринг\".\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevassilyev%2Fchgk-telebot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fevassilyev%2Fchgk-telebot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fevassilyev%2Fchgk-telebot/lists"}