/Titan

A advanced CS:GO report and commendation bot built with performance and ease-of-use in mind

Primary LanguageC#MIT LicenseMIT

           Version Appveyor Travis CI Dependencies Downloads Discord           

Titan /ˈtaɪtən/ is an advanced Counter-Strike Global Offensive report and commendation bot. Its goal is to maintain a clean Matchmaking system by sending a target forcefully (by 11 reports) into Overwatch. It provides a advanced set of features and high effiency when compared against other report and commendation bots.

Features

  • Support for both a graphical user interface (GUI) and command line.
  • High performance thanks to multi-threaded reporting and commending (when compared to other report bots).
  • Ban checking for both target and bot accounts. (Requires own generated Steam Web API key)
  • Integrated Sharecode parser that automaticly pauses the Match ID from a CS:GO Demo Share URL
  • Automatic index timer which outputs when an account has finished its 6 hours cooldown.
  • Cross-platform compatibility, supports both Windows and Linux. Darwin support is coming soon.
  • No installation necessary, every release is provided as binary archives.
  • Tracking of botted victims with automatic notification when a ban occurs.
  • Automatic Steam Guard code generation from Shared Secrets
  • Steam Guard support

Installation

Every version of Titan is provided as binary archives. An installation process is not required.

Option 1: Binary

Download the latest binary from the releases tab. Download the package for your operating system, unpack it and run the Titan.exe file.

Option 2: From Source

$ git clone https://github.com/Marc3842h/Titan.git
$ cd Titan

# Run this in a PowerShell terminal on Windows
PS> .\build.ps1

# Run this in a bash terminal on Linux
$ chmod +x build.sh && ./build.sh

Usage

Accounts file

Create a accounts.json in main directory with data:

{
    // Per index are maximum 11 accounts allowed. Begin a new index when a new account is required.
    "indexes": [
        {
            "accounts": [
                {
                    "username": "username1",
                    "password": "password1",
                    "enabled": true, // May be omitted if you want set it to default value (true)
                    "sentry": false, // May be omitted if you want set it to default value (false)
                    "secret": "Shared Secret for SteamGuard" // May be omitted if you don't want to use the shared secret generator
                },
                {
                    "username": "username11",
                    "password": "password11",
                    "enabled": false, // May be omitted if you want set it to default value (true)
                    "sentry": false, // May be omitted if you want set it to default value (false)
                    "secret": "Shared Secret for SteamGuard" // May be omitted if you don't want to use the shared secret generator
                }
            ]
        },
        {
            "accounts": [
                {
                    "username": "username12",
                    "password": "password12",
                    "enabled": true, // May be omitted if you want set it to default value (true)
                    "sentry": false, // May be omitted if you want set it to default value (false)
                    "secret": "Shared Secret for SteamGuard" // May be omitted if you don't want to use the shared secret generator
                },
                {
                    "username": "username22",
                    "password": "password22",
                    "enabled": true, // May be omitted if you want set it to default value (true)
                    "sentry": false, // May be omitted if you want set it to default value (false)
                    "secret": "Shared Secret for SteamGuard" // May be omitted if you don't want to use the shared secret generator
                }
            ]
        }
    ]
}

Start

Run the program from command line with the following syntax:

$ mono Titan.exe (--target) (--mode) [--id] [--file]

On Windows, run Titan without the mono part at the beginning.

If no arguments have been passed with Titan, the GUI will open:

GUI

If one of your recently botted players got banned, you'll also receive a notification:

Notification

All screenshots have been taken on Arch Linux using Gnome with the Ark-Dark theme.

Benchmarks

Titan is a multi-threaded C# report bot for Counter-Strike Global Offensive. Because Titan is multi-threaded, it obviously has an advantage when comparing it to other report bots, which are mostly one-threaded and written in JavaScript using Node.js.

Benchmarks will follow soon.

Contributing

All contributions are welcomed and appreciated.

Bug Reports

Please use the issue tracker to report any bugs or file feature requests.

Developing

Pull Requests are welcome. I suggest using Rider as IDE for this project, but you're free to choose whatever you want.

License

Titan is licensed under the MIT License. Please visit the LICENSE.txt file in the root directory tree for more informations. All external resources that do not fall unter the MIT license (Images etc.) have been credited in the CREDIT.txt under the Resources directory.