BTD 6 farmer | A Macro creator for Bloons td 6

Inspired from RavingSmurfGB/Py_AutoBloons

Join the Discord for support, updates and sharing gameplans.

Feel free to make a pull request if you have any improvements or create a issue if something isn't working correctly!

Table Of Contents (TODO)

• Dependencies
• Installation
• Running the bot
• Having issues?
• Roadmap
• Creating your own gameplan
  • Setup file
  • Gameplan file
  • Stats
  • Keyword cheatsheet
    • Gamemodes
    • Difficulties
    • Maps
    • Heros
    • Monkeys

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:

The script relies on tesseract (tested with v5.3.0) which can be installed using this this guide. (If by any chance the tesseract installation directory is different from the directory specified in Bot.py you need to manually change that in the script. Otherwise the bot will not work!)

default path (all users tesseract installation):

pytesseract.pytesseract.tesseract_cmd = r'C:\Program Files\Tesseract-OCR\tesseract.exe'

The python library requirments can be installed using python -m pip install -r requirements.txt or by running Install_Requirements.bat

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

The projects roadmap can be found here

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",
}

Hero - Which hero to use list of avaliable heros
MAP - Which map to use list of avaliable maps
DIFFICULTY - Which Difficulty to use list of avaliable difficultues
GAMEMODE - Which Gamemode to use list of avaliable Gamemodes \

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)

The following example instruction places a tower on the absolute center of the map and starts the game in fast forward mode, on round 3. See instruction types for more information about the different types of instructions.

{
    "3": [
        {
            "INSTRUCTION_TYPE": "PLACE_TOWER",
            "ARGUMENTS": {
                "TOWER": "TOWER_TYPE",
                "POSITION": [ 0.5, 0.5 ]
            }
        },
        {
            "INSTRUCTION_TYPE": "START",
            "ARGUMENTS": {
                "FAST_FORWARD": true,
            }
        }
    ]
}

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

Experience points per level

Keyword cheatsheet for the setup file and the gameplan