# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.fullscreen.no/info/game-creator-2-assets/herobridge/troubleshooting/cache-generation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.