Wiki

Introduction


TravBot is a desktop application that runs on your computer. It automates various tasks in the browser game Travian Legends. Travian Kingdoms is not supported. It works by creating a Google Chrome browser that the bot controls and can perform actions with like a human would. There are multiple ways to create this browser and will be discussed later.

System requirements


The bot is made to run on Windows, Linux and MacOS. It is developed and tested mainly on Windows and thus that is the preferred platform.
Before proceeding with the installation it is necessary that you have the following programs installed on your system.

Java

The bot requires Java to be installed on your computer. The minimum required version of Java is Java 8 Update 101 (Java 8u101). All newer versions of Java can be used too.
If you are planning to run the bot on a HiDPI display (Small laptops with high resolutions screens), it is recommended to install a version of Java 9 or above.

The latest version of Java 8 can be always found at java.com/en/download.
You can follow the instructions there to download an installer that should setup everything for you.

If you want to download a newer version of Java, you can install OpenJDK Java 11 from adoptopenjdk.net

On Ubuntu / Debian / Linux Mint you can usually install the latest JRE using sudo apt install default-jre or similarly using a package installer.

Alternatively you can install a newer version of JDK manually from adoptopenjdk.net.

On mac you can install Java from the Java 8 website java.com/en/download or a newer version of Java from adoptopenjdk.net

Google Chrome

The bot currently relies solely on Google Chrome as its controlled browser. The best case scenario is that you already have Chrome installed and using it to play travian.

If that's not the case you will need to manually install Chrome from the official website. You should be guided through the installation on all platforms.

Installation


Installing the bot is really simple since the downloaded archive is in itself portable. Follow these steps to start the bot.

  1. Download the latest version of the bot from the download page.
  2. Extract the downloaded .zip archive into a directory

    You can use an archive extracting tool like 7Zip or WinRAR. You can also use default preinstalled utilities the explorer on Windows.

    It is important to extract the archive because not doing so could cause rather odd and hard to troubleshoot problems. The bot will alert you if it detects a launch from an archive and will advise to extract the archive too.

  3. Start the bot
    • If you downloaded the Windows w version then you can simply run the TravBot .exe executable.

    • If you downloaded the multiplatform u version then you can start the .jar file as a regular .exe if you have Java installed and configured properly. It should be opened with the 'Java(TM) Platform SE binary'.
      If that doesn't work then you can always open up the Windows command line in the TravBot folder and run the command java -jar <path to the jar file> , for example java -jar TravBot10.jar

    For linux systems, it is necessary to download the multiplatform u version of TravBot. The .jar executable can then be run from a file manager if the default .jar opener is Java.
    Or it can be simply started from the terminal using java -jar <path to the jar file> , for example java -jar TravBot10.jar

    For mac, it is necessary to download the multiplatform u version of TravBot. The .jar executable can then be run from a file manager if the default .jar opener is Java.
    Or it can be simply started from the terminal using java -jar <path to the jar file> , for example java -jar TravBot10.jar

  4. The bot should start

    First window to show up is the console. This is the output console of the program that informs the user what the bot is currently doing, warns user about problems and displays errors if any occur. It is a good idea to keep an eye out on the console to get informed about problems. The console supports multi-colored text and all important issues get written out in red.

    If there are no problems the main TravBot window will open up and you can proceed with logging in the bot.