Differences

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

--- troubleshooting [2022/11/07 21:44] – Where are the Error Logs and Save Data? UPDATED francis
+++ troubleshooting [2026/04/25 23:26] (current) – Reduced heading size 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.
-==== Where are the Error Logs and Save Data? ====
+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.
-Please read the **[[Error Logs]]** and **[[Save Data]]** pages.
+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 Windows, I get this error: "Fatal error: Failed to initialize IL2CPP" ====
+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.
-If you are running the 64-bit version, try using the 32-bit version instead. If that still doesn't work, contact us.
+For further information on how to install the file you've downloaded, see the [[Install|Installation]] page.
-==== When I try to run the game on macOS, I get this error: "macOS cannot verify the developer" ====
+===== How do I report a bug? =====
-How do I run the game on macOS?
+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:
+. You may report a bug directly on our [[https://github.com/FullFrontalFrog/OhSoHeroTracker/issues|Oh So Hero! public issue tracker on GitHub]].
+. 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" =====
+==== How do I run the game on macOS? ====
   - Double-click the .zip file to extract the app.
   - Right-click on OhSoHero.app and click Open.
-  - A window will pop up saying "macOS cannot verify the developer". Click Open.
+  - A window will pop up saying "macOS cannot verify the developer/app". Click Open.
-Why is the developer not verified?
+==== What about macOS Tahoe? ====
-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.
+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.
-==== I accidentally goofed my options or key bindings. What do? ====
+==== 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:
@@ Line 52: / Line 74: @@
 [[https://www.dropbox.com/s/k73lqbotqmms14e/OSH%20Reset%20Options.bat?dl=0]]
-==== Why aren't the teleporters working? ====
+===== I want get a refund on the game or a subscription pledge =====
-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.
+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.