Highlights traveling players with a different color.
# Torn Target Finder (TF-9)
This is a userscript for the online game Torn. It provides a floating UI that helps you find and evaluate potential targets on any Torn page.
## Features
* **Target Finder UI:** A draggable and collapsible interface that appears on all Torn pages.
* **API Integration:** Uses your Torn API key to fetch detailed user information.
* **Page Scanning:** Scans the current page for links to user profiles and adds them to the target list.
* **Filtering:** Filter potential targets by their current state (Okay, Hospital, Traveling, Jail) and by their maximum level.
* **Threat Assessment:** Automatically assesses a "threat level" (Low, Medium, or High) for each target based on their level, age, awards, and rank. This helps you quickly identify potentially difficult targets.
* **Detailed Information:** Displays key target information, including:
* Name, Level, and Rank
* Current life
* Awards
* Current status and state (e.g., "In hospital for 2 hours")
* Time remaining for timed states.
* **Highlighting:** Traveling players are highlighted in the list for easy identification.
## How to Use
1. **Install a userscript manager:** You'll need a browser extension like [Tampermonkey](https://www.tampermonkey.net/) or [Greasemonkey](https://www.greasespot.net/).
2. **Install the script:** Install the `TF-9.user.js` file using your userscript manager.
3. **Configure your API Key:**
* On any Torn page, you will see the "Target Finder (TF-9)" panel.
* Click the settings icon (⚙️).
* Enter your Torn API key and click "Save".
4. **Scan for Targets:**
* Navigate to a page in Torn that has links to user profiles (e.g., a faction's member list, a forum thread).
* Use the filters in the Target Finder panel to set your desired criteria.
* Click the "Scan Page for Targets" button.
5. **Review Targets:** The list will populate with users found on the page that match your filters.
## Rule Compliance
This script is designed to be fully compliant with Torn's scripting rules. It functions as an information overlay, using only two methods to gather data:
1. It reads user IDs from the page you are currently viewing.
2. It uses your personal API key to fetch public user data for those IDs.
The script **does not** automate any actions, emulate clicks, or send any non-API requests to Torn. All information is gathered and displayed to assist you, but all actions must be taken manually by you.
## License
This project is licensed under the MIT License.
