Differences

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

--- troubleshooting [2025/09/27 22:11] – Update: How do I report a bug? francis
+++ troubleshooting [2026/07/16 15:19] (current) – [How do I report a bug?] Added link to new bug report form braixenfan
@@ Line 3: / Line 3: @@
 Links: **[[https://github.com/FullFrontalFrog/OhSoHeroTracker/issues|BUG TRACKER]]** • **[[CHANGELOG]]** • **[[ERROR LOGS]]** • **[[SAVE DATA]]**
-==== Which version do I download? ====
+===== How do I install and launch the game? =====
-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.
+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.
-Mac and Linux users should use the mac and linux builds.
+Further information can be found on the [[install|Installation and Uninstallation Guide]].
-Android is not currently supported. We are looking into options that may allow us to build for Android in the future.
+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.
-iOS is not supported because Apple does not allow adult games. Sorry~
+===== Which build do I download? =====
-==== How do I install and launch the game? ====
+if you bought the game through Steam, the most appropriate version will be selected for you when you choose to install the game.
-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 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]''.
-Further information can be found on the [[install|Installation and Uninstallation Guide]].
+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.
-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.
+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.
+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're using a **Linux** computer, you should choose a file where the platform is ''linux''.
+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.
+For further information on how to install the file you've downloaded, see the [[Install|Installation]] page.
+===== How do I access a beta build on Steam? =====
+To play a beta build on Steam, you'll need to switch to the beta branch.
+. In your Steam Library, **right-click** on Oh So Hero!, and select **Properties...**
+. Select **Game Versions & Betas**, and then select the **beta** branch.
+{{:ts:steam_beta.png?200|}}
-==== How do I report a bug? ====
+===== How do I report a bug? =====
 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]].
+. Submit a report to our [[https://forms.gle/VqdFihNFSNbT2A2H6|Bug report form]].
-. 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 report a bug directly on our [[https://github.com/FullFrontalFrog/OhSoHeroTracker/issues|Oh So Hero! public issue tracker on GitHub]].
-. You may also contact our [[https://ff-f.co/magoloric/|Community Manager]] 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]] 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" ====
+===== When I try to run the game on Windows, I get this error: "Fatal error: Failed to initialize IL2CPP" =====
-If you are running the 64-bit version, try using the 32-bit version instead. If that still doesn't work, contact us.
+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.
-==== When I try to run the game on macOS, I get this error: "macOS cannot verify the developer" ====
+If that still doesn't work, you may [[contact|contact us]].
-How do I run the game on macOS?
+===== When I try to run the game on macOS, I get this error: "macOS cannot verify the developer/app" or "OhSoHero.app Not Opened" =====
-  - Double-click the .zip file to extract the app.
+==== If using an older version of macOS ====
-  - 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?
+. Double-click the .zip file to extract the app.
-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.
+. Right-click on OhSoHero.app ➜ Click `Open`.
-==== I accidentally goofed my options or key bindings. What do? ====
+. 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:
@@ Line 60: / Line 104: @@
 [[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.