Stronghold Kingdoms Bot

Disclaimer

This software is an external tool designed to automate playing Stronghold Kingdoms. It is designed to interact with the game only through existing user interfaces and comply with relevant laws and regulations. The package aims to provide simplified and user-friendly interaction with the game, and it is not intended to disrupt game balance in any way or provide any unfair advantages. The package will not modify any game files or game code in any way.

This software is open source, free of charge, and for learning and exchange purposes only. The developer team has the final right to interpret this project. All problems arising from the use of this software are not related to this project and the developer team. If you encounter a merchant using this software to practice on your behalf and charging for it, it may be the cost of equipment and time, etc. The problems and consequences arising from this software have nothing to do with it.

Working

auto-scout-demo.mp4

Auto Scouting.

auto-trade-demo.mp4

Auto Trade.

In the current implementation, the Stronghold Kingdoms Bot first executes the scouting flow and then proceeds to the trade flow, repeating this sequence in a continuous loop.

Requirements

• Android Debug Bridge
• Tesseract Open Source OCR Engine
• Python
• GNU Make

Getting Started

Quick Install

Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/brunocordioli072/stronghold-kingdoms-bot/main/scripts/install.ps1" -OutFile "./install.ps1"; &"./install.ps1"

Manual Setup

1. Install Chocolatey https://chocolatey.org/install#individual.
   • Chocolatey is a package manager for Windows. It is easier to install the needed dependencies with it.
2. Install Android Debug Bridge by running choco install adb on your terminal as admin.
   • Android Debug Bridge is command-line tool that enable communication with a device. It enables to send inputs directly to the emulator.
3. Install Tesseract Open Source OCR Engine by running choco install tesseract on your terminal as admin.
   • Tesseract is a free, open-source Optical Character Recognition (OCR) engine that converts images of text into machine-readable text.
4. Install Python by running choco install python --pre on your terminal as admin.
   • The programming language used for the project.
5. Install GNU Make by running choco install make on your terminal as admin.
   • GNU Make is a tool that automates the process of building and managing software projects.
6. Enable Android Debug Bridge on your emulator. (Bluestacks is recommended.)
   • Bluestacks: Settings > Advanced > Enable Android Debug Bridge.
7. Go to Stronghold Kingdoms app and in the game go to > Menu > Settings > Set User Interface Size > Set to minimum
8. Clone the repo by running git clone https://github.com/brunocordioli072/stronghold-kingdoms-bot.
9. Install the repo dependencies by running pip install -r ./requirements.txt
10. To use the bot, run make run on the root folder of the stronghold-kingdoms-bot with the Stronghold Kingdoms app open on Emulator.

Configuration

The first time the bot is run it will create a config.json on the root folder of the stronghold-kingdoms-bot that looks like this:

{
   "device_address": "127.0.0.1:your-port",
   "number_of_villages": 1,
   "interval_between_loop_in_seconds": 240,
   "village_1_name": "YourVillageName",
   "village_1_parish_coords": {
      "x": 1,
      "y": 1
   },
   "parish_trade_button_coords": {
      "x": 1,
      "y": 1
   },
   "sell": {
      "foods": {
         "apple": true,
         "cheese": true,
         "meat": true,
         "bread": true,
         "veggies": true,
         "fish": true,
         "ale": true
      },
      "luxury": {
         "venison": true,
         "furniture": true,
         "metalware": true,
         "clothes": true,
         "wine": true,
         "salt": true,
         "spices": true,
         "silk": true
      }
   }
}

You will need to replace these fields with the correct values. After that, run again make run, and the bot should start. Meaning of each field:

• device_address: Address of the device.
• number_of_villages: Number of villages the player has.
• interval_between_loop_in_seconds: This is the waiting time the bot has after doing the scouting and trading.
• village_1_name: Your first village name. No special characters.
• village_1_parish_coords: Coordinates of the village 1 parish. Use make coords to get this coordinates.
• parish_trade_button_coords: Coordinates of trade button on parish menu. Use make coords to get this coordinates.
• sell: Configuration for selling products on parish. Set false on product if you don't want to sell it.

Future Goals

• Auto scout for all villages.
• Auto trade for all villages.
• Auto attack enemies for all villages.
• Auto create troops for all villages.

⭐ If you like it, give it a star~ ⭐

Contributors

Thanks to the following contributors for their contributions to this project.