BTD 6 farmer | A Macro creator for Bloons td 6

Requirements & Dependencies

• Tesseract v5.0+
• Python 3.10+

keyboard==0.13.5
mouse==0.7.1
mss==6.1.0
numpy==1.22.3
opencv_python==4.5.5.64
pytesseract==0.3.9

Installation of dependencies:

Running the bot

1. Open up BTD 6
2. Run main.py in the command line with py <location of script>/main.py --path <directory to gameplan> or start run.bat to run with the default settings and gameplan. Some gamplans are included in the gameplans folder.
3. Navigate to the homescreen of BTD 6.

Bot Launch options

>> py main.py --help
options:
  -h, --help            show this help message and exit
  -p PATH, --path PATH, --gameplan_path PATH
                        Path to the gameplan directory
  -d, --debug           Enable debug mode
  -r, --restart         automatically restarts the game when finished, instead of going to home screen
  -s, --sandbox         Try put gameplan in sandbox mode without waiting for specific rounds

Having issues with the bot?

If you have any issues with the bot, find any bugs or have any suggestions for improvements, please create an issue or create a pull request!

Roadmap

Creating your own gameplans

You are really welcome to create your own gameplans using your own stratergies and submiting them to the repo with a pull request. I will add it to the repository after testing!

Contributing to the project

If you find any issues with the bot or have any suggestions for improvements, please create an issue. If you have any changes you would like to contribute with you can also create a pull request to the development branch!

NOTE: AS THIS IS STILL A WORK IN PROGRESS I MAY CHANGE THE GUIDE AND LAYOUT OF THE GAMEPLAN IN THE FUTURE FOR EASE OF USE. ALSO SOME FREATURES SPECIFIED IN THE DOCS ARE NOT YET IMPLEMENTED BUT ARE PLANNED TO

setup.json

The setup file is used for the bot to know which hero, map, difficulty and gamemode it should use. It should be named setup.json and be placed in the same directory as the gameplan.

{
    "VERSION": "1",
    "HERO": "OBYN",
    "MAP": "DARK_CASTLE",
    "DIFFICULTY": "HARD_MODE",
    "GAMEMODE": "STANDARD_GAME_MODE",
}

instructions.json

Creating the gameplan and example

The gameplan is a json file that contains the round as a key and the value as an array with instructions. All coordinates are normalized to you'r screen resolution, to work with a wider range of computers. (a value between 0 and 1)

instruction types

• START - Indicates the game
  • FAST_FORWARD - (true / false) Defaults to True. Should the bot play in fast forward mode?
• PLACE_TOWER - Place a tower on the map
  • MONKEY - Type of monkey to place
  • LOCATION - [x, y] position of tower to be placed
• UPGRADE_TOWER - Upgrade a tower on the map
  • LOCATION - [x, y] position of tower to be upgraded
  • UPGRADE_PATH - [top, middle, bottom] array of upgrades eg [1, 0, 1]
• CHANGE_TARGET - changes target of a tower
  • LOCATION - [x, y] location of the tower
  • TARGET - target or targets eg [ "FIRST", "LAST", "STRONG" ]. Can be a string or a array of targets
  • TYPE - (SPIKE or REGULAR) [Heli & gunner not yet supported]
  • DELAY - (optional) Defaults to 3 delay between each target change. Can also be an array of delays. Can be one delay eg 2 for 2 seconds or multiple [1, 3, 4] to sleep for 1 second, 3 seconds and 4 seconds respectively for each target change.
• REMOVE_TOWER - Removes a tower
  • LOCATION - [x, y] location of the tower
• SET_STATIC_TARGET
  • LOCATION - [x, y] location of tower
  • TARGET_LOCATION - [x, y] location of target
• END - (OPTIONAL) Finished instructions

An instruction array in a round can have multiple objects that will be executed after each other. for example:

    //...
    "33": [
        {
            "INSTRUCTION_TYPE": "PLACE_TOWER",
            "ARGUMENTS": {
                "MONKEY": "DRUID",
                "LOCATION": [ 0.399609375, 0.35347222222222224 ]
            }
        },
        {
            "INSTRUCTION_TYPE": "PLACE_TOWER",
            "ARGUMENTS": {
                "MONKEY": "DRUID",
                "LOCATION": [ 0.43984375, 0.35555555555555557 ]
            }
        },
        {
            "INSTRUCTION_TYPE": "PLACE_TOWER",
            "ARGUMENTS": {
                "MONKEY": "DRUID",
                "LOCATION": [ 0.479296875, 0.35833333333333334 ]
            }
        }
    ]
    //...

Getting the position of a tower or the target position.

An easy way to get the position of the tower or the target you want, is to use the following code:

import mouse, time
import tkinter
import static
import keyboard
import os
tk = tkinter.Tk()
width, height = tk.winfo_screenwidth(), tk.winfo_screenheight()
tk.destroy()
step = """
{{
    "INSTRUCTION_TYPE": "PLACE_TOWER",
    "ARGUMENTS": {{
        "MONKEY": "{0}",
        "LOCATION": [
            {1},
            {2}
        ]
    }}
}}
        """
def find_tower(letter):
    for tower in static.tower_keybinds:
        if static.tower_keybinds[tower] == letter:
            return tower
    return None

while True:
    for tower in static.tower_keybinds:
        print(static.tower_keybinds[tower].upper() + ". " +tower )

    print("Press the key of the tower you want the coords for or press O to quit")
    while True:
        if keyboard.read_key().lower() in static.tower_keybinds.values():
            letter = keyboard.read_key().lower()
            break
        elif keyboard.read_key().lower() == 'o':
            exit()
    tower = find_tower(letter)
    if tower:
        print("Press P to get the coords")
        while True:
            if keyboard.is_pressed('p'):
                os.system('cls')
                x, y = mouse.get_position()
                w_norm, h_norm = x / width, y / height
                print("Step:")
                print(step.format(tower, w_norm, h_norm))
                print("Press O to quit or press any other key to continue")
                while True:
                    if keyboard.read_key().lower() == 'o':
                        exit()
                    else:
                        os.system('cls')
                        break
                break

    else:
        print("Invalid tower")

Run it in a terminal and copy the decired position into the gameplan.

Stats

Keyword cheatsheet for the setup file and the gameplan