⚔️ FOE OPTIMIZER

FoE Optimizer 2.0 Guide

Everything you need to know, tab by tab and button by button: importing your city, reading the numbers, optimizing inventory and allies, and redesigning your city with the Planner.

🏰 1. What it is

FoE Optimizer is a free Swiss-army knife for Forge of Empires.

📚

Database

Every building and ally in the game with its stats, even without importing anything.

🏙️

City

Your real city, with the numbers of your age: efficiency, roads, production, military values, what to upgrade.

🧰

Inventory

What you can actually build with the kits and fragments in your inventory.

🗺️

Planner

Redesigns your city from scratch, looking for the layout with as few roads as possible.

🤝

Allies

Your allies with their real bonuses, and how to grow them with Valor Tokens and Scrolls.

⚓

Settlements

Plan the Pirate Settlement: where each building goes in the space you have.

Everything runs inside your browser: no server receives your data, no account is needed and there's nothing to install. Imported cities are saved only on your computer.

A hobby project. FoE Optimizer is made in spare time by a player, it's free and it is not affiliated with, sponsored or endorsed by InnoGames GmbH. Forge of Empires, its names, images and trademarks belong to InnoGames GmbH.

🧭 2. The interface

A header at the top, a command ribbon below it, and the tab content.

The header

ItemWhat it's for
⚔️ Logo and versionThe version number (e.g. v2.000) goes up by one every day: it tells you how recent your version is.
🪄 Green wandOne click imports the city copied by the bookmark; dragged to the bookmarks bar it creates the bookmark. See Importing your city.
City selectorThe active city (avatar and name). Open it to switch city, delete one or import one from JSON. See Saved cities.
TabsDatabase, City, Inventory, Planner, Allies, Settlements, Options, Help. Greyed-out tabs aren't available: hover over them to see why (e.g. "Import a city first").
🇮🇹 / 🇬🇧 LanguageChanges the interface language (the page reloads).

The command ribbon

Below the tabs is the ribbon: the tab's commands, split into groups with their name underneath (Search, Filters, View, Statistics…). When the window is narrow the groups shrink: first they lose their labels, then each becomes a single button that opens the group in a menu.

Panels

Some buttons don't change the table but open a panel above it (Statistics, Debug, Potential & tokens, Edit city, the Help panels…). The button stays lit while the panel is open: press it again to close it.


🪄 3. Importing your city

The magic wand brings your city here from the game in two clicks. You only set it up once.

  1. Install FoE Helper or Forge Hammer

    These are free browser extensions (not part of this project) that read Forge of Empires data while you play. One is enough: FoE Helper (Chrome, Firefox) or Forge Hammer (Chrome, Firefox).

  2. Drag the wand to your bookmarks bar

    Press and hold the green wand at the top (or the one in Help › How to import your city) and drop it on your bookmarks bar: it becomes a bookmark you can rename as you like. Can't see the bar? Show it with Ctrl+Shift+B (Cmd+Shift+B on Mac).

  3. In the game, click the bookmark

    With Forge of Empires open and the extension active, click the bookmark: it silently copies the data to your computer's clipboard. You won't see anything happen, that's normal. If something goes wrong, a message appears.

  4. Come back here and click the wand

    FoE Optimizer reads the clipboard and imports the city. The first time, your browser may ask for permission to read the clipboard: allow it.

To update repeat steps 3 and 4. The city is recognised by the player id and updated: no copy is created.

What gets imported

Your cityMap and buildings, inventory, allies and resource storage (Scrolls, Valor Tokens…).
Another player's cityClick the bookmark while visiting their city: it is added as a visited city. Map only: the game doesn't show other players' inventory and allies.
Pirate SettlementIf you opened it during the game session, it comes along with the city and you'll find it in the Settlements tab.

Other ways


🏘️ 4. Saved cities

You can keep as many cities as you like; the selector in the header tells you which one you're looking at.

When you open the selector, cities are split into three groups:

Your citiesImported with the wand from your own city: every tab is available.
Visited citiesOther players' cities: map only, so City and Planner yes, Inventory and Allies no ("Only available for your cities").
Cities imported from JSONCities loaded from a file: like visited ones, with building stats taken from the catalogue.
↑ back to contents

🔍 5. Tables, search and filters

Database, City and Inventory share the same table and the same commands.

Search

The box in the Search group filters as you type:

For allies you search by name, with commas as well.

Filters

FilterWhat it does
EventOnly the buildings of one event (or group of events).
ProductionFilters by produced resources (FP, goods, coins, units…). One click on a resource turns it green (the building produces it), the second red (it doesn't), the third clears it; ALL does the same with all of them at once. Each box is a filter: with Any filter one is enough, with All filters they must all hold (all red + All filters = buildings producing none of those resources). Reset clears all production filters.
Min eff.Minimum efficiency threshold: type 80 to see only buildings with efficiency above 80.
CategoriesSettlement prizes, GBG prizes, QI prizes. Ticking more than one shows buildings in at least one of them; none ticked = all.
ResetClears every filter.

Some tabs add their own boxes: in City Ageable (buildings that, taken to the Bronze Age, give the same goods and military values), in Database and Inventory Ageable too. City and Inventory also have the Age menu (only the copies of one age, with that age's values) and the Goods of age menu (the copies producing goods of one age, with the goods column highlighted).

View

Turns groups of columns on and off to keep the table readable: Population, Happiness, QI coins/supp. (Quantum Incursion production), Production details and Expeditions. If Expeditions shows ⚠️, expeditions don't count towards efficiency: you can enable them in Options › Stat weights.

Hide / Show only

Every button in this group has three states, cycling with each click:

OffShows every building.
RedHides those buildings.
GreenShows only those buildings.

The items: Not rushable (🚫), Auto age (take your city's age by themselves and can't be taken back to a previous age with the One Down or Reversion Kit), Limited / Ascended (timed), QI useful, Ally slot, Produce fragments, Needs road; in the City tab also Mass aid fr., Store bld. fr. and Great buildings.

Table options

Tools

Sorting

Click a column header to sort, click again to reverse. The previous order stays as a secondary criterion: sorting by Happiness and then by EFF, ties in EFF are broken by the higher happiness. Each table remembers its own order.


📚 6. Database

The full game catalogue, available without importing anything.

The Catalog group chooses what to browse:

From the GB catalogue, Tools › Calculator opens the GB Calculator (mobile friendly too): pick the Great Building, the level and the chat (Copper 90%, 95%, 100%, Gold 20%, 25% or your own percentage) to see what each spot pays, how many FP you need to secure them, and the line to copy into chat.

It's the place to compare similar buildings before deciding what to build, or to get an idea before you even import your city.


🏙️ 7. City

Your real city, with the numbers of your age rather than the database's theoretical ones.

Here you see only the buildings you own, with the stats of the age they're actually in. In the table some icons flag:

DisconnectedBuildings that need a road but aren't connected: they don't produce as they should.
Needless roadBuildings connected to a road they don't need.
Old ageBuildings from ages before yours (the Age filter).
Ally slot ⭐ / 🔬One per copy that can host an ally (military or science): full if occupied, with the ally's name on hover.

Ribbon commands

GroupWhat you'll find
ViewBesides the columns, + Inventory adds the buildings available in Inventory to the table (green background), to compare them with the ones already placed.
StatisticsMap (see below) and the summary panels: Road efficiency (how much road you use compared to how much you need), Production (city totals), Military values (sum of attack and defence bonuses), Era change (what would change upgrading all old buildings to the current and the maximum age), Upgradable (buildings you can level up with the kits and fragments you have).
ToolsExport city JSON (downloads the city to a file, handy for the Planner or to send to a friend), Export (CSV of the selected buildings) and Debug (list of recognised buildings, Great Buildings and those not yet in the catalogue).

The map

The Map button shows your city's real layout with the legend colours: town hall, Great Buildings, military buildings, buildings needing a road (one or two lanes), not needing one, needlessly connected, inactive, roads and free space. You can switch between Vertical and Isometric view, zoom in and out, and download the map as a PNG image or a JSON file.

↑ back to contents

🧰 8. Inventory

What you can really build with what's in your inventory.

The inventory fills up with selection kits, upgrade kits and fragments, and it gets hard to tell what you can get out of them. This tab works it out for you: for each building family, the highest level you can reach with the kits you own.

Kits in a nutshell

An upgrade kit alone creates nothing: you need the base building first. The tool takes care of this automatically.

"Wildcard" kits

Some epic kits work for many building families. The tool shows their potential for each one: if the same kit appears in twelve places it's not a mistake, you can use it for any of those families (but only one, when you spend it in the game).

What you see in the table

The Ready item of Hide / Show only shows only the buildings already in your inventory, ready to place, or hides them and leaves the ones made with kits.


🗺️ 9. Planner

Redesigns your city from scratch, looking for the layout with the fewest roads, so more space is left for buildings. Overview: Forge of Empires City Planner.

There's also a video tutorial (in Italian): Planner › Help › Video tutorial, or Help › How to use the planner.

Which city

The Source group chooses what to optimize: the Selected city or a file via Import JSON (the Map export, or a file sent by another player). The file isn't saved: the ✕ on the button closes it, and while it's loaded a click on its name brings you back to it.

How to use it

  1. Optimize

    The search starts on several scenarios in parallel: Connector 3, 4 and 5, Pinwheel, Pinwheel 2 and Current layout (which starts from the city as it is). Each scenario has its own map with stats (buildings with and without road, roads, corners) and improves as it goes.

  2. Pause

    When the numbers stop improving, pause. Now you can work on the maps.

  3. Smooth (optional)

    Moves and swaps road-connected buildings, without touching the roads, to reduce corners and gaps in the outline: the final fill will fit small pieces better. It keeps going until you pause it.

  4. Complete

    Ends the search on every map (each keeps the one shown) and places the buildings that don't need a road. Undo completion goes back to the paused search.

Reset clears everything. Undo edits restores the last layout found on the maps you edited by hand.

On each scenario

ArrowsMove the whole city (buildings and roads) by one cell.
MirrorFlips the city horizontally or vertically, keeping the connections.
✏ EditOpens the map in the editor (new tab): move and remove buildings and roads, then "Apply to Planner". The Planner must be paused.
⬇ PNG / JSONDownloads the solution as an image or a JSON file.
✕Deletes the scenario: its search stops and the others carry on, with more power.

Edit city

In the City group, before optimizing, Edit opens a panel where you remove buildings from the city and add others from your inventory or the database (Great Buildings and event buildings too). The panel warns you if space is tight. Changes are temporary: the Planner lays out the edited city, and on the map and in the PNG the added buildings have a white border.

Special cases

Processor and statistics

MIN / MED / MAX set how much of your computer's power the Planner uses (about 25%, 50%, 100%). The Current stats group reports the starting city: buildings with and without road, road tiles, chain buildings and sets.

↑ back to contents

🤝 10. Allies

Your allies, their real bonuses and the fragments you're collecting.

You see the allies you own with level, rarity and bonuses, inheritance included: a higher-rarity ally inherits the bonuses of the lower rarities and the tool adds them up for you. Allies you only have fragments of show how far along you are.

FiltersMilitary, Science and Fragments, with how many you have.
Show rarityTurns each of the five rarities on or off.
Sum %Columns with the sum of the stats, as for buildings.
Level 100Analysis: shows your allies' stats as if they were already level 100.
TokensAnalysis: which allies to evolve in rarity with Valor Tokens. Suggests the evolutions in order of efficiency gained per token and marks the ones you can already afford.
ScrollsAnalysis: which allies to level up with Heroic Scrolls, and by how many levels, for the largest attack and defense increase with the ones you have (according to the weights). Shows the increase of each stat and the total.

Tokens and Scrolls only count military allies, including those not placed in the city (flagged), and require an import with the updated wand (resource storage). All the game's allies, including those you don't have, are in Database › Allies.


⚓ 11. Settlements

Plan the Pirate Settlement.

Visit your Pirate Settlement in the game, then use the wand: its map (expansions, buildings, obstacles) comes along with the city. The tool works out where to put the buildings you choose in the space you have.

Solve / StopLooks for a layout that fits all the chosen buildings; Stop interrupts it.
AutoWhen you add a building that doesn't fit straight away, it tries to solve by itself; if it can't, it removes that building.
UndoGoes back to the state right after the last import.
ResetReturns everything to the starting point, clearing the imported data too.
ExpansionsAdd unlocks a 4×4 area (click a green slot), Remove closes one (click a red area).

On the map you can drag the town hall and buildings to move or swap them, and click a cell to mark it as an obstacle (or clear it).


⚖️ 12. Efficiency and weights

The EFF number next to every building and ally, and how to tune it.

Efficiency tells you how much a building yields for each tile of space it takes: the higher, the more it gives you relative to its space.

Efficiency = (sum of weighted bonuses) ÷ (space taken + roads)

The bonuses counted are general ones, Guild Battlegrounds ones and, if you enable them, Guild Expedition ones. The same calculation applies to buildings and allies.

The weights (Options › Stat weights)

ControlWhat it sets
Defense is … of attackHow much defence bonuses count compared to attack ones (attack is always 1). Default 0.8.
Include expeditionsIncludes Guild Expedition bonuses in the calculation.
GBG / GEHow to split the weight between Battlegrounds and Expeditions (e.g. 0.20 = 20% to Expeditions, 80% to Battlegrounds).
How it worksOpens the detailed explanation.
There's no "right" efficiency in absolute terms: it depends on what matters to you. If you mostly play Battlegrounds, leave Expeditions off; if you care about them too, turn them on. The number changes, the judgement stays yours.

⚙️ 13. Options

Saved cities, backup, weights and appearance.

Saved citiesImport from JSON adds a city from a file; Delete all removes every saved city, after a confirmation.
BackupExport all saves every city to a file; Restore brings them back (even on another computer or browser).
Stat weightsThe efficiency weights (see section 12).
ThemeDark or Light.
ResetErase everything clears all data and settings saved by the site (cities, weights, theme, language…) and reloads the page. It can't be undone: make a backup first.
Everything lives only in your browser: running Export all now and then (especially before switching browser or computer, or clearing browsing data) is a good habit.

📖 14. Help

Help always at hand.

↑ back to contents

❓ 15. FAQ

Is my data safe? Can anyone else see it?

No. Everything stays in your browser. No server receives or stores your game data, and the bookmark copies the data only to your computer's clipboard. Details are in the privacy policy.

I clicked the wand and nothing happens / it says the clipboard is empty.

Make sure you clicked the bookmark in the game, with FoE Helper or Forge Hammer active, before coming back here. If the browser denies permission to read the clipboard (some browsers, like Vivaldi or Brave, do by default), allow it in the site settings and try again.

I re-imported my city and don't see a new copy.

That's intended: in 2.0 the same city is recognised and updated, not duplicated.

Why do some buildings have missing data, or show up in Debug as not recognised?

The game keeps adding new buildings. The catalogue is updated often, but a brand-new building may not be in it yet: the tool still shows it with whatever data it can read from your city.

Can I use it on my phone?

Yes: the site adapts to the screen and can be "installed" as an app on your home screen. Importing with the wand, though, needs a desktop browser with FoE Helper or Forge Hammer; on your phone you can bring your cities over with a backup (Export all / Restore).

Is the tool free?

Yes, completely: no account, no subscription, no limits.

I have a question this guide doesn't cover.

Write to me at [email protected]: I'll reply as soon as I can.