An open API service indexing awesome lists of open source software.

https://github.com/Jesewe/VioletWing

CS2 TriggerBot is an automated tool designed for Counter-Strike 2 that assists with precise aiming by automatically triggering a mouse click when an enemy is detected in the player's crosshairs.
https://github.com/Jesewe/VioletWing

cs2 cs2-cheat cs2-triggerbot

Last synced: 5 months ago
JSON representation

CS2 TriggerBot is an automated tool designed for Counter-Strike 2 that assists with precise aiming by automatically triggering a mouse click when an enemy is detected in the player's crosshairs.

Awesome Lists containing this project

README

          


VioletWing

VioletWing


Your ultimate assistant for Counter-Strike 2

[![Downloads](https://img.shields.io/github/downloads/jesewe/VioletWing/total?style=for-the-badge&logo=github&color=D5006D)](https://github.com/Jesewe/VioletWing/releases)
[![Latest Release](https://img.shields.io/github/v/release/jesewe/VioletWing?style=for-the-badge&logo=github&color=D5006D)](https://github.com/Jesewe/VioletWing/releases/latest/)
[![License](https://img.shields.io/github/license/jesewe/VioletWing?style=for-the-badge&color=D5006D)](LICENSE)

Features
Installation
Usage
Troubleshooting
Contributing

---

# Overview

VioletWing is an automated tool designed for Counter-Strike 2 that enhances gameplay with features like precise aiming, visual overlays, and movement automation. It includes a graphical user interface (GUI) for easy configuration.

## Features

- **TriggerBot**:
- Automatically fires when an enemy is under your crosshair.
- Configurable trigger key (e.g., `x`, `c`, `mouse4`, `mouse5`) via GUI or `config.json`.
- Toggle mode for single-key activation.
- Adjustable delays (`ShotDelayMin`, `ShotDelayMax`, `PostShotDelay`) for natural shooting.
- Option to attack teammates.
- **Overlay (ESP)**:
- Displays enemy bounding boxes, snaplines, health numbers, nicknames, and a minimap.
- Customizable colors, line thickness, and minimap size.
- **Bunnyhop**:
- Automates bunny hopping for continuous jumping and speed maintenance.
- **NoFlash**:
- Reduces or eliminates flashbang effects for uninterrupted visibility.
- **Automatic Offset Fetching**: Retrieves latest offsets from remote sources on startup.
- **Graphical User Interface (GUI)**:
- **Dashboard**: Shows bot status, offset updates, and version info.
- **General Settings**: Toggle TriggerBot, Overlay, Bunnyhop, and NoFlash.
- **Trigger Settings**: Configure trigger key, delays, and toggle mode.
- **Overlay Settings**: Adjust ESP features and appearance.
- **Logs Tab**: View real-time logs from `%LOCALAPPDATA%\Requests\ItsJesewe\crashes\vw_logs.log`.
- **FAQ Tab**: Answers to common questions about all features.
- **Supporters Tab**: Lists contributors and supporters.
- **Dynamic Config Updates**: Applies `config.json` changes without restarting via `file_watcher.py`.
- **Update Checker**: Notifies of new versions via GitHub releases.
- **Logging**: Saves logs to `%LOCALAPPDATA%\Requests\ItsJesewe\crashes\vw_logs.log` and `vw_detailed_logs.log`.

## Installation

Install by cloning the repository or downloading a pre-built executable from releases.

### Option 1: Clone the Repository

1. **Clone the Repository:**

```bash
git clone https://github.com/Jesewe/VioletWing.git
cd VioletWing
```

2. **Install Dependencies:**

```bash
pip install -r requirements.txt
```

**PyMeow Module:**
PyMeow is essential for rendering the overlay.
Download the latest `pyMeow*.zip` from the [PyMeow GitHub Releases page](https://github.com/qb-0/pyMeow/releases) and install it:

```bash
pip install pyMeow*.zip
```

3. **Run the Script:**

```bash
python main.py
```

### Option 2: Download Pre-Built Executable

Download the latest executable from the [Releases](https://github.com/Jesewe/VioletWing/releases) page and run it directly.

**Note:** Requires Python >= 3.8 and < 3.12.5.

## Troubleshooting

- **Failed to Fetch Offsets**: Verify internet connection and source URL accessibility.
- **Offset Errors Post-Update**: Wait for updated offsets from [https://github.com/a2x/cs2-dumper](https://github.com/a2x/cs2-dumper).
- **Could Not Open `cs2.exe`**: Ensure the game is running with necessary permissions.
- **Overlay Not Displaying**: Check Overlay settings and game mode (windowed/borderless).
- **Bunnyhop Inconsistent**: Verify focus on game window and settings.
- **NoFlash Not Working**: Confirm offsets are updated and feature is enabled.
- **Unexpected Errors**: Review logs in `%LOCALAPPDATA%\Requests\ItsJesewe\crashes\`.
- **Invalid Config Import**: Ensure `config.json` format is correct.

## Contributing

We welcome contributions to VioletWing!

Before you start, please read our [**Contributing Guidelines**](CONTRIBUTING.md).

- To report a bug or suggest a feature, please [**open an issue**](https://github.com/Jesewe/VioletWing/issues) using the appropriate template.
- To submit your changes, please [**create a pull request**](https://github.com/Jesewe/VioletWing/pulls).

## Disclaimer

This tool is for educational purposes only. Using automation tools in online games violates terms of service and may result in bans. Use at your own risk.

## License

Licensed under the GPL-3.0 License. See the [LICENSE](LICENSE) file for details.