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 media@fnbubbles420.org.

🚨 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
• License.md
• Code_of_Conduct.md
• Security.md

---

🌟 Funding 🌟

---

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 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.

---

---

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.

• Discord Link
• 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

---

Bubbles Advanced AI Anti Cheat Engine

BAAACE

---

🌟 About Us

At 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, 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.
If you'd like to get involved or learn more about volunteering, visit our Volunteer Page.

---

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

Click the link to read Instructions 📄.

---

Supported Languages on Readme.md

1. Nvidia

• Nvidia_Supported_Languages

2. AMD

• 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.

1. Install Python 3.11.9

• Download & Install:

  • Download Python version 3.11.9 from the use the python3119.bat
  • DONT RUN AS ADMIN , JUST DOUBLE CLICK ON THE .BAT
  • Follow the installation instructions for your operating system.

• Verify Installation:

  • Open your command prompt or terminal.
  • Run the command:

    python --version

  • Ensure the output reads:

    Python 3.11.9
    

---

- CLICK HERE FOR CPU USERS INSTALLATION SETUP GUIDE IS A MUST FOR CPU USERS

- CLICK HERE FOR AMD USERS INSTALLATION SETUP GUIDE IS A MUST FOR AMD USERS

- CLICK HERE FOR NVIDIA USERS INSTALLATION SETUP GUIDE IS A MUST FOR NVIDIA USERS

- FNBubbles420 Org Auto Setup

---

3. Running the Application

Using TensorRT

• Navigate to the main_tensorrt_script folder.
• Run the launcher.bat file:
  • You can either double-click the file or run it from the command prompt.

Using ONNX

• Navigate to the onnx folder.
• Run the launcher.bat file similarly by double-clicking it or running it from the command prompt.

4. Run the Bot:

After configuring the bot, navigate to the respective folder and start it by running:

• For the TensorRT bot, navigate to the main_tensorrt_script/dist/ folder and run:

cd main_tensorrt_script/dist/
python main_tensorrt.py

• For the ONNX bot, navigate to the main_onnx_script/dist/ folder and run:

cd main_onnx_script/dist/
python main_onnx.py

4. Adjusting Your Configuration

• Edit Configuration:
  • Run the config-launcher.bat file. This action will open config.py in Notepad.
  • Edit the configuration settings as needed.
  • Save your changes after editing.

🛠 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.

---

🛠️ 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 media@fnbubbles420.org.

🚨 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.