Skip to content
This repository was archived by the owner on Oct 9, 2025. It is now read-only.

Conversation

@yin1895
Copy link

@yin1895 yin1895 commented Sep 26, 2025

🎯 Enhanced AI-Aimbot with Driver-Level Mouse Control

📋 Pull Request Summary

This PR introduces significant enhancements to AI-Aimbot, adding driver-level mouse control capabilities and various bug fixes to improve accuracy, performance, and user experience.

✨ New Features

🖱️ Driver-Level Mouse Control System

  • Driver Interface: Direct integration with Logitech GHUB/LGS drivers via ghub_device.dll
  • Enhanced Precision: Driver-level control provides better accuracy than system-level APIs (applied in main_onnx.py)
  • Automatic Fallback: Intelligently falls back to system mouse control when driver unavailable
  • Setup Assistant: Comprehensive installation and configuration guide (setup_driver.py)

🎯 Advanced Aiming System

  • Smooth Movement: Configurable smooth aiming with customizable smoothing factors
  • Predictive Targeting: Optional predictive aiming for moving targets
  • Advanced Algorithms: Enhanced targeting calculations in advanced_aiming.py
  • Real-time Configuration: Hot-reload capable configuration system

🎮 Enhanced User Experience

  • Game Selection: Improved game detection and selection system
  • Hotkey Management: Comprehensive hotkey management with better key detection
  • Error Handling: Robust error handling with user-friendly feedback
  • Modular Design: Clean, modular architecture for easy maintenance and extension

🐛 Bug Fixes

Critical Fixes

Error Handling

  • Enhanced error messages and user feedback
  • Better handling of missing dependencies
  • Graceful degradation when driver unavailable

📁 Files Added/Modified

New Files

  • mouse_driver.py - Core driver interface module
  • ghub_move/ghub_device.dll - Logitech driver binary
  • setup_driver.py - Installation and configuration assistant
  • advanced_aiming.py - Enhanced targeting algorithms
  • smooth_aiming.py - Smooth movement system
  • hotkey_manager.py - Comprehensive hotkey management
  • gameSelection.py - Enhanced game selection system
  • yolo_utils.py - Enhanced YOLO utility functions

Modified Files

  • config.py - Extended with driver control options
  • main_onnx.py - Integrated driver support and bug fixes

⚙️ Configuration Options

New configuration options in config.py:

# Driver Mouse Configuration
useDriverMouse = True          # Use driver-level control
fallbackToSystemMouse = True   # Fallback to system-level control

# Advanced Aiming Configuration  
enableAdvancedAiming = False   # Enable advanced aiming system
enableSmoothMovement = True    # Enable smooth movement
smoothingFactor = 0.6          # Smoothing factor (0.1-0.9)
movementThreshold = 2          # Movement threshold (pixels)
enablePredictiveAim = False    # Enable predictive aiming
predictionStrength = 0.6       # Prediction strength

🔧 Technical Requirements

Prerequisites

  • Python 3.8+
  • Logitech GHUB or LGS drivers (for driver-level control)
  • Windows OS (for win32api integration)

Dependencies

All existing dependencies remain the same, with enhanced compatibility.

🚀 Installation & Usage

Quick Start

# 1. Run setup assistant
python setup_driver.py

# 2. Configure settings (optional)
# Edit config.py as needed

# 3. Run enhanced aimbot
python main_onnx.py

# 4. Use CapsLock to toggle aiming

Driver Setup

  1. Install Logitech GHUB or LGS drivers
  2. Run python setup_driver.py for guided setup
  3. Configure Windows mouse settings as recommended
  4. Test with included verification tools

📊 Performance Improvements

  • Accuracy: Driver-level control provides more precise mouse movements
  • Latency: Reduced input lag compared to system-level APIs
  • Stability: Better error handling and automatic fallback mechanisms
  • Compatibility: Enhanced compatibility across different system configurations

🧪 Testing

Comprehensive testing suite included:

  • test_driver.py - Driver functionality tests
  • Driver availability detection
  • Configuration validation
  • Real-world accuracy testing

🔄 Backward Compatibility

  • All existing functionality preserved
  • Original configuration options remain valid
  • Automatic fallback ensures compatibility without drivers
  • No breaking changes to existing workflows

📝 Additional Notes

This enhancement maintains full backward compatibility while significantly improving the aimbot's capabilities. Users can choose to use the new driver-level features or continue with the existing system-level approach.

The modular design allows for easy maintenance and future enhancements while preserving the original project's simplicity and effectiveness.


Testing Status: ✅ Tested on Windows 10/11 with multiple configurations
Compatibility: ✅ Fully backward compatible
Documentation: ✅ Comprehensive setup guide included
Dependencies: ✅ No additional required dependencies

 New Features:
- Driver-level mouse control using Logitech GHUB/LGS drivers (ghub_device.dll)
- Advanced aiming algorithms with smooth movement and predictive targeting
- Enhanced configuration system with driver control options
- Automatic fallback to system mouse when driver unavailable
- Comprehensive setup assistant for driver installation

 Bug Fixes:
- Fixed CapsLock detection using proper VK_CAPITAL toggle state
- Resolved PyTorch tensor compatibility issues (view() -> reshape())
- Improved error handling and user feedback

 Technical Improvements:
- Modular architecture with separate mouse driver interface
- Real-time configuration hot-reload capability
- Enhanced YOLO utility functions
- Comprehensive game selection system

 Files Added/Modified:
- mouse_driver.py: Core driver interface
- ghub_move/ghub_device.dll: Logitech driver binary
- setup_driver.py: Installation and configuration assistant
- advanced_aiming.py: Enhanced targeting algorithms
- smooth_aiming.py: Smooth movement system
- config.py: Extended with driver control options
- main_onnx.py: Integrated driver support and bug fixes
- yolo_utils.py: Enhanced utility functions
@yin1895
Copy link
Author

yin1895 commented Sep 26, 2025

Logitech drivers from around 2021 need to be installed

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant