If you are trapped in a loop by the guards keep attacking bug Heart of Gaia suffers from, reloading an older save file will not fix your game. You are likely standing outside the initial training room on a brand new save, wondering why the city watch is instantly swarming you. The short answer is that Brokentail Games accidentally tied NPC hostility to a global configuration file rather than your individual save slot. To fix it, you must either manually delete your local Godot engine user data folder or completely reinstall the game with cloud saves disabled.
Heart of Gaia is a brilliantly designed steampunk Action RPG, but its backend data management currently harbors a fatal flaw. This guide breaks down exactly why your saves are failing and provides the step-by-step technical solutions needed to rescue your playthrough.
Why Reloading Your Save Fails
When you accidentally clip a neutral NPC in the City Outskirts, the engine immediately updates a global singleton to flag your entire installation as hostile. In game development using the Godot engine, a "Singleton" (or Autoload) is a node that is always loaded in the background, regardless of which level or scene you are currently playing. Indie developers frequently use singletons to manage persistent data like audio volumes, keybindings, and, unfortunately in this case, faction reputation.
Heart of Gaia in-game screenshot
When you realize the guards are swarming you and you press load to reverse your mistake, the game successfully restores your character's physical position, health pool, and inventory from ten minutes ago. However, the load script fails to overwrite the global faction singleton. The guards effectively remember your crime across alternate timelines. The key takeaway is that your actual save file is not corrupted; the game's overarching environment configuration is.
This architectural oversight is why even returning to the main menu and clicking "New Game" results in an immediate death sentence. The global singleton persists until the application is completely closed, and it writes its hostile state to your hard drive's master configuration file rather than your specific save slot.
The Quick Fix: Purging the Godot Configuration Files
Instead of waiting for a full 2.26 GB download to reinstall the game, PC players can surgically remove the corrupted hostility flag. Because Heart of Gaia was developed using Godot, it does not save its master configuration in your Steam directory. It defaults to a very specific hidden directory structure deep within your Windows user profile.
Heart of Gaia in-game screenshot
By deleting this specific folder, you force the game to generate a brand new, clean configuration file the next time you launch the executable. The critical takeaway here is that wiping this folder will delete your local save progress and reset your custom keybinds, but it is the only guaranteed way to reset the permanent aggro state on PC.
The file responsible for the glitch is usually a .cfg or .dat file stored alongside your .save slots. Because they are bundled together in the app_userdata directory, separating the clean save from the corrupted config is nearly impossible without a dedicated save editor, which does not yet exist for this indie title.
Step-by-Step Directory Wipe
- Close Heart of Gaia completely. Ensure it is not running in the background via the Steam client.
- Press
Windows Key + Rto open the Run dialog box. - Type
%APPDATA%and hit Enter. This opens your Roaming folder. - Navigate through the folders:
Godot->app_userdata->Heart of Gaia. - Delete the entire
Heart of Gaiafolder. - Launch the game and start a new file. The guards will now be neutral.
The Nuclear Option: Clean Installation via Steam
If navigating hidden Windows directories sounds risky or you are playing on a device like the Steam Deck where file management is cumbersome, a clean installation achieves the exact same result. However, simply clicking "Uninstall" in your library is not enough to purge the bug.
Steam's cloud synchronization feature is specifically designed to back up your configuration files alongside your saves. If you do not intercept this process, Steam will helpfully redownload your corrupted, hostile guard state the moment the game finishes reinstalling. The most important step of a reinstall is disabling Steam Cloud synchronization before you delete the game.
Steam compares the timestamps of your local files with the cloud; if you just delete the game locally, the cloud assumes your machine lost the data and dutifully restores the glitch.
Bypassing Steam Cloud Saves
- Open your Steam Library and right-click on Heart of Gaia.
- Select Properties from the dropdown menu.
- In the General tab, toggle the switch for "Keep games saves in the Steam Cloud for Heart of Gaia" to the OFF position.
- Right-click the game again, select Manage, and click Uninstall.
- Re-download the 2.26 GB game files.
- Launch the game, play past the Training Room, and verify the guards in the City Outskirts do not attack.
- Once confirmed, you can safely turn Steam Cloud saves back on. When Steam warns you of a file conflict, choose to upload your local files to the cloud, overwriting the corrupted data.
Safe Combat Tactics in the City Outskirts
Once your installation is clean and you are back on your feet, you need to adapt your playstyle to survive the City Outskirts without triggering the bug a second time. The primary cause of accidental guard aggro stems from the game's otherwise excellent real-time character switching mechanics. The streets of the Outskirts are narrow, flanked by steampunk machinery and cobblestone walls, making collateral damage highly likely.
Heart of Gaia in-game screenshot
Alexander, the Paladin, is a massive liability in these neutral zones. His basic attack string utilizes a heavy broadsword that culminates in a massive 180-degree cleave. If a patrolling city guard wanders behind him while you are fighting a group of street thugs, the backswing will connect, and your entire installation is ruined again. To survive the early game without triggering a reset, you must strictly use Oleg the Rogue when fighting in populated areas.
Oleg vs. Alexander Hitbox Comparison
| Character | Primary Weapon | Attack Arc | Risk in Neutral Zones | AI Behavior Recommendation |
|---|---|---|---|---|
| Oleg (Rogue) | Dual Daggers | Narrow, forward-facing thrusts | Low | Set to "Aggressive" (Safe) |
| Alexander (Paladin) | Heavy Broadsword | Wide, 180-degree sweeping cleaves | Extreme | Set to "Defensive" (No AoE) |
When you enter the City Outskirts, manually switch your active character to Oleg. Open the party tactics menu and immediately set Alexander's AI behavior to "Defensive." This prevents the AI from automatically triggering his wide-arcing skills while uncontrolled.
How to Kite Enemies Away from Neutral Patrols
Beyond character selection, mastering enemy kiting is essential in Heart of Gaia. The thugs in the Outskirts have a relatively long pursuit radius. Instead of fighting them where they spawn—which is often dangerously close to the city watch patrol routes—you should use ranged attacks to pull aggro.
Heart of Gaia in-game screenshot
Run back toward the abandoned alleyways or the entrance of the sewer dungeon before engaging in melee. The guards have strict, scripted patrol paths and will not deviate into the alleys unless they are actively attacked. By forcing the thugs to come to you, you completely eliminate the risk of an accidental area-of-effect strike hitting a neutral NPC.
Why the Training Room is the Ultimate Litmus Test
If you are attempting to fix this bug, you will quickly become intimately familiar with the game's opening Training Room. Because the global hostility flag persists across new saves, the Training Room serves as the perfect safe environment to test if your fix actually worked.
Inside the Training Room, there are no guards, only wooden dummies and your mentor NPC. The moment you step through the wooden double doors into the outer courtyard, the game loads the first batch of city watchmen. If your configuration file is still corrupted, they will immediately draw their weapons and charge you. If you step out and they ignore you, you have successfully purged the glitch and can safely proceed with your playthrough.
Will Brokentail Games Patch the Hostility Loop?
Heart of Gaia is a passion project built over two and a half years by a solo developer at Brokentail Games. The creator originally started in the manga industry before pivoting to learn coding from scratch, translating a childhood tabletop RPG world into this digital format. Following the game's launch on June 1, 2026, the developer has been highly communicative and transparent on the Steam forums and Reddit.
While the major June 5 development update focused heavily on implementing highly requested local and online co-op features, the solo dev is actively monitoring community bug reports. Because this hostility loop fundamentally breaks the core progression of the game, a hotfix that separates faction reputation from the global singleton is almost certainly in the pipeline. Indie developers using Godot often face these singleton oversight issues upon full release, but they are usually patched quickly once identified. Until that patch drops, strict trigger discipline with your AoE attacks is your only viable defense.
Frequently Asked Questions
Can I use a cheat engine to reset my faction reputation?
No. The memory values governing faction hostility in Heart of Gaia are obfuscated and dynamically allocated by the engine. Attempting to force the value back to neutral via third-party memory editors usually results in an immediate crash to desktop.
Does this bug exist in the free demo?
Yes. The September 2025 demo shares the exact same underlying engine architecture. If you aggro the guards in the demo, you will need to follow the same AppData deletion steps to fix your trial run.
Does this bug affect the Steam Deck version?
Yes. Because the Steam Deck runs the PC version of the game via the Proton compatibility layer, the Godot configuration files behave exactly the same way. You will need to switch to Desktop Mode to navigate to your compatdata folder and delete the prefix, or rely entirely on the Steam Cloud reinstall method.
Can I back up my save before entering the Outskirts?
Yes, but you must back up the entire Heart of Gaia folder in your app_userdata directory, not just the .save file. If the bug triggers, you can overwrite the corrupted folder with your clean backup, restoring both your save slot and the neutral configuration state.