> For the complete documentation index, see [llms.txt](https://docs.fullscreen.no/info/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fullscreen.no/info/game-creator-2-assets/herobridge/troubleshooting/cache-generation.md).

# Cache generation

HeroBridge relies on pre-generated cache data to display available parts, presets, colors, body shapes, species, and expressions inside Game Creator 2 instructions (like **Set Part**).\
If for some reason the cache generation has failed, or if no parts appear in dropdown menus, this indicates the cache wasn’t created correctly.

**Why we use cache**

When HeroBridge is installed through the **Package Manager**, HeroBridge automatically attempts to export all cache data during setup.\
This process extracts data directly from the **Sidekick database** (including expressions from the demo animation controller) and stores it for runtime access.

This cache system is used for **performance** and **compatibility** reasons:

* It prevents runtime lookups that could cause freezing or hitching when querying the Sidekick database.
* It enables **WebGL support**, since the Sidekick database system isn’t supported on WebGL, but cached data is.

**Troubleshooting steps**

1. **Open the Sidekick Character Tool**
   * If the tool opens and you don’t get errors about missing parts, the Sidekick installation is fine.
   * In this case, you can manually re-generate the HeroBridge cache.
2. **Manually regenerate the cache**
   * Go to the Unity toolbar:\
     **Game Creator > Settings > HeroBridge**
   * Inside the settings window, click **Regenerate Cache**.
   * You can also view the current cache status here to confirm successful generation.
3. **If the Sidekick Character Tool reports missing parts**
   * This means your Sidekick installation is incomplete or corrupted.
   * You’ll need to completely reinstall Sidekick and HeroBridge.

**Full reinstall steps**

1. Uninstall HeroBridge:
   * Go to **Game Creator > Uninstall > HeroBridge**
2. Delete the **Synty** folder from your project.
3. Follow the setup guide from the beginning, ensuring the Sidekick tool works *before* reinstalling HeroBridge:

   **Setup checklist:**

   1. Install **Game Creator 2**
   2. Install **FREE Starter Pack – Sidekick Modular Characters** by Synty
   3. Download and install the **Sidekick Tool**
      * After installing the Starter Pack, a popup will prompt you to install the Sidekick Tool.
      * If it doesn’t appear, manually open it via:\
        **Synty > Sidekick Tool Downloader**
      * Or download it directly from:\
        <https://github.com/SyntyStudios/SidekicksToolRelease/releases/latest/download/Sidekicks.unitypackage>
