Differences

This shows you the differences between two versions of the page.

--- troubleshooting [2021/03/27 15:33] – old revision restored (2021/01/31 08:39) 62.210.139.231
+++ troubleshooting [2025/10/11 22:17] (current) – francis
@@ Line 1: / Line 1: @@
 ====== Troubleshooting ======
-==== How do I install and launch the game? ====
+Links: **[[https://github.com/FullFrontalFrog/OhSoHeroTracker/issues|BUG TRACKER]]** • **[[CHANGELOG]]** • **[[ERROR LOGS]]** • **[[SAVE DATA]]**
-Instructions can be found on the [[https://ff-f.itch.io/oh-so-hero|Oh So Hero! itch.io page]], which also has download links for the latest public build. If you're a [[https://www.patreon.com/FullFrontalFrog|patron]], you can get access to even newer builds with more exclusive content.
+==== Which version do I download? ====
-==== How do I report a bug? ====
+If you use Windows, download the win64 build. Older 32-bit systems use the win32 build. You can use the setup.exe file for simple click-and-run, or if you prefer, the .zip file for full control.
-Before reporting a bug, please read the rest of this page to see if anything fixes your problem. If that doesn't help, please send detailed information about your issue to us directly. If you're a patron, you may post in the **#osh-bugs** channel on the Full Frontal Frog Discord server or direct message us on [[https://www.patreon.com/FullFrontalFrog|Patreon]]. You may also contact our [[https://ff-f.co/magoloric/|Community Manager]]. Cheers! Ribbit~
+Mac, Linux, and Android users should use their respective builds.
-==== When I try to run the game on Windows, I get this error: "Fatal error: Failed to initialize IL2CPP" ====
+iOS is not supported because Apple does not allow adult games. Sorry~
-If you are running the 64-bit version, try using the 32-bit version instead. If that still doesn't work, contact us.
+==== How do I install and launch the game? ====
-==== When I try to run the game on macOS, I get this error: "macOS cannot verify the developer" ====
+Instructions can be found on the [[https://ff-f.itch.io/oh-so-hero|Oh So Hero! itch.io page]], which also has download links for the latest public build. If you're a [[https://www.patreon.com/FullFrontalFrog|patron]], you can get access to even newer builds with more exclusive content.
-How do I run the game on macOS?
+Further information can be found on the [[install|Installation and Uninstallation Guide]].
-  - Double-click the .zip file to extract the app.
+If you're installing or unpacking Windows versions, make sure to pick the default install location or one with a path that Unity can understand. Avoid having special symbols, foreign characters, umlauts (e.g. ÄÅÖ) in folder names. Else the game might not launch.
-  - Right-click on OhSoHero.app and click Open.
-  - A window will pop up saying "macOS cannot verify the developer". Click Open.
-Why is the developer not verified?
+==== How do I report a bug? ====
-In order for macOS to verify the developer, the application needs to be registered with Apple's App Store. Unfortunately, Apple does not allow apps with adult content on the App Store, and thus we must result to this workaround.
+Before reporting a bug, please read the rest of this page to see if anything fixes your problem. If that doesn't help, you have a few options:
-==== When I'm playing the game, my path is blocked by a wall of sand. ====
+. You may report a bug directly on our [[https://github.com/FullFrontalFrog/OhSoHeroTracker/issues|Oh So Hero! public issue tracker on GitHub]].
-If you experience something like this:
+. If you're a patron, you may post in the **#osh-bugs** channel on the Full Frontal Frog Discord server or direct message us on [[https://www.patreon.com/FullFrontalFrog|Patreon]].
-{{:beyonce_wall_of_sand.png?200|}}
-It is because the game is reading incorrect terrain data that was left over from an old version of the game.
+. You may also contact our [[https://ff-f.co/magoloric/|Community Manager]] directly.
-Go to the location where you installed the game, **delete the "Oh So Hero_Data" folder**, and then **re-install**.
+Whichever option you choose, please provide detailed information about your issue. Make sure to include an [[error log]] as well. Cheers! Ribbit~
-This will not reset your game progress. Your save data is stored in a different location on your machine (see below) and will not be removed as a result of this.
+==== When I try to run the game on Windows, I get this error: "Fatal error: Failed to initialize IL2CPP" ====
-==== Where are the Error Logs and Save Data? ====
+If you are running the 64-bit version, try using the 32-bit version instead. If that still doesn't work, contact us.
-This data will be in a different location for each operating system.
+==== When I try to run the game on macOS, I get this error: "macOS cannot verify the developer/app" ====
-=== Windows ===
+How do I run the game on macOS?
-At your Desktop, press Windows+R on your keyboard to open the Run window.
+  - Double-click the .zip file to extract the app.
+  - Right-click on OhSoHero.app and click Open.
-Next, copy and paste the following line into the Open textbox and click OK:
+  - A window will pop up saying "macOS cannot verify the developer/app". Click Open.
-''%USERPROFILE%\AppData\LocalLow\Full Frontal Frog\Oh So Hero!''
-An Explorer window will appear to show you the contents. The pertinent files are:
-  * **GalleryData.es3**
-  * **Player.log** (& **Player-prev.log**)
-  * **SaveFile01.es3** (also **02**, **03**)
-Additionally, Player Prefs are stored in the Registry:
-''Computer\HKEY_CURRENT_USER\SOFTWARE\Full Frontal Frog\Oh So Hero!''
-=== macOS ===
-Navigate to the following location:
-''~/Library/Application Support/Full Frontal Frog/Oh So Hero!''
-You'll find **GalleryData.es3** and **SaveFile01.es3** here.
+What about macOS Tahoe?
-''~/Library/Logs/Full Frontal Frog/Oh So Hero!''
+On macOS Tahoe (v26) or later, you must visit System Settings > Privacy & Security. Scroll to the bottom, where you should find an "Open Anyway" option for "OhSoHero.app". Clicking this, selecting "Open Anyway", and entering admin credentials will allow the app to launch.
-You'll find **Player.log** and **Player-prev.log** here.
+Why is the developer/app not verified?
-=== Linux ===
+This is because the app is not signed and notarized by Apple (this is just Apple saying "this app contains no malware", which is true in any case). The signing process requires a paid Apple Developer subscription that's currently outside our budget. Nevertheless, we will look into doing this in a future update in order to provide a simpler experience for players.
-Navigate to the following location:
+==== I accidentally goofed my options or key bindings. What do? ====
-''~/.config/unity3d/Full Frontal Frog/Oh So Hero!''
+On Windows, you can reset all of your options by running a simple command on the command line:
-You'll find **Player.log** and **Player-prev.log** here.
+''REG DELETE "HKEY_CURRENT_USER\SOFTWARE\Full Frontal Frog\Oh So Hero!" /f''
-=== Other Platforms ===
+This will not affect your save data or gallery data.
-See the **Player** section of the [[https://docs.unity3d.com/Manual/LogFiles.html|Unity Log Files Manual]].
+Alternatively, you can download this batch file, then double-click it to run it:
+[[https://www.dropbox.com/s/k73lqbotqmms14e/OSH%20Reset%20Options.bat?dl=0]]
 ==== Why aren't the teleporters working? ====