Guide

Setup specific guides

Serial
Wi-Fi
Ethernet
Not using any external hardware? Just hop straight into updating the config.

Download and install Arduino IDE

❗ THIS STEP IS ONLY REQUIRED IF YOU ARE USING EXTERNAL HARDWARE TO SEND MOUSE INPUT

• Go to https://www.arduino.cc/en/software
• Download and install the latest Arduino IDE version (2.x.x)
• If you are using a board with a RP2040 chip (fe. Raspberry Pi Pico): RP2040 board setup for Arduino IDE

Config

Aim

• bot_input_type is the communication type used.
  • winapi to use WinApi calls for mouse input
  • interception_driver to use the Interception driver for mouse input (https://github.com/oblitum/Interception)
  • microcontroller_serial to use serial communication
  • microcontroller_socket to use ethernet or Wi-Fi
• screen_center_offset moves the fov according to the offset
  
  Image: offset = 20
• aim_smoothing_factor sets the value used for calculating smoothess for the aimbot
  • Value should be between 0 and 1
• speed adjusts the mouse movement amount
  • This value depends on your hardware, dpi, and in-game sensitivity. Try to find a value that works for you
  • Decrease if aim is jittery
• y_speed_multiplier multiplies the speed for movements on the y-axis
• aim_height determines the vertical position of the aim
  • Value should be between 0 and 1
  • Value 0.5 aims at the center of the target
    
    Image: aim_height = 0.9

Communication

Configuration is only needed if you're using a microcontroller

• microcontroller_ip
• microcontroller_port
• com_port

Screen

• group_close_target_blobs_threshold sets the threshold used for detecting shapes on the screen
  Image with detection_threshold = 1, 1
  
  Image with detection_threshold = 3, 3
  

• upper_color and lower_color are used for target detection

  • See Finding target color range

• capture_fov_x and capture_fov_y set the width and height of the target detection area that is in the center of the screen

• aim_fov_x and aim_fov_y set the width and height of the aiming area
  

• max_loops_per_sec is the target "fps" Unibot will run

  • Lower this to lower CPU usage
  • Usually shouldn't be higher than your monitor's refresh rate

• auto_detect_resolution

  • true to detect your monitors resolution automatically
  • false if auto detection is not working
    • resolution_x your resolution width
    • resolution_y your resolution height

Recoil

• mode is the recoil method used
  • move for games where the bullet always hits the center of the screen
    • recoilX and recoilY set the move speed
  • offset for games where the recoil goes above crosshair
    • recoilY increases aiming offset when left button is pressed
    • max_offset is the maximum offset the recoil can have
    • recover sets how fast the recoil recovers when left button is not pressed

Trigger

• trigger_delay delays the triggerbot click
  • trigger_randomization adds a randomized 0-x ms delay
• trigger_threshold is the value used to check if a target is close enough to the center of the screen.
  • Using values below 8 will have false positives when crosshair is close to a target.

Rapid fire

• target_cps sets the maximum clicks per second

Key binds

Keys are read as their keycode value (Windows Virtual-Key Codes)

• key_reload_config reloads the config
  • F1 by default
• key_toggle_aim toggles aimbot
  • F2 by default
• key_toggle_recoil toggles recoil
  • F3 by default
• key_exit closes Unibot
  • F4 by default
• key_trigger activates the triggerbot while holding
  • Mouse5 by default
• key_rapid_fire activates rapid fire while holding
  • Mouse4 by default
• aim_keys sets aimbot on when any of the keys is pressed
  • off sets aimbot to be always on
  • Mouse1 and mouse2 by default

Debug

• enabled
  • true enables debug mode
• always_on
  • true makes the debug display update even while aimbot and triggerbot are not in use
• display_mode sets the FOV area image used for debugging
  • game displays the normal image
  • mask displays targets in white on a black background

Run Unibot

Python version 3.12.7

• Install requirements pip install -r requirements.txt
• Run main.py just like you would run any other Python script