[Release] Grepolis Bot for Google Chrome

03/09/2013 19:57 0ptimist#1
This is a bot for the browser game Grepolis.
[Only registered and activated users can see links. Click Here To Register...]

Since images do not work in this Post, here is a link to an external Version of this guide complete with images:
[Only registered and activated users can see links. Click Here To Register...]

Requirements:
- the application requires microsoft .net framework 4.5 ([Only registered and activated users can see links. Click Here To Register...])
- the bot uses googles chrome browser which has to be installed separately ([Only registered and activated users can see links. Click Here To Register...])
- 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 ([Only registered and activated users can see links. Click Here To Register...]) 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".
[Only registered and activated users can see links. Click Here To Register...]


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.
[Only registered and activated users can see links. Click Here To Register...]

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.
[Only registered and activated users can see links. Click Here To Register...]

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.
[Only registered and activated users can see links. Click Here To Register...]

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)
[Only registered and activated users can see links. Click Here To Register...]

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.
[Only registered and activated users can see links. Click Here To Register...]

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.
[Only registered and activated users can see links. Click Here To Register...]