Install and Use Userscripts (Desktop & Mobile)

A userscript is a small JavaScript file that runs on Torn pages to add overlays, totals, filters, and other helpers. Something has to install and inject it: a browser extension on desktop, or Torn PDA on phone.

On Tools & Scripts, prefer entries with a PDA badge when you play on mobile. What the Trading Companion does after install: Using TornW3B → Trading Companion.

1. Install Tampermonkey or Violentmonkey for your browser.
2. Open Manage extensions: enable Developer mode if asked, and turn on Allow userscripts for the manager (wording varies). Without that, Install may appear to work but nothing runs on Torn.
3. Chrome/Edge may also ask to allow the extension on torn.com - grant it.
4. Open a script page (example: Trading Companion or Install on Tools & Scripts).
5. Click Install this script → confirm name / `@match` / `@grant` → Install.
6. Reload Torn (or open the page the script targets).

• If nothing appears: confirm the script is enabled in the manager dashboard.
• Check `@match` covers the Torn URL you are on (Item Market vs bazaar vs trade differ).
• Two scripts on the same page can conflict - disable one at a time (Script safety).

1. Install Torn PDA from the App Store or Google Play (also linked on tornpda.com).
2. Open PDA, log into Torn, complete first-run API key / permissions (Limited is enough for most PDA features).
3. Go to Settings → Userscripts.
4. Add a script: paste a GreasyFork install / raw URL (copy Install links from Tools & Scripts on your phone browser).
5. Open that script’s options. Set injection time to END when the author, Tools & Scripts, or forum thread says so (common for Trading Companion, bazaar helpers, and many market scripts).
6. Save, then open the Torn page the script targets inside PDA and reload once.

• Play Torn inside PDA so the script can run. Browser tabs of torn.com will not see PDA-installed scripts.
• Prefer Limited or Custom keys. Reinstall / refresh from GreasyFork when the author updates (PDA does not always auto-update every userscript).
• Browser extensions like TornTools / ReTorn are desktop-only.

• Updates (desktop): GreasyFork scripts usually check through your manager; you can also reinstall from the script page.
• Updates (PDA): Reinstall or refresh from the GreasyFork URL.
• Pause: Disable a script in Tampermonkey / PDA Userscripts when troubleshooting.
• Remove: Delete it from the manager. Revoke any Torn API key you only created for that tool if you no longer trust it.
• Duplicates: Do not run two bazaar fillers or two FF Scouter overlays at once. For Fair Fight on profiles, use either FF Scouter V2 or TornTools’ built-in FFScouter — not both.

• Install from Tools & Scripts or known GreasyFork authors with readable source.
• Never paste a Full Access key into a random site or script. Few tools need Full.
• Skim `@connect` and `@grant` on the install screen - that is what the script can talk to.
• If something feels wrong, disable the script, revoke the key in Torn Preferences, and make a new one.

1. Pick desktop manager or Torn PDA from the table above.
2. Install the manager / app.
3. Install one script from Tools & Scripts (Companion is a common first pick).
4. On PDA, set injection to END when documented; reload the target page inside the right client.
5. Confirm the overlay appears; disable other scripts if it conflicts.

• Torn Game Rules
• Torn Scripting Rules
• Script safety (TornW3B wiki)
• Torn PDA
• Tampermonkey