Visual Aim Assist Tool

A cross-platform (Windows/Linux) visual aim-assist tool that uses screen capture and color detection to provide optional mouse assistance for games.

⚠️ Important: Antivirus False Positive Notice

If your antivirus flags this software as malicious (e.g., "Trojan:Win32/Wacatac.B!ml"), this is a FALSE POSITIVE.

Why does this happen?

This tool uses several legitimate Windows/Linux APIs that are sometimes misused by actual malware, causing heuristic-based antivirus engines to flag them:

1. SendInput() API (Windows) - Used to simulate mouse movements. This is the same API used by accessibility tools, automation software, and yes, some malware. However, this tool only uses it for legitimate mouse movement simulation.

2. GetDC(), BitBlt(), PrintWindow() APIs (Windows) - Standard GDI functions for screen capture. These are public Windows APIs used by many legitimate applications including screen recorders, remote desktop software, and screenshot tools.

3. /dev/uinput (Linux) - A kernel module that allows user-space programs to create virtual input devices. Used by legitimate tools like gaming peripherals software, accessibility tools, and automation scripts.

4. RegisterHotKey() API (Windows) - Standard Windows API for registering global hotkeys. Used by countless legitimate applications.

5. X11/XShm APIs (Linux) - Standard X Window System APIs for screen capture, used by screen recorders, screenshot tools, and remote desktop applications.

What this tool does NOT do:

✅ Does NOT read or write memory of other processes ✅ Does NOT inject DLLs into other processes ✅ Does NOT hook into game executables ✅ Does NOT modify game files ✅ Does NOT communicate over the network ✅ Does NOT persist itself in your system ✅ Does NOT steal any data ✅ Does NOT contain any obfuscated or encrypted payloads

How to verify:

1. Review the source code - All source code is available in this repository. The code is open and transparent.
2. Compile it yourself - Build from source using the provided CMakeLists.txt to ensure the binary matches the source.
3. Submit to VirusTotal - While individual engines may flag it, you can see the behavioral analysis confirms no malicious activity.
4. Report the false positive - If you believe it's incorrectly flagged, submit the file to Microsoft Security Intelligence for review.

---

Features

• Cross-platform support: Works on both Windows and Linux
• Color-based target detection: Configurable color matching with tolerance settings
• Multiple color spaces: Support for BGR, RGB, and HSV color spaces
• Adaptive ROI: Optional adaptive region-of-interest for improved performance
• Velocity prediction: Lead calculation for moving targets
• Smooth aiming: Configurable smoothness and strength curves
• Triggerbot: Optional auto-click when target is acquired
• Steady aim: Hold a configurable key when target is within range
• Global hotkeys:
  • F1 - Toggle aim assist on/off
  • F2 - Toggle triggerbot on/off
  • F3 - Toggle steady aim on/off
  • F4 - Exit the application
• Debug overlay: Real-time visualization of detection and tracking

---

How It Works

1. Screen Capture: Captures the game window using platform-native APIs (GDI on Windows, XShm on Linux)
2. Color Detection: Uses OpenCV to detect configured colors within the field of view
3. Contour Analysis: Identifies and scores potential targets based on size and distance from crosshair
4. Mouse Movement: Calculates appropriate mouse movement with smoothing and lead prediction
5. Input Simulation: Sends mouse movements via SendInput() (Windows) or uinput (Linux)

---

Requirements

Windows

• Windows 10/11
• Visual Studio 2019 or later (for building from source)
• OpenCV 4.x
• nlohmann/json

Linux

• X11 with XShm extension
• uinput module enabled
• GCC 9+ or Clang 10+
• OpenCV 4.x
• nlohmann/json

---

Building from Source

# Clone the repository
git clone <repository-url>
cd <repository-directory>

# Create build directory
mkdir build && cd build

# Configure with CMake
cmake ..

# Build
cmake --build . --config Release

Dependencies

Install dependencies before building:

Windows (using vcpkg)

vcpkg install opencv nlohmann-json

Ubuntu/Debian

sudo apt-get install libopencv-dev nlohmann-json3-dev libx11-dev libxext-dev

Fedora

sudo dnf install opencv-devel nlohmann-json-devel libX11-devel libXext-devel

---

Configuration

The configuration file is located at:

• Windows: %APPDATA%/aimbot/config.json
• Linux: ~/.config/aimbot/config.json

Configuration Options

Option	Description	Default
window	Target window title (partial match)	"Roblox"
colors	Array of hex color codes to detect	["#ffffb2", "#ffffb4", "#ffffb6"]
color_space	Color space for detection ("bgr", "rgb", "hsv")	"bgr"
fov	Field of view radius in pixels	350
tolerance	Color tolerance (0-255) for BGR/RGB	15.0
tolerance_h	Hue tolerance (0-90) for HSV	10.0
tolerance_s	Saturation tolerance (0-255) for HSV	60.0
tolerance_v	Value tolerance (0-255) for HSV	60.0
min_area	Minimum contour area	1
max_area	Maximum contour area	9999
lead	Velocity prediction factor	0.58
smoothness	Smoothing factor (0.0-1.0)	0.1
min_strength	Minimum movement strength	0.033
max_strength	Maximum movement strength	0.8
offset_x	Horizontal offset from target	0.0
offset_y	Vertical offset from target	0.25
trigger	Mouse button to activate ("left", "right", "both")	"right"
target_fps	Target capture FPS (0 = unlimited)	120
triggerbot	Enable auto-click on target	false
trigger_dist	Distance threshold for triggerbot	10.0
trigger_delay	Delay between triggerbot clicks (ms)	250
steady_aim	Enable steady aim feature	true
steady_dist	Distance threshold for steady aim	24.0
steady_key	Key to hold for steady aim	"left_shift"
lost_frames_thresh	Frames before target history reset	4
debug	Enable debug overlay	true

---

Usage

1. Configure: Edit the config file to match your game's target colors and preferences
2. Run: Launch the application
3. Activate: Press and hold the configured trigger button (default: right mouse button)
4. Toggle features: Use F1-F3 hotkeys to enable/disable features
5. Exit: Press F4 or Ctrl+C to close the application

---

Legal Disclaimer

This tool is provided for educational purposes only.

• Check your game's Terms of Service: Using aim-assist tools may violate the terms of service of some games and could result in account suspension or banning.
• Use responsibly: Only use this tool in single-player games or where explicitly permitted.
• No warranty: This software is provided "as-is" without any warranty.

The authors are not responsible for any misuse of this software or any consequences resulting from its use.

---

License

See the LICENSE file for details.

---

Contributing

Contributions are welcome! Please feel free to submit issues and pull requests.

---

Acknowledgments

• OpenCV for computer vision capabilities
• nlohmann/json for JSON parsing
• The open-source community for various inspiration and support