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.
FoE Optimizer is a free Swiss-army knife for Forge of Empires.
Every building and ally in the game with its stats, even without importing anything.
Your real city, with the numbers of your age: efficiency, roads, production, military values, what to upgrade.
What you can actually build with the kits and fragments in your inventory.
Redesigns your city from scratch, looking for the layout with as few roads as possible.
Your allies with their real bonuses, and how to grow them with Valor Tokens and Scrolls.
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 header at the top, a command ribbon below it, and the tab content.
| Item | What it's for |
|---|---|
| ⚔️ Logo and version | The version number (e.g. v2.000) goes up by one every day: it tells you how recent your version is. |
| 🪄 Green wand | One click imports the city copied by the bookmark; dragged to the bookmarks bar it creates the bookmark. See Importing your city. |
| City selector | The active city (avatar and name). Open it to switch city, delete one or import one from JSON. See Saved cities. |
| Tabs | Database, 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"). |
| 🇮🇹 / 🇬🇧 Language | Changes the interface language (the page reloads). |
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.
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.
The magic wand brings your city here from the game in two clicks. You only set it up once.
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).
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).
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.
FoE Optimizer reads the clipboard and imports the city. The first time, your browser may ask for permission to read the clipboard: allow it.
| Your city | Map and buildings, inventory, allies and resource storage (Scrolls, Valor Tokens…). |
| Another player's city | Click 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 Settlement | If you opened it during the game session, it comes along with the city and you'll find it in the Settlements tab. |
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 cities | Imported with the wand from your own city: every tab is available. |
| Visited cities | Other players' cities: map only, so City and Planner yes, Inventory and Allies no ("Only available for your cities"). |
| Cities imported from JSON | Cities loaded from a file: like visited ones, with building stats taken from the catalogue. |
Database, City and Inventory share the same table and the same commands.
The box in the Search group filters as you type:
boutique);\ in front (e.g. \W_MultiAge_SUM24);boutique, supplies shows buildings matching either). Works for ids too: \W_A, W_B.For allies you search by name, with commas as well.
| Filter | What it does |
|---|---|
| Event | Only the buildings of one event (or group of events). |
| Production | Filters 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. |
| Categories | Settlement prizes, GBG prizes, QI prizes. Ticking more than one shows buildings in at least one of them; none ticked = all. |
| Reset | Clears 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).
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.
Every button in this group has three states, cycling with each click:
| Off | Shows every building. |
| Red | Hides those buildings. |
| Green | Shows 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.
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.
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.
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:
| Disconnected | Buildings that need a road but aren't connected: they don't produce as they should. |
| Needless road | Buildings connected to a road they don't need. |
| Old age | Buildings 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. |
| Group | What you'll find |
|---|---|
| View | Besides the columns, + Inventory adds the buildings available in Inventory to the table (green background), to compare them with the ones already placed. |
| Statistics | Map (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). |
| Tools | Export 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 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.
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.
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).
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.
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.
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.
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.
When the numbers stop improving, pause. Now you can work on the maps.
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.
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.
| Arrows | Move the whole city (buildings and roads) by one cell. |
| Mirror | Flips the city horizontally or vertically, keeping the connections. |
| ✏ Edit | Opens the map in the editor (new tab): move and remove buildings and roads, then "Apply to Planner". The Planner must be paused. |
| ⬇ PNG / JSON | Downloads the solution as an image or a JSON file. |
| ✕ | Deletes the scenario: its search stops and the others carry on, with more power. |
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.
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.
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.
| Filters | Military, Science and Fragments, with how many you have. |
| Show rarity | Turns each of the five rarities on or off. |
| Sum % | Columns with the sum of the stats, as for buildings. |
| Level 100 | Analysis: shows your allies' stats as if they were already level 100. |
| Tokens | Analysis: 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. |
| Scrolls | Analysis: 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.
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 / Stop | Looks for a layout that fits all the chosen buildings; Stop interrupts it. |
| Auto | When you add a building that doesn't fit straight away, it tries to solve by itself; if it can't, it removes that building. |
| Undo | Goes back to the state right after the last import. |
| Reset | Returns everything to the starting point, clearing the imported data too. |
| Expansions | Add 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).
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.
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.
| Control | What it sets |
|---|---|
| Defense is … of attack | How much defence bonuses count compared to attack ones (attack is always 1). Default 0.8. |
| Include expeditions | Includes Guild Expedition bonuses in the calculation. |
| GBG / GE | How to split the weight between Battlegrounds and Expeditions (e.g. 0.20 = 20% to Expeditions, 80% to Battlegrounds). |
| How it works | Opens the detailed explanation. |
Saved cities, backup, weights and appearance.
| Saved cities | Import from JSON adds a city from a file; Delete all removes every saved city, after a confirmation. |
| Backup | Export all saves every city to a file; Restore brings them back (even on another computer or browser). |
| Stat weights | The efficiency weights (see section 12). |
| Theme | Dark or Light. |
| Reset | Erase 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. |
Help always at hand.
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.
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.
That's intended: in 2.0 the same city is recognised and updated, not duplicated.
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.
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).
Yes, completely: no account, no subscription, no limits.
Write to me at [email protected]: I'll reply as soon as I can.