Counter-Strike 2 News Telegram Bot

This is a simple Telegram bot providing you the latest posts (news, updates, events) about Counter Strike 2. Stay up to date about the game by retrieving automatic update messages from the bot via Telegram.

The data is crawled from the official steam web api (https://steamcommunity.com/dev).

Important

The bot is not affiliated with Valve Corporation or Counter Strike 2. The bot is a private project and is not intended for commercial use.

Features

• Get the latest news & updates about Counter Strike 2
• General spam protection (chat based)
• Option command to retrieve only interested posts about news, updates or external news
• Data is crawled from the official steam api and checked every few minutes (default: 15 minutes)

Usage

Note

We have a bot already up and running for you which is compeltely free to use. Checkout: @CS2PostsBot

To use @CS2PostsBot, simply start a chat with the bot on Telegram. Then just write /start to get started and /help to get a list of available commands.

Commands

• /start - Start the bot
• /stop - Stop the bot
• /help - Get a list of available commands
• /news - Get the latest news post
• /updates - Get the latest update post
• /external - Sends the latest external post
• /latest - Get the latest post
• /options - Option to enable / disable news or updates posts (admin only)

Adding the Bot to a Group

Adding the bot to a group is possible. The person who adds the bot to the group will be the admin of the bot. Which means only the admin can use the /options command to enable / disable news, updates or external news posts for the group chat.

To prevent spamming a spam protection is implemented. After 3 (default) strikes the chat will be banned and receives a timeout. This affects the whole chat not only the user who spammed.

Single User Chats

Similar to group chats the spam protection is enabled. The /options is available for the user to enable / disable news or updates posts.

Deploying the Bot

To deploy the bot as an own instance you need to create a Telegram Bot via the @BotFather on Telegram. After creating the bot you will receive a token. Rename the .env.example to .env in the root directory and add the token to the file.

TELEGRAM_TOKEN=<your_token>

Possible environment variables:

• TELEGRAM_TOKEN
• CS2_UPDATE_CHECK_INTERVAL(default: 900)
• CHAT_SPAM_INTERVAL_MS (default: 750)
• CHAT_BAN_TIMEOUT_SECONDS (default: 600)
• CHAT_MAX_STRIKES (default: 3)

for detailed information see cs2posts/bot/settings.py.

Create a docker image and run the bot. From the root folder execute the following commands:

mkdir backups
mkdir database
docker build -t cs2-news-bot .
docker run -d -v backups:/app/backups/ -v database:/app/database --env-file .env --name cs2-news-bot cs2-news-bot

To start the cron job checking for news & updates write /start in the chat of your bot.

Contributing

Any contributions are highly appreciated.

License

Distributed under the MIT License. See LICENSE for more information.