Data

Tools

Indexes

Applications

Experiments

Awesome

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

https://github.com/fnbubbles420-org/assistive-aimguide

This tool is designed to enhance accessibility for gamers with **physical disabilities** by providing advanced AI-driven aiming assistance. It helps to level the playing field, allowing everyone to enjoy competitive and casual gaming environments.
https://github.com/fnbubbles420-org/assistive-aimguide

accessibility accessibility-matters accessibility-tool ai aim amd-gpu assistive-aimguide charity cpu disability-assistance disability-resources fnbubbles420org mental-health non-profit-organization nvidia-gpu physical-challenges supported-languages veteran-support yolov5 yolov8

Last synced: 2 months ago
JSON representation

This tool is designed to enhance accessibility for gamers with **physical disabilities** by providing advanced AI-driven aiming assistance. It helps to level the playing field, allowing everyone to enjoy competitive and casual gaming environments.

Awesome Lists containing this project

README 

        


  Assistive-AimGuide






  Fnbubbles420 Logo

  Fnbubbles420 Logo

  




  
FNBubbles420 Org - Assistive Aim-Guide



----



# 🚨 READ THE ENTIRE README.MD & ALL DOCUMENTS EVERYTHING CAREFULLY !!! 🚨



---

# LICENSE

## ***This project is proprietary and all rights are reserved by the author.***

## ***Unauthorized copying, distribution, or modification of this project is strictly prohibited.***

## ***Unless You have written permission from the Developer or the FNBUBBLES420 ORG.***



# Copyright Notice



© 2024 Bubbles The Dev and FNBUBBLES420ORG. All rights reserved.



This image, including its design, text, and visual elements, is protected under copyright law. Unauthorized use, reproduction, distribution, or modification without the express written permission of Bubbles The Dev and FNBUBBLES420ORG is prohibited. For licensing or usage inquiries, please contact [[email protected]](mailto:[email protected]).



## 🚨 Legal and Compliance

- This tool is intended for educational and accessibility purposes within environments that support inclusivity.

- We do not endorse or promote cheating. Use of this tool in violation of game terms may result in bans or penalties.

- For any concerns about compatibility with game policies, consult game developers.



## 🚨**Important**🚨: Please ensure you read the following documents before using the tool:

- **[Readme.md](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/blob/main/readme.md)**

- **[License.md](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/blob/main/LICENSE.md)**

- **[Code_of_Conduct.md](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/blob/main/CODE_OF_CONDUCT.md)**

- **[Security.md](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/blob/main/SECURITY.md)**

---



# 🌟 [Funding](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/blob/main/.github/FUNDING.yml) 🌟



---

## Support the Project ⭐



# **If you find this project useful, Please Join Our Discord , We Have Lots to Offer, great community , supportive community, mental health support, and more [CLICK TO JOIN DISCORD SERVER](https://discord.gg/8kbgcEugQu)** your support is appreciated.

## FNBubbles420 Org is committed to creating an inclusive environment that supports all individuals, especially those dealing with mental health issues or physical disabilities. Our efforts are focused on providing adaptive technology, mental health resources, peer support groups, and creating educational programs that promote accessibility and mental wellness.



          💙 Built with accessibility in mind by the FNBUBBLES420 Organization.

---

---

## Introduction

Welcome to the **Assistive AimGuide** project!  

This tool is designed to enhance accessibility for gamers with **physical disabilities** by providing advanced AI-driven aiming assistance. It helps to level the playing field, allowing everyone to enjoy competitive and casual gaming environments.



## 🚀 Features

- 🎯 **Adaptive Aim Assistance**: Tailors aiming assistance to the specific needs of gamers with physical disabilities, using `YOLOv5` and `YOLOv8` and `YOLOv11` detection models.

- 🔫 **Precision Control**: Allows for fine-tuning of aiming settings to ensure accessibility without overpowering gameplay.

- 🖼️ **Customizable Zones**: Enables users to define areas on the screen for the tool to assist with, adapting to various game layouts and preferences.

- 💻 **Dynamic Performance Adjustment**: Manages resolution and processing based on system performance to maintain smooth gameplay.

- 🤖 **Arduino Leonardo** (***RECOMMENDED***): Integrates with Arduino for additional customization and hardware-based controls.

---

---

## Discord Support

Join our Discord channel **Assistive AimGuide** for assistance, support, or to share your experience.  



- **[CLICK TO JOIN DISCORD SERVER](https://discord.gg/8kbgcEugQu)**

- or Join to Support Fnbubbles420 Org & The Mission.

- Our community is growing be apart of something BIG!!

---

## 🚨 Disclaimer



This tool is developed as an **accessibility aid** for gamers with disabilities to help them compete more effectively in games.  

We **advocate for fair play** and accessibility in gaming and do **not endorse cheating** or the promotion of cheating in any form.  

Use of this tool in online games is at your own risk. Please consult with game developers if unsure about compatibility with game policies.  

This tool should be used primarily as an assistive device in environments that support inclusivity.



- **[Assistive-AimGuide-Feedback](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/blob/main/Assistive-AimGuide-Feedback.md)**



---



## Bubbles Advanced AI Anti Cheat Engine



### ***[BAAACE](https://github.com/KernFerm/Bubbles-Advanced-Ai-Anti-Cheat-Engine)***



---

## 🌟 About Us



At **[FNBubbles420 Org](https://github.com/FNBUBBLES420-ORG)**, we are dedicated to supporting **disabled gamers, developers, veterans, and streamers** through various initiatives. One of our primary programs is **[Game Vision Aid](https://github.com/FNBUBBLES420-ORG/game-vision-aid)**, which aims to enhance accessibility and performance for gamers with visual impairments.  



**Game Vision Aid is coming soon** — we are still testing and developing it to ensure it meets the highest standards for accessibility.



While the **Assistive AimGuide** is a separate project, it embodies our organization's dedication to leveraging innovative technologies to enhance accessibility and equality in gaming for those with disabilities. This commitment underlines our ongoing efforts to serve and uplift the community.



---

### 💬 Words to Live By  

*"Life is a journey best traveled together; when we lift each other up, we rise as a community, stronger and more united. Every small act of kindness creates ripples that can change the world."*  

– **Bubbles**



---

To learn more about what drives us, visit our **[Mission Page](https://www.fnbubbles420.org/ourmission)**.  

If you'd like to get involved or learn more about volunteering, visit our **[Volunteer Page](https://www.fnbubbles420.org/volunteer)**.



---

## 📥 How to Download the Repo (First-Time Users)



Click the link to read [**Instructions**](https://www.gitprojects.fnbubbles420.org/how-to-download-repos) 📄.



### Download ZIP:

1. 📥 Click the green `"Code"` button at the top right of the repository page.

2. 📂 Choose `"Download ZIP"` from the dropdown menu.

3. 📁 This will download a `ZIP file` with the entire repository.

### Extract the ZIP File:

1. 🗂 Find the downloaded `ZIP file` on your computer.

2. 🔧 `Extract` it using your computer's built-in extraction tool or a third-party tool like `WinRAR` or `7-Zip`.



----

### Supported Languages on Readme.md

1. **Nvidia**

- ***[Nvidia_Supported_Languages](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/tree/main/Supported_Languages/Nvidia-Supported_Languages)***

2. **AMD**

- ***[AMD_Supported_Languages](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/tree/main/Supported_Languages/AMD-Supported_Languages)***

---



- `update_ultralytics.bat` **ALWAYS CHECK FOR UPDATES COUPLE TIME EVERY FEW WEEKS !!**

---



## Assistive Aimguide Installation Instructions

- Follow these steps to set up and run **assistive aimguide** on your system. If you encounter any issues, double-check that all paths are correct and that you have the necessary permissions to run these scripts.

- This guide explains how to install and run **assistive aimguide** on your system.



---

# - [CLICK HERE FOR CPU USERS INSTALLATION SETUP GUIDE IS A MUST FOR CPU USERS](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/tree/main/Main-CPU-Users/main_cpu_script/dist)

# - [CLICK HERE FOR AMD USERS INSTALLATION SETUP GUIDE IS A MUST FOR AMD USERS](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/tree/main/Main-AMD-Users/main_amd_scripts/dist)

# - [CLICK HERE FOR NVIDIA USERS INSTALLATION SETUP GUIDE IS A MUST FOR NVIDIA USERS](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/tree/main/Main-NVIDIA-Users)

# - [FNBubbles420 Org Auto Setup](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/tree/main/Assistive-Aim-guide-Auto-Setup)

# GOT ISSUES ??

## [GOT ISSUES CLICK HERE](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/blob/main/GOT-ISSUES%3F.MD)

# [Not-Using-Correct-Model - getting a warning??](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/blob/main/Not-Using-Correct-Model.md)

---



---

# If you Support us make sure to follow [https://github.com/FNBUBBLES420-ORG](https://github.com/FNBUBBLES420-ORG)

---



## 🛠 Requirements



To run the bot, ensure the following dependencies are installed:



- **Python 3.11.9** – The required Python version for compatibility.

- **OpenCV** – For handling image capture and processing (`pip install opencv-python`).

- **PyTorch** – For deep learning and model inference (`pip install torch`).

- **Cupy** – For utilizing CUDA-based GPU acceleration (`pip install cupy-cuda11x`).

- **BetterCam** – For capturing and processing live game frames. `Enhanced Advanced`

- **Comtypes** – For interacting with the Windows API (`pip install comtypes`).

----



### 3. Configure settings:

Open the `config.py` file and adjust the following settings according to your preferences:



- **screenShotHeight** and **screenShotWidth:** Define the portion of the screen to be captured around the center.

- **useMask, maskSide, maskWidth, and maskHeight:** Set these to mask parts of the screen where a model or object might interfere (useful in third-person games or for large weapons).

- **aaMovementAmp:** Controls how smooth the aim is. Adjust based on your preference and game type.

- **aaQuitKey:** Default is `8`, press this key to quit and shut down the auto-aim.

- **aaActivateKey** = `CapsLock`, press to toggle the autoaim

- **confidence:** Adjust detection confidence level for the target (default is `0.4`).

- **headshot_mode:** Set to `True` to aim slightly upwards towards the head.

- **cpsDisplay:** Set to `True` if you want to display corrections per second in the terminal (for debugging purposes).

- **visuals:** Set to `True` to display what the bot "sees" (bounding boxes, etc.).

- **centerOfScreen:** Prioritize targets near the center of the screen for smarter target selection.

- **onnxChoice:** Choose between `2` (AMD for nvidia), or `3` (NVIDIA) when using ONNX models.

- **model_path:** Uncomment the correct path based on whether you're using a TensorRT engine or ONNX model.

  - Use `v5.engine` for TensorRT.

  - Use `v5.onnx` for ONNX.

- **device:** Set to `'cpu'` or `'cuda'` depending on whether you're running on CPU or GPU.

- **fp16:** Set to `True` to use FP16 for faster inference on supported GPUs.



## 🔧 Configuration Options

Modify settings in the `config.py` file to customize bot behavior:

- **Auto Aim Movement**: Change the `aaMovementAmp` value to control how smoothly the bot adjusts aim.

- **Headshot Mode**: Toggle headshot prioritization with `headshot_mode`.

- **Screen Resolution**: Adjust the aim area using `screenShotWidth` and `screenShotHeight`.

- **Masking**: Configure `useMask`, `maskSide`, `maskWidth`, and `maskHeight` to ignore certain screen areas.

- **Quit Key**: Set `aaQuitKey` to customize the key used to quit the bot (default is 8).

- **Activation Key**: Use Caps Lock to toggle the bot on/off.

- **Confidence Level**: Adjust the target detection confidence using the `confidence` setting.

- **Visual Feedback**: Enable visual overlays with `visuals` to see what the bot detects.

- **Center Targeting**: Use `centerOfScreen` to prioritize center-screen targets.

- **ONNX Provider**: Choose between AMD or NVIDIA execution with `onnxChoice`.

- **Model Path**: Specify the model file path in `model_path`, supporting `.engine` or `.onnx`.

- **Device**: Set execution to 'cpu' or 'cuda' with `device`.

- **FP16 Mode**: Enable `fp16` for faster processing on compatible GPUs.



## Usage Instructions



### Activation

- **Start/Stop**: Use the `Caps Lock` key to toggle the bot on and off based on your game settings.



### Adjustments

- **Aim Adjustment**: The bot automatically detects targets and prioritizes those near the center of the screen. It adjusts the aim smoothly. Adjust aim behavior through `aaMovementAmp` and other settings in `config.py`.

- **Speed Values for Aim Adjustment**:

  - Slow: 0.2 - 0.4

  - Medium: 0.5 - 0.7

  - Fast: 0.8 - 1.0

  - Very Fast: 1.1 - 1.5+



### Special Modes

- **Headshot Mode**: Enable this mode to make the bot aim slightly upwards to target heads by setting `headshot_mode` to True.



### Quitting

- **Exit**: Press the '8' key to stop and exit the bot.



# GOT ISSUES ??

## [GOT ISSUES CLICK HERE](https://github.com/FNBUBBLES420-ORG/Assistive-AimGuide/blob/main/GOT-ISSUES%3F.MD)



---

## 🛠️ Tested Environment



The project has been successfully tested on the following setup:



- **Processor**: Intel(R) Core(TM) i7-14700F @ 2.10 GHz

- **GPU**: NVIDIA GeForce RTX 4060 Ti

- **Operating System**: Windows 11

- **Python Version**: 3.11.6

---

- **Processor**: AMD Ryzen 9 7900X 12-Core Processor @ 4.70 GHz

- **GPU**: DUEL GPU: "NVIDIA GeForce RTX 4060 Ti" "AMD Radeon"

- **Operating System**: Windows 11

- **Python Version**: 3.11.6 , 3.11.9



### Works On

- **Nvidia GPU**

- **AMD GPU**

- **CPU**

- **Multiple Monitor Support**

- **Mobile** support

- 

---



# LICENSE

## ***This project is proprietary and all rights are reserved by the author.***

## ***Unauthorized copying, distribution, or modification of this project is strictly prohibited.***

## ***Unless You have written permission from the Developer or the FNBUBBLES420 ORG.***



# Copyright Notice



© 2024 Bubbles The Dev and FNBUBBLES420ORG. All rights reserved.



This image, including its design, text, and visual elements, is protected under copyright law. Unauthorized use, reproduction, distribution, or modification without the express written permission of Bubbles The Dev and FNBUBBLES420ORG is prohibited. For licensing or usage inquiries, please contact [[email protected]](mailto:[email protected]).



## 🚨 Legal and Compliance

- This tool is intended for educational and accessibility purposes within environments that support inclusivity.

- We do not endorse or promote cheating. Use of this tool in violation of game terms may result in bans or penalties.

- For any concerns about compatibility with game policies, consult game developers.