Differences

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

--- troubleshooting [2022/06/17 20:06] – OSH Reset Options francis
+++ troubleshooting [2026/07/16 15:19] (current) – [How do I report a bug?] Added link to new bug report form braixenfan
@@ Line 1: / Line 1: @@
 ====== Troubleshooting ======
-==== Which version do I download? ====
+Links: **[[https://github.com/FullFrontalFrog/OhSoHeroTracker/issues|BUG TRACKER]]** • **[[CHANGELOG]]** • **[[ERROR LOGS]]** • **[[SAVE DATA]]**
-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.
+===== How do I install and launch the game? =====
-Mac and Linux users should use the mac and linux builds.
+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.
-Android is not currently supported. We are looking into options that may allow us to build for Android in the future.
+Further information can be found on the [[install|Installation and Uninstallation Guide]].
-iOS is not supported because Apple does not allow adult games. Sorry~
+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.
-==== How do I install and launch the game? ====
+===== Which build do I download? =====
-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.
+if you bought the game through Steam, the most appropriate version will be selected for you when you choose to install the game.
-Further information can be found on the [[install|Installation and Uninstallation Guide]].
+If you chose to purchase through itch.io or a supporting site like Patreon, you'll be given many files you can download, the name of the files follows the following format: ''oh-so-hero-[version number]-[platform].[extension]''.
-==== How do I report a bug? ====
+You may choose whichever version number you prefer, check the [[changelog]] to see the changes present between version, ideally, you should play with the latest version. Every version shares the same route for [[save data]] so you shouldn't worry about it when upgrading, but some versions might have issues downgrading.
-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]]. Make sure to include an [[error log]] as well. Cheers! Ribbit~
+If you're using a **Windows** computer, you should choose a file where the platform is either ''win64'' or ''win32'', between these, you should prefer the 64-bit version as this is better optimized to use the power of your CPU, only choose the 32-bit version if your CPU isn't compatible with these optimizations, this may be the case with older and lower-end CPUs. On top of these versions, you'll find ''win64-setup'' and ''win32-setup'' files, these files are installer versions of the game, these place the files in the ''Program Files (x86)'' folder which may be more comfortable for users.
-==== When I try to run the game on Windows, I get this error: "Fatal error: Failed to initialize IL2CPP" ====
+If you're using a **Mac** computer, you should choose a file where the platform is either ''macintel'' or ''macsilicon'' depending on the model and processor that your device is using.
-If you are running the 64-bit version, try using the 32-bit version instead. If that still doesn't work, contact us.
+If you're using a **Linux** computer, you should choose a file where the platform is ''linux''.
-==== When I try to run the game on macOS, I get this error: "macOS cannot verify the developer" ====
+If you're using a smartphone running **Android**, you should choose a file where the platform is either ''android'' or ''android-arm64'' depending on the processor in your device.
-How do I run the game on macOS?
+For further information on how to install the file you've downloaded, see the [[Install|Installation]] page.
-  - Double-click the .zip file to extract the app.
+===== How do I access a beta build on Steam? =====
-  - 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?
+To play a beta build on Steam, you'll need to switch to the beta branch.
-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.
+. In your Steam Library, **right-click** on Oh So Hero!, and select **Properties...**
-==== I accidentally goofed my options or key bindings. What do? ====
+. Select **Game Versions & Betas**, and then select the **beta** branch.
-On Windows, you can reset all of your options by running a simple command on the command line:
+{{:ts:steam_beta.png?200|}}
-''REG DELETE "HKEY_CURRENT_USER\SOFTWARE\Full Frontal Frog\Oh So Hero!" /f''
+===== How do I report a bug? =====
-This will not affect your save data or gallery data.
+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:
-==== Where are the Error Logs and Save Data? ====
+. Submit a report to our [[https://forms.gle/VqdFihNFSNbT2A2H6|Bug report form]].
-[[error logs|🐸 Error Logs]] (The error logs for //Oh So Hero!// will be in a different location for each operating system.)
+. You may report a bug directly on our [[https://github.com/FullFrontalFrog/OhSoHeroTracker/issues|Oh So Hero! public issue tracker on GitHub]].
-[[save data|🐸 Save Data]] (The save data for //Oh So Hero!// will be in a different location for each operating system.)
+. 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]] directly.
+Whichever option you choose, please provide detailed information about your issue. Make sure to include an [[error log]] as well. Cheers! Ribbit~
+===== When I try to run the game on Windows, I get this error: "Fatal error: Failed to initialize IL2CPP" =====
+This error happens when you're trying to run the 64-bit version in a device with a CPU that doesn't support the optimizations that the architecture brings. If this is the case, you should uninstall this version and try again with files that have the ''win32'' version.
+If that still doesn't work, you may [[contact|contact us]].
+===== When I try to run the game on macOS, I get this error: "macOS cannot verify the developer/app" or "OhSoHero.app Not Opened" =====
+==== If using an older version of macOS ====
+. Double-click the .zip file to extract the app.
+. Right-click on OhSoHero.app ➜ Click `Open`.
+. A popup will say "macOS cannot verify the developer/app" ➜ Click `Open`.
+. The app should now launch.
+==== If using macOS Tahoe (v26) or later ====
+. Double-click the .zip file to extract the app.
+. Right-click on OhSoHero.app ➜ Click `Open`.
+. A popup will say "OhSoHero.app" Not Opened ➜ Click `Done` to close this popup.
+{{ts:mac_tahoe_open_1.png?266|}}
+. Open Mac System Settings ➜ Privacy & Security ➜ Scroll to the bottom ➜ Next to "OhSoHero.app" click `Open Anyway`.
+{{ts:mac_tahoe_open_2.png?714|}}
+. Another popup like the first one will appear with a new option: `Open Anyway` ➜ Click `Open Anyway`.
+. Enter admin credentials.
+. The app should now launch.
+==== Why is the developer/app not verified? ====
+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.
+===== I accidentally goofed my options or key bindings. What do? =====
+On Windows, you can reset all of your options by running a simple command on the command line:
+''REG DELETE "HKEY_CURRENT_USER\SOFTWARE\Full Frontal Frog\Oh So Hero!" /f''
+This will not affect your save data or gallery data.
-==== Why aren't the teleporters working? ====
+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]]
-Teleporters work by telling the game "The player has been here". This is a small issue with using old save files, as that data hasn't be registered to the teleport update. Simply revisit the areas that don't appear on the list and that should allow you to teleport to and from them afterwards.
+===== I want get a refund on the game or a subscription pledge =====
+If you had issues with the game or your subscription that you need our help with, you may follow the instructions in the [[Refunds]] page.