Debugging Instructions - Mephiles/torntools_extension GitHub Wiki

Reporting Issues

We generally use TornTools Discord server for any issue reporting, but TornTools forum thread is a good place too. Before you post that you have any error, please make sure to include the following information:

  1. Whether you are on PC or mobile.
  2. The browser you are using.
    • On PC, this could be most browser like the following: Google Chrome, Mozilla Firefox, Brave Browser, Opera, etcetera.
    • On mobile, only a few browsers support extensions and it changes every so often so impossible to list.
  3. The version of TornTools you are on. "Latest version" is not enough, as it depends per browser and which store you used (example: latest version on Chrome is v7.6, latest version on Firefox is v7.6.1 and latest version on Yandex is v6.26).
    • This can be found by visiting the changelog section in TornTools preferences page.
  4. What status is the feature you are having issues with in? Check the Feature Manager section on this page for that.

Debugging instructions

Feature Manager

Our feature manager gives an overview of all features configured to run on your current page. It will also show their status:

  • green checkmark = OK
  • blue question mark = conditions not met (hover for full reason)
  • orange cross = disabled in your settings
  • red cross = BAD and should show you the error at the top

Please note that just because the feature manager reports it is OK, doesn't mean that's working as intended. It just means that no issues occurred in the usual flow. Features often also rely on delayed things or just handle Torn breaking stuff well which could mean that issues are not reported this way.

image

image

Configuring the feature manager (should be fine by default, only needed if you changed it)

  • Enable " Display running features on every page." (General in Preferences)
  • Disable "Only display failed features."
  • Disable "Hide disabled features."
  • "Hide when there is nothing to display." doesn't matter what's in

image

Console

  1. Open the browser's console.
    • This can be done by pressing F12.
  2. Look for any logs with red background and red X, like this: Sample Error
  3. Screenshot those logs and post them in the Discord server in #bugs (you can also post them on the TornTools Torn forum thread). Be sure to censor your API key, if it is in those screenshots. Any of our developers may contact you for additional information. Never provide your API key to anyone.