User manual

Quick start

Get oBot running on Ikariam in five minutes: install the script, switch on automatic development with the First colony goal, citizens and research, link Telegram.

Last update: November 2, 2026

What oBot for Ikariam is

oBot for Ikariam is an assistant that runs inside the game tab, through the Tampermonkey extension. It keeps the construction site of every town busy, can develop your towns by itself towards a goal (for example the first colony), puts citizens to work, starts research, buys merchant ships and trains spearmen. It warns you about incoming attacks and economy problems (warehouse full, wine running out, gold dropping), in the page and on Telegram, and keeps a log of everything it does.

Testing version

oBot for Ikariam is at version 0.2.25: every feature is tested in game, but the bot is young. If something looks wrong, write to us at the address at the bottom of the page.

First steps

  1. Install Tampermonkey and the script. Install the Tampermonkey extension in Chrome or Firefox, then open https://js.obot.it/ikariam/obot-ikariam.user.js and press Install. Details are in the Installation section.
  2. Enter your Ikariam server. The oBot button appears at the bottom left of the page: open it. The first time, the bot creates your oBot account by itself, with no sign-up and a few days of premium trial.
  3. Switch on automatic development. In the Buildings tab switch on Build queue active and Automatic development, choose the First colony goal and press Save. From now on the bot picks the next building of every town by itself. If you prefer to decide yourself, add buildings to the queue by hand (Build queue section).
  4. Put citizens to work. In the Citizens tab switch on Automatic citizens and save: a newly founded town has everyone idle and produces no wood.
  5. Switch on research. In the Research tab switch on Automatic research and save: with the First colony goal the bot goes straight for Expansion, which unlocks the Palace and colonies.
  6. Check the alarms. In the Alarms tab the attack alarm and economy warnings are already on: press Test the alarm to see what the alert looks like.
  7. Link Telegram (recommended) to get alarms and warnings on your phone and, if you like, the alert when the bot stops: see the Telegram and Alarms sections.

Ready-made profiles

At the top of the Home you find the Ready-made profiles: Expansion (first colony), Economy, Raiding and Careful. One click sets every automation for that play style, with numbers taken from your account (gold, production, ships). The recommended one is chosen by reading your account; before saving you see what changes, and Undo profile puts back the previous settings. With Follow the recommended profile by itself on, the bot switches profile when the recommendation changes, for example from Expansion to Raiding once the colony is founded.

Home with the ready-made profiles

Saving is always explicit

Changes in the panel apply only after you press Save. Undo changes restores the saved settings.

The panel

Home
The ready-made profiles, the town open right now (resources with hourly production, gold with net income, citizens), the tiles that open every page, the last thing each automation did, and the account data with the bot language.
Charts
Hourly production per resource, gold in the treasury, the bot work per day (buildings, transports, pillages) and spearmen and ships, over 7 or 30 days, with the numbers and a table under each chart. The bot records them while it works, with no extra requests to the game; they stay in your browser for 60 days, and since 0.2.21 the day-by-day numbers are also sent to the oBot server every half hour, so we can see how the bot works and fix it. Free.
Charts page
Empire
All towns in one table with resources, gold and warnings: see the Empire overview section.
Buildings
The queue of every town, new buildings, automatic development with its goal and the state of the construction site: see the Build queue section.
Citizens
Workers and scientists assigned by themselves: see the Citizens section.
Research
The next research started by itself, in the branch order you choose: see the Research section.
Ships
Merchant ships bought by themselves up to the chosen number, or as many as needed if the bot decides: see the Ships section.
Army
Spearmen trained by themselves with spare wood: see the Army section.
Alarms
Attack alarm, economy warnings and the alert when the bot stops: see the Alarms section.
Telegram
The token to link Telegram and the check buttons: see the Telegram section.
Bot language
By default the bot speaks the language of the game server. In the Home you can pick another one (for example an English server with the bot in Italian): it applies to the panel, the log and the Telegram messages. Languages without a translation use English.
Log
Started buildings, automatic development choices, moved citizens, research, ships, training, alarms and warnings, with your computer’s date and time and a label for each type.
Status bar
Always visible at the bottom left: a dot says whether the bot works (green), waits (yellow), is stopped (grey) or has a problem (red), followed by what it is doing now, what it does next with a countdown and the last line of the log. When it does nothing it says why (another tab is the one working, no feature is on, premium expired). A click on the bar opens the Log; a click on the dot shrinks it to the dot alone.
Version and news
Click the version at the top of the panel to read the news: the version in use first, the previous ones can be folded, split into new things, improvements, fixes and removed things. STAGING appears next to the version when you use a trial version not yet published and PREMIUM when premium is on.
The tiles of the Home

The Home is a grid of tiles in three groups: Overview (Empire, Charts, Log), Automations (Buildings, Citizens, Research, Army, Ships) and Alerts and account (Alarms, Telegram, Premium). Each tile says what its page is for and has a dot: green on, grey off, orange waiting for premium. Every page has the Home button at the top.

Free and premium

Free

  • Attack alarm, in the page and on Telegram
  • Economy warnings and the alert when the bot stops
  • Empire overview, daily gifts of the first week and the daily login bonus
  • Build queue: the first 2 upgrades of every town
  • Telegram link and log

Premium

  • Unlimited build queue, with new buildings on free plots
  • Automatic development with goals
  • Jobs started «meanwhile» while the first one waits for resources
  • Automatic citizens, research, ships and army

Premium is the same as oBot for OGame (same packages) and every new account gets a few trial days. Without premium, the settings of premium features are saved anyway: they start as soon as premium is active.

How it works

  • The bot works only while a game tab is open, even in the background. With the browser closed, the PC asleep or the tab frozen by Chrome nothing happens: see the FAQ The bot stopped for hours.
  • With several tabs open on the same server only one works, the «leader tab»: the others stay idle, so the same building never starts twice and the same alarm never arrives twice. If you close or reload the leader tab, another one takes its place.
  • The bot does not reload the page while you play: when it starts something it tells you with a notice in the page. The town view shows the construction site at the next page change.
  • Settings are stored on the oBot server, tied to your game account: they survive a reinstall and follow you to another PC.
  • Updates arrive by themselves through Tampermonkey; before running new code the bot checks its fingerprint.

Video