[Release] Grepolis Bot for Google Chrome

[0ptimist]

This is a bot for the browser game Grepolis.


Since images do not work in this Post, here is a link to an external Version of this guide complete with images:


Requirements:
- the application requires microsoft .net framework 4.5 ()
- the bot uses googles chrome browser which has to be installed separately ()
- some of the bot features only work on accounts which have the premium advisors "Administrator" and "Captain" activated.


Bot features:
- activating militia before incoming attack
- farming via Farm Town Overview (can be configured for time-of-day dependend activity)
- captcha solving (this also works with the word captcha (recaptcha) which was introduced in 2013)
- trading between own towns
- trading with farm towns
- customizable automatic building
- easy switching between botting and manual control without restarting the bot or browser


Quick start guide:
- install google chrome () if it is not already installed on your system
- open the bot from the download below ("Grepolis Bot.exe")
- in the bot, go to the Browser tab and enter the path to the file "chrome.exe" of the previously installed chrome browser. The bot then opens a new browser window by starting the browser from the supplied path.
- in the bot, go to the Grepo -> Settings tab and enter the URL to your grepolis world (example: "http://en51.grepolis.com/game/index")
- in the bot, go to the store settings tab and press the buttons "save current state to file"
- in the browser window which was opened in by the bot, log into your grepolis account.
- Done!


Detailed guide:

enabling botting functions:
the bot is divided into several functions "Farm", "Build", "Trade between own towns", etc.... these functions can be enabled independently from each other. Normally there will be several functions enabled at any given time. The bot will then decide which function to execute next according to their priority (for example the militia function is more important then the farming and will thus disrupt the farming as soon as an incoming attack is sighted)
In the tab "Grepo"->"Bot"->"function configuration" all available functions are listed. There you'll also see which of the functions are enabled and which one is currently active.
Select one of the functions in the list to display the details of the selected function. On the right side you will then be able to control whether the function is enabled or not.
To enable the function you then have to check the checkbox on the right side of the label "enabled by User".



saving your configuration:
to save the current configuration, go to the tab titled "store settings". The configuration will be loaded each time the connection to the bot-server is established. Therefore be sure to save any changes before you leave the bot if you want them to be persistent. The settings are divided into two groups named "general settings" and "grepo world account specific settings". Anything that is configured in the Tab titled "Grepo" belongs to the "grepo world account specific settings". You can save the current settings anytime by clicking the button "save current state to File".


the town list:
in the tab "Grepo"->"Town" there is a list containing your towns with their id, name, island coordinates, points, etc....
select an entry in this list to view the towns details on the right. In the Town details, you see status information (available resources, available trading capacity, ....) and also controls to enable specific functions on this town.


setup militia:
requires premium advisor "Administrator".
In addition to globally enable the miltia function, it also has to be enabled town-wise. If in the town detail control in the section "Militia" the box "in Response to Attack" is checked, militia will be activated if the time to arrival is less then the value entered in the box under the Label "Time between activation and attack". You can leave the time value empty, the bot will then use the default value of 179 minutes.


setup trading between own towns:
requires premium advisor "Administrator".
requires premium advisor "Captain".
Has to be enabled Town-wise (sending and receiving can be enabled independently town-wise).
When enabled, towns will exchange resources according to their supply priority which is configured in the section "Resource distribution" in the town settings.


setup farming:
requires premium advisor "Captain".
Farming has lowest priority of all functions, if all other enabled functions are done, the bot starts farming if its enabled.
Farming will only be done for towns with less than 95% filled storage.

setup captcha solving:
simply activate the function titled "captcha" and it will try to read and enter captchas as they appear. Note: If you get two captchas in a row or a captcha shortly after login, it won't be solved immediately. The bot will then wait some time before attempting to read the captcha. (But you'll be informed about this in the report of the captcha function)


pausing the bot:
If you want to interact with the browser manually, you should pause the bot so that it doesn't disturb you (for example by switching the active town). Use the buttons "pause" and "play" in the Grepo tab to pause / continue the bot.


using the scheduler:
Each bot function has its own schedule and I recommend to use the scheduler for the farming function. The schedule can modified with the control under the label "daily schedule". This control shows a linear timeline from left to right representing a whole calendar day (time-zone as shown in this control is determined by the servers time-zone). green areas represent a timespan in which the function is enabled by the schedule and the striped areas represent timespans in which the function is disabled. you will also see a blue bar in the timeline which is showing the current time. To modify the schedule, right-click on a existing area to delete it or left click an drag to the right to create a new area.