Ikabot - (Ikariam Bot)
Ikabot is a cross-platform program written in python that grants equal or even more functionality than a premium account in ikariam, without spending ambrosia!
Features
| # | Feature | Description |
|---|---|---|
| 0 | Exit | Closes the main menu, returning to the normal console. You can also use ctrl-c. When closing ikabot, all the actions that you configured will continue running in the background. If you want to see which actions are running, simply run ikabot and log into the account from which you initiated those actions. You will be able to see their PIDs and will be able to kill them using kill -9 [pid] on Unix or using Task Manager on Windows |
| 1 | Construction list | The user selects a building, the number of levels to upload, ikabot calculates if it has enough resources and uploads the selected number of levels. If you don't have enough resources, it can send them automatically from the cities that you specify. |
| 2 | Send resources | It sends unlimited amount of resources from one city to another. It doesn't matter how many boats you have, ikabot will send all the trips that were necessary. The destination city can be own by the user or by other. |
| 3 | Distribute resources | It lets you distribute the type of resource in two possible ways: from the cities that produce it to cities that do not (very useful to send wine) and to distribute it evenly among all cities. |
| 4 | Account status | It shows information such as levels of the buildings, time until the wine runs out, resources among other things from all the cities. |
| 5 | Monitor islands | This functionality alerts by telegram, if a city disappears or if someone creates a city in any of the islands where the user has at least one city or any user defined island or set of islands. |
| 6 | Login Daily | For those who do not want to spend a day without their account login. This feature also collects the ambrosia fountain if it is available. |
| 7 | Alerts / Notifications |
- Alert attacks, it alerts by Telegram if you are going to be attacked. You can configure how often ikabot checks for incoming attacks. - Alert wine running out, it warns you by Telegram when less than N hours are needed for a city to run out of wine. The number of hours is specified by the user. |
| 8 | Marketplace |
- Buy resources, it allows you to choose what type of resource to buy and how much. It automatically purchases the different offers from the cheapest to the most expensive. - Sell resources, it allows you to choose what type of resource to sell and how much. It does not matter how much storage you have, it automatically updates the offers as players buy from you. When it sells all the resources, it lets you know via Telegram. |
| 9 | Donate |
- Donate, it allows you to donate (WOW!). - Donate automatically, Ikabot enters once a day and donates a percentage of the available wood from the selected cities to the luxury good or the forest. |
| 10 | Activate Vacation Mode | Sets the account in vacation mode and closes ikabot. |
| 11 | Activate miracle | It allows you to activate any miracle you have available as many times in a row as you want. |
| 12 | Military actions |
- Train army It allows you to easily create large amounts of troops or fleets in one city. If there are not enough resources to train all of them, it will train all the units it can and when it finishes it will try to train the rest. It also allows you to build your army in multiple small steps so that you can use it as fast as possible. - Send troops/ships It allows you to move your troops or ships from one city to another, or concentrate your entire army into one city (if they are spread out between multiple cities) |
| 13 | See movements | Let's you see movements coming to/from your cities. This includes attacks, transports, etc. |
| 14 | Construct building | It allows you to contruct a building (WOW!, again). |
| 15 | Update Ikabot | It tells you how to update ikabot |
| 16 | Import / Export cookie | You can use this feature to insert your ikabot cookie into your browser or other ikabot instances running on a different machine. This will result in ikabot not logging you out of your browser Ikariam session. Keep in mind that logging into Ikariam from another browser will invalidate all previous cookies, and you will need to do this again if that happens. |
| 17 | Auto-Pirate | This feature will run any available piracy mission as many times as you need it to. It will also attempt to automatically solve the captcha should it be presented with one. |
| 18 | Investigate | It allows you to investigate an available research. |
| 19 | Attack barbarians | Now you can attack the barbarians in an automated way. You can send your troops in many rounds and it will automatically collect the resources. |
| 20 | Dump / View world | Create a dump file containing all data about the world you are playing on. You can also search this dump later for a specific player's cities or islands with specific miracles and forest / luxury resource levels. |
| 22 | Configure Proxy | It lets you configure a proxy that will be used to all request except those sent to the lobby (during login). The proxy affects immediately all processes associated with the current ikariam username. |
| 23 | Update the Telegram data | It allows you to set or change the Telegram data. |
| 24 | Kill tasks | It allows you to end a currently-running ikabot task |
| 25 | Configure captcha resolver | It allows you to configure your desired captcha resolver for the Auto-Pirate task. The options you have to choose from are:
|
| 26 | Logs | It allows you to see logs and upload them to pastebin |
Install
Pre-built Windows binary
You can use the pre-built ikabot binary for Windows in the ikabot.zip file for a certain version here!
Using pip
python3 -m pip install --user ikabot
In Linux, you can access the main menu with ikabot, use python3 -m ikabot in Windows.
Requirements
In order to install and use ikabot, python3 and pip must be installed.
Also, in Linux you might have to install gcc and python3-dev.
- Python3 on Windows
To install Python3 on Windows, visit the official website, or install it in the Windows App Store.
- Python3 on Unix
It is probably installed by default in your system.
To check if it is installed by default, just run python3 --version.
If it is not installed, visit the official website
Notice
Pip
It is a tool to install python packages.
To check if it is installed by default, just run python3 -m pip -V.
To install it, you must download the get-pip.py file from this page and run python3 get-pip.py.
Or, in Linux, you can just excecute:
curl https://bootstrap.pypa.io/get-pip.py
sudo python3 get-pip.py
rm get-pip.py
Build from sources
If you want to have the lastest features, install from sources:
git clone https://github.com/physics-sp/ikabot
cd ikabot
python3 -m pip install --user -e .
Any change you make to that directory now will be reflected once you run ikabot using the command python3 -m ikabot
Alternatively, if you simply wish to install ikabot from github without creating a specific directory for it and without installing git, you can do so using the following one-liner:
python3 -m pip install https://github.com/physics-sec/ikabot/archive/refs/heads/master.zip
Uninstall
python3 -m pip uninstall ikabot
Using docker
First, build the container
docker build -t <name> .
Then, run it using
docker run -it <name>
In order to keep the processes running, detach from the container using CTRL-p + CTRL-q. If you want to open the menu again, just attach to the running container. The menu wont show up again, but you can select the request number, because its still running.
Telegram
Some features (such as alerting attacks) are communicated to you via Telegram messages.
Setting this up is highly recommended, since it allows you to enjoy all the functionality of ikabot.
To configure this, you just need to enter the token of the Telegram bot you are going to use
Create your Telegram bot
You will need to create your own Telegram Bot. To do that, talk to @BotFather on Telegram, send /newbot and choose the name of your bot.
Make sure to first talk to your new bot and type in /start before entering the token into ikabot.
You can find more information about the bot creation process here : https://core.telegram.org/bots#3-how-do-i-create-a-bot
Enter the Telegram bot's token
Once you have your new bot token, go to Options / Settings, then Enter the Telegram data and enter it.
Do not share this token with others!
Pre-defined input
You can run ikabot with command line arguments to make it automatically run a task with pre-determined input.
An example of running the login daily function with predetermined input is:
python3 -m ikabot [email] [password] [account number] 7 0Interactivity is returned to the user as soon as the list of pre-determined input arguments is exhausted, allowing ikabot to be run like so:
python3 -m ikabot [email] [password]Take into account that running ikabot with pre-determined input will leave your username and password in the command line history
![github-actions[bot]](https://avatars.githubusercontent.com/u/41898282?size=120)
