btd6farmer - a bot for Bloons Td 6

v1.0.0-pre_release-2

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

• Dependencies
• Installation
• Running the bot
• Gameplans
• Roadmap
• Having issues?
• 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 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.
3. Navigate to the homescreen of BTD 6.

note: make sure that you use the english version of the game, as the bot needs the english text to work properly.

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
  -v, --verbose         Enable verbose mode (not done)
  -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 (not done)

Current Gameplans

Map	Difficulty	Gamemode	Directory location
Dark Castle	Hard	Standard	./Instructions/Dark_Castle_Hard_Standard
Dark Castle	Hard	Chimps	./Instructions/Dark_Castle_Hard_Chimps

Roadmap

At the moment the major parts of being able to create own gameplans are done. Current things that needs to be done is:

• Support for different hero abilities
• Easier way to create gameplans

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!

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

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

{
    "VERSION": "1",
    "HERO": "OBYN",
    "MAP": "DARK_CASTLE",
    "DIFFICULTY": "HARD_MODE",
    "GAMEMODE": "STANDARD_GAME_MODE",
    "OPTIONS": { // TODO: Add options
        "COLLECT_BANANAS": true, 
        "OPEN_CHEST": true,
    }
}

VERSION - Use version 1 for now
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 \

OPTIONS

COLLECT_BANANAS - If the bot should automatically pick up bananas from traps and bananafarms
OPEN_CHEST - If the bot should automatically open chests if its unopened on the main menu

instructions.json

Creating the gameplan

The gameplan is a json file that contains the round as a key and the value as an array with instructions. The instructions is also a json object:

instructions.json example

{
    "3": [
        {
            "INSTRUCTION_TYPE": "PLACE_TOWER",
            "ARGUMENTS": {
                "TOWER": "TOWER_TYPE",
                "POSITION": [ x, y ]
            }
        },
        {
            "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) # TODO: add support for Heli targets
  • DELAY - (optional) Defaults to 3 delay between each target change, 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:

    ...
    [
        {
            "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 ]
            }
        }
    ]
    ...

Creating the gameplan in excel and converting to json

TODO

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:

"""
    Cordinates with this bot are normalized to work on all resolutions.
"""

import mouse, time
import tkinter

tk = tkinter.Tk()
width, height = tk.winfo_screenwidth(), tk.winfo_screenheight()
while True:
    
    x, y = mouse.get_position()
    w_norm, h_norm = x / width, y / height
    print(f"x: {w_norm} y: {h_norm}")
    time.sleep(0.1)

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

Stats

Experience points per level

Rounds	Beginner	Intermediate	Advanced	Expert
1-40 (Easy)	21 400	23 540	25 680	27 820
31-60 (Deflation)	45 950	50 545	55 140	59 735
1-60 (Medium)	56 950	62 645	68 340	74 035
3-80 (Hard)	126 150	138 765	151 380	163 995
6-100 (Impoppable/CHIMPS)	231 150	254 265	277 380	300 495

Keyword cheatsheet for the setup file and the gameplan

Gamemodes

TODO

Difficulties

TODO

Maps

Monkey	Keyword in file
Monkey Meadow	MONKEY_MEADOW
Tree Stump	TREE_STUMP
Town Center	TOWN_CENTER
Scrapyard	SCRAPYARD
The Cabin	THE_CABIN
Resort	RESORT
Skates	SKATES
Lotus Island	LOTUS_ISLAND
Candy Falls	CANDY_FALLS
Winter Park	WINTER_PARK
Carved	CARVED
Park Path	PARK_PATH
Alpine Run	ALPINE_RUN
Frozen Over	FROZEN_OVER
In The Loop	IN_THE_LOOP
Cubism	CUBISM
Four Circles	FOUR_CIRCLES
Hedge	HEDGE
End Of The Road	END_OF_THE_ROAD
Logs	LOGS
Quiet Street	QUIET_STREET
Bloonarius Prime	BLOONARIUS_PRIME
Balance	BALANCE
Encrypted	ENCRYPTED
Bazaar	BAZAAR
Adora's Temple	ADORAS_TEMPLE
Spring Spring	SPRING_SPRING
KartsNDarts	KARTSNDARTS
Moon Landing	MOON_LANDING
Haunted	HAUNTED
Downstream	DOWNSTREAM
Firing Range	FIRING_RANGE
Cracked	CRACKED
Streambed	STREAMBED
Chutes	CHUTES
Rake	RAKE
Spice Islands	SPICE_ISLANDS
Sunken Columns	SUNKEN_COLUMNS
X Factor	XFACTOR
Mesa	MESA
Geared	GEARED
Spillway	SPILLWAY
Cargo	CARGO
Pat's Pond	PATS_POND
Peninsula	PENINSULA
High Finance	HIGH_FINANCE
Another Brick	ANOTHER_BRICK
Off The Coast	OFF_THE_COAST
Cornfield	CORNFIELD
Underground	UNDERGROUND
Sanctuary	SANCTUARY
Ravine	RAVINE
Flooded Valley	FLOODED_VALLEY
Infernal	INFERNAL
Bloody Puddles	BLOODY_PUDDLES
Workshop	WORKSHOP
Quad	QUAD
Dark Castle	DARK_CASTLE
Muddy Puddles	MUDDY_PUDDLES
#Ouch	OUCH

Heros

Monkey	Keyword in setupfile
Quincy	QUINCY
Gwendolin	GWENDOLIN
Striker Jones	STRIKER_JONES
Obyn Greenfoot	OBYN
Captain Churchill	MONKEY
Benjamin	BENJAMIN
Ezili	EZILI
Pat Fusty	PAT_FUSTY
Adora	ADORA
Admiral Brickell	ADMIRAL_BRICKELL
Etienne	ETIENNE
Sauda	SAUDA
Psi	PSI
Geraldo	GERALDO

Monkeys

Monkey	Keyword in instruction
Hero	HERO
Dart Monkey	DART
Boomerang Monkey	BOOMERANG
Bomb Shooter	BOMB
Tack Shooter	TACK
Ice Monkey	ICE
Glue Gunner	GLUE
Sniper Monkey	SNIPER
Monkey Sub	SUBMARINE
Monkey Buccaneer	BUCCANEER
Monkey Ace	ACE
Heli Pilot	HELI
Mortar Monkey	MORTAR
Dartling Gunner	DARTLING
Wizard Monkey	WIZARD
Super Monkey	SUPER
Ninja Monkey	NINJA
Alchemist	ALCHEMIST
Druid	DRUID
Banana Farm	BANANA
Spike factory	SPIKE
Monkey Village	VILLAGE
Engineer Monkey	ENGINEER