Extension Overview

HoH Helper provides two key functionalities:

• Automatic Data Collection: Let the extension automatically gather game statistics, such as leaderboards.
• Game Data Export: Seamlessly export your city layout and hero roster into our City Planner and Command Center tools.

All communication between the game and its own servers remains intact; the extension simply “listens” to data and never modifies it.

Installation Steps

Option A: Chrome Web Store (Upcoming)

We are in the process of publishing HoH Helper to the Chrome Web Store for a simple “one-click” install. Once available, you will be able to:

1. Go to the Chrome Web Store page for HoH Helper.
2. Click Add to Chrome and follow any on-screen prompts.

Stay tuned! We will announce this release as soon as possible.

Option B: Developer Mode (Source Installation)

You can install HoH Helper directly from the GitHub source code at any time, even before the Chrome Web Store version is available. In fact, we encourage installing it right now so you can contribute data to our Stats Hub immediately!

1. Visit HoH Helper Releases , and download the latest ZIP file.
2. Extract the files to a folder on your computer.
3. Open Google Chrome.
4. Either:
   • Type chrome://extensions in the address bar
   • Or click the three-dot menu (⋮) in the top-right corner, go to More Tools, and select Extensions
5. Toggle on Developer mode in the top-right corner of the page.
6. Click Load unpacked, then select the folder containing manifest.json.

Data Collection

HoH Helper offers flexible, checkbox-based settings to control what data you share. Each checkbox in the extension's Data Collection Settings section must be explicitly enabled by you before any data is transmitted to the server.

When a selected piece of game data (for example, the leaderboards) is loaded, the extension automatically collects and sends that data to Forge of Games. If the box is unchecked, the data will not be collected going forward.

The Stats Hub on Forge of Games relies heavily on user-contributed data. The more players who enable data collection, the more accurate and up-to-date our overall stats become.

Current Data Collection Options:

1. Leaderboards

   Automatically collects player and alliance leaderboard information, arena rankings as well as ATH group rankings.

2. Your Alliance

   Automatically collects the information about the members of your own alliance as well as ATH internal alliance's rankings.

More collection options will be added over time. Check back frequently for updates!

Game Data Export

HoH Helper makes it easy to export your city layout and heroes into our City Planner and Command Center. The data is captured once the game is loaded and stored locally by the extension until you choose to export it.

How to Export:

1. Open the Heroes of History game in your browser and wait until it’s fully loaded.
2. Click the HoH Helper extension icon in your browser toolbar. A popup will appear.
3. In the “HoH City Planner and Command Center” section, click the Export Game Data button. If it’s inactive, reload the game page.
4. After processing, a new tab will open with a link to your exported data on Forge of Games.
5. On the new page, choose which data to import (city layout, heroes, or both) and click Import.
6. Once imported, navigate to the City Planner or Command Center to find your updated city layout or command center profile.
7. Remember: Data is only captured upon loading the game. To refresh it (for example, after upgrades), reload your game page and export again.
8. If you open multiple servers (e.g., main and beta), only the most recently loaded data is stored. To export from a different server, reload that server.
9. The extension preserves your last captured data even if you close the game. You can export later without reopening the game, though it may be outdated if changes were made in-game.

Frequently Asked Questions (FAQ)

Q: Does the extension modify the game?

A: No. The extension does not change any game code or intercept server communications. It simply reads in-game data as it loads.

Q: Can I use the extension on multiple game servers?

A: Yes. Automatic data collection works on whichever server is open. For manual export, the data will be from the last server where you loaded the game. If you need data from another server, simply reload that game instance.

Q: I exported my data, but it’s outdated. How do I fix this?

A: Reload the game page to capture the most recent data, then export again.

Q: I enabled data collection, but I don’t see my data in the Stats Hub yet.

A: Data is collected in real time, but processing on Forge of Games may run once per day. Please wait until the next day to see the updated information in the Stats Hub.