Ecosyste.ms: Awesome

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

https://github.com/SunOner/yolov8_aimbot

Aim-bot based on AI for all FPS games
https://github.com/SunOner/yolov8_aimbot

ai ai-aimbot aimbot cs2 destiny2 fortnite gpu nvidia pubg python rust tensorrt ultralytics warface yolov8

Last synced: 2 months ago
JSON representation

Aim-bot based on AI for all FPS games

Lists

README 

        



# YOLOv8 Aimbot

[![Python Version](https://img.shields.io/badge/Python-3.11.6-FFD43B?logo=python)](https://github.com/SunOner/yolov8_aimbot)

[![License MIT](https://badgen.net/github/license/SunOner/yolov8_aimbot)](https://github.com/SunOner/yolov8_aimbot/blob/main/LICENSE)

[![Github stars](https://img.shields.io/github/stars/SunOner/yolov8_aimbot?color=ffb500)](https://github.com/SunOner/yolov8_aimbot)

[![Discord server](https://badgen.net/discord/online-members/sunone)](https://discord.gg/sunone)

  


    

      

  





## Overview

YOLOv8 Aimbot is an AI-powered aim bot for first-person shooter games. It leverages the YOLOv8 model, PyTorch, and various other tools to automatically target and aim at enemies within the game. The AI model in repository has been trained on more than 25,000 images from popular first-person shooter games like Warface, Destiny 2, Battlefield 2042, CS:GO and CS2.

> [!WARNING]

> Use it at your own risk, we do not guarantee that you may be blocked!



> [!NOTE] 

> This application only works on Nvidia graphics cards. AMD support is testing. See [AI_enable_AMD](https://github.com/SunOner/yolov8_aimbot?tab=readme-ov-file#ai) option.

> The recommended graphics card for starting and more productive and stable operation starts with the rtx 20 series.



## Requirements

Before you get started, make sure you have the following prerequisites installed and pay attention to the versions in [Tested Environment](https://github.com/SunOner/yolov8_aimbot?tab=readme-ov-file#tested-environment) block, this may cause errors in launching the aimbot.



- Information in English:

  - [Auto-Install guide](https://github.com/SunOner/yolov8_aimbot/blob/main/docs/en/helper_en.md)

  - [Self install guide](https://github.com/SunOner/yolov8_aimbot/blob/main/docs/en/install_guide_en.md)

  - [Questions and answers](https://github.com/SunOner/yolov8_aimbot/blob/main/docs/en/questions_en.md)

  - [Arduino setup](https://github.com/SunOner/HID_Arduino)

  - [Discord server](https://discord.gg/sunone)




- Информация на Русском языке:

  - [Инструкция по автоматической установке](https://github.com/SunOner/yolov8_aimbot/blob/main/docs/ru/helper_ru.md)

  - [Инструкция по установке в ручную](https://github.com/SunOner/yolov8_aimbot/blob/main/docs/ru/install_guide_ru.md)

  - [Вопросы и ответы](https://github.com/SunOner/yolov8_aimbot/blob/main/docs/ru/questions_ru.md)

  - [Установка ардуино](https://github.com/SunOner/HID_Arduino)

  - [Discord сервер](https://discord.gg/sunone)




- To launch the aimbot after all installations, type `py run.py` or `py launcher.py` to open gui settings.



## Tested Environment

### The YOLOv8 Aimbot has been tested on the following environment:



  Windows10 and 11(priority)

  Python:3.11.6

  CUDA:12.4

  TensorRT:10.0

  Ultralytics:8.1.46

  Boosty AI Model:0.5.2



## Options

The behavior of the aim bot can be configured via the [`config.ini`](https://github.com/SunOner/yolov8_aimbot/blob/main/config.ini) file. Here are the available options:



### Object Search window resolution:

- detection_window_width `int`: Horizontal resolution of the object search window.

- detection_window_height `int`: Vertical resolution of the object search window.



### Bettercam capture method:

- Bettercam_capture `bool`: Use [Bettercam](https://github.com/RootKit-Org/BetterCam) to capture images from the screen.

- bettercam_capture_fps `int`: Specific fps value for screen capture.

- bettercam_monitor_id `int`: Id of the monitor from which the images will be captured.

- bettercam_gpu_id `int`: Id of the GPU to be used for image capture



### Obs capture method:

- Obs_capture `bool`: Use [Obs](https://github.com/obsproject/obs-studio) to capture images from the screen.

- Obs_camera_id `str` or `int`: `auto` or number of Virtual Camera ID.

- Obs_capture_fps `int`: Specific fps value for screen capture.



### Aim:

- body_y_offset `float`: Allows correction of y coordinates inside the body detected box if head is not detected.

- hideout_targets `bool`: Allows shooting at targets on the range (for example in warface on the polygon or in aimlabs).

- disable_headshot `bool`: Disable head targerting.



### Hot keys:

- The names of all the keys are [here](https://github.com/SunOner/yolov8_aimbot/blob/main/logic/buttons.py). Type `None` is empty button.

- hotkey_targeting `str`: Aiming at the target. Supports multi keys, for example `hotkey_targeting = RightMouseButton,X2MouseButton`

- hotkey_exit `str`: Exit.

- hotkey_pause `str`: Pause AIM.

- hotkey_reload_config `str`: Reload config.



### Mouse:

- mouse_dpi `int`: Mouse DPI.

- mouse_sensitivity  `float`: Aim sensitivity.

- mouse_fov_width  `int`: The current horizontal value of the viewing angle in the game.

- mouse_fov_height  `int`: The current vertical value of the viewing angle in the game.

- mouse_lock_target `bool`: True: Press once to permanently aim at the target, press again to turn off the aiming. False: Hold down the button to constantly aim at the target.

- mouse_auto_aim `bool`: Automatic targeting.

- mouse_ghub `bool`: Uses Logitech GHUB exploit for mouse movement. If the value is False, native win32 library is used for movement.



### Shooting:

- auto_shoot `bool`: Automatic shooting. (For some games need [arduino](https://github.com/SunOner/HID_Arduino)).

- triggerbot `bool`: Automatic shooting at a target if it is in the scope, requires the `mouse_auto_shoot` option enabled, and aiming will also be automatically turned off.

- force_click `bool`: Shooting will be performed even if the sight is not located within the object.



### Arduino:

- arduino_move `bool`: Sends a command to the arduino to move the mouse.

- arduino_shoot `bool`: Sends a command to the arduino to fire with the mouse.

- arduino_port `str`: Arduino COM port. Use `COM1` or `COM2` ... or `auto`.

- arduino_baudrate `int`: Custom Arduino baudrate.



### AI:

- AI_model_name `str`: AI model name.

- AI_model_image_size `int`: AI model image size.

- AI_conf `float`: How many percent is AI sure that this is the right goal.

- AI_device `int` or `str`: Device to run on, `0`, `1`... or `cpu`.

- AI_enable_AMD `bool`: Enable support Amd GPUs. Install ROCm and pytorch. See [AMD docs](https://rocm.docs.amd.com/projects/install-on-windows/en/latest/how-to/install.html).

- AI_mouse_net `bool`: Use a neural network to calculate mouse movements. See [this repository](https://github.com/SunOner/mouse_net).



### Debug window:

- show_window `bool`: Shows the OpenCV2 window for visual feedback.

- show_detection_speed `bool`: Displays speed information inside the debug window.

- show_window_fps `bool`: Displays FPS in the corner.

- show_boxes `bool`: Displays detectable objects.

- show_labels `bool`: Displays the name of the detected object.

- show_conf `bool`: Displays object confidence threshold for detection.

- show_target_line `bool`: Shows the mouse finishing line.

- show_target_prediction_line `bool`: Show mouse prediction line.

- debug_window_always_on_top `bool`: The debug window will always be on top of other windows.

- spawn_window_pos_x `int`: When the debugging window starts, it takes the x position.

- spawn_window_pos_y `int`: When the debugging window starts, it takes the y position.

- debug_window_scale_percent `int`: Adjusts the size of the debug window.

- The names of the debugging window can be written in the file window_names.txt they will be randomly selected.



## AI Models

- *.pt: Default AI model.

- *.onnx: The model is optimized to run on processors.

- *.engine: Final exported model, which is faster than the previous two.



## Export .pt model to .engine

1. All commands are executed in the console window:

2. First, go to the aimbot directory using the command:

```cmd

cd C:\Users\your_username\downloads\yolov8_aimbot-main

```

3. Then export the model from the .pt format in .engine format.

```cmd

yolo export model="models/sunxds_0.4.1.pt" format=engine device=0 imgsz=480 half=True

```

  - `model="model_path/model_name.pt"`: Path to model.

  - `format=engine`: TensorRT model format.

  - `half=true`: Use Half-precision floating-point format.

  - `device=0`: GPU id.

  - `workspace=8`: GPU max video memory.

  - `verbose=False`: Debug stuff. Convenient function, can show errors when exporting.



## Notes / Recommendations

- Limit the maximum value of frames per second in the game in which you will use it. And also do not set the screen resolution to high. Do not overload the graphics card.

- Do not set high graphics settings in games.

- Limit the browser (try not to watch YouTube while playing and working AI at the same time, for example (of course if you don't have a super duper graphics card)) and so on, which loads the video card.

- Try to use TensorRT for acceleration. `.pt` model is good, but does not have as much speed as `.engine`.

- If the program is running, everything is detected, but the mouse itself is not aimed at the target, then try running the program as an administrator.

- Turn off the cv2 debug window, this saves system resources.

- Do not increase the object search window resolution, this may affect your search speed.

- If you have started the application and nothing happens, it may be working, close it with the F2 key and change the show_window setting to Yes in the file [config.ini](https://github.com/SunOner/yolov8_aimbot/blob/main/config.ini) to make sure that the application is working.



## Support the project

I will post new models [here](https://boosty.to/sunone).



## License

This project is licensed under the MIT License. See **[LICENSE](https://github.com/SunOner/yolov8_aimbot/blob/main/LICENSE)** for details