Torn Racing Telemetry README
🏎️ Torn Racing Telemetry
Enhance your Torn racing experience with real-time telemetry, an advanced UI, detailed stats analysis with charts, and personal history tracking.
📋 Table of Contents
Overview
Torn Racing Telemetry is a comprehensive userscript designed to significantly enhance the racing feature in Torn. It replaces the standard leaderboard with a dynamic, feature-rich interface, providing real-time telemetry data, detailed driver statistics (including API-fetched stats), advanced race performance analysis with charts, and personal racing skill/points history tracking. It integrates seamlessly into the Torn racing page, offering valuable insights without disrupting your experience.
Version: See GreasyFork for the latest version.
Author: TheProgrammer [2782979]
Key Features
| 📊 Enhanced UI & Telemetry | 📈 Data & Analysis | ⚙️ Tracking & Configuration |
|---|
- Real-time Telemetry: Speed, Acceleration, Est. Lap Times.
- Customizable Display: Choose units (mph/kmh), data points, color-coding, and animations.
- Enhanced Driver List: Optional replacement for Torn's list, sorted by position.
- Click-to-View Details: Expand driver entries for detailed status, lap progress, and calculated metrics.
- Color Indicators: Quickly see driver position, status (racing, finished, crashed), and podium finishes.
| - Driver API Stats: View Racing Skill, Points, Win Rate etc. on click (Requires API Key).
- Advanced Stats Panel: In-depth analysis of your historical race performance (Requires API Key).
- Historical Analysis: Overall win/podium/crash rates, performance breakdown by track and car.
- Track Analysis: View records for the current track/class and analyze top-performing cars (Requires API Key).
- Interactive Charts: Visualize performance trends using Chart.js.
| - History Panel: Automatically logs changes in your Racing Skill, Class, and Points over time (API Key recommended for Points).
- Progression Chart: Visualize your skill and points progression.
- Configurable Settings: Fine-tune display, API key, history logging, and UI preferences.
- Info Panel: Access script version, author contact, and important usage notes.
- Race Results Export: Download or copy final race results in various formats (HTML, CSV, JSON, etc.).
|
Telemetry Display Explained
The script adds a telemetry display next to each driver in the enhanced list during a race. Here's an example:
| Pos | Driver | Telemetry | Progress |
|---|
| 1 | JohnRacer [12345] | 95 mph | 0.5 g (~1:15) | 84% |
| 2 | SpeedDemon [67890] (You) | 88 mph | -0.8 g (~1:18) | 82% |
| 3 | RacerKing [44556] | 🏁 1:51.24 (~85 mph) | Finished |
| 4 | CrashTest [77889] | 💥 CRASHED | Crashed |
Understanding the Display:
- Speed: Current calculated speed in your chosen unit (mph or km/h).
- Acceleration: Calculated g-forces. Positive (green) for acceleration, negative (red) for braking/deceleration, grey for neutral speed.
- Est. Lap Time: (Optional) An estimated time remaining for the current lap, shown in parentheses (~X:XX).
- Finished/Crashed Drivers: Clearly marked with status icons and text.
Enhanced Driver List
When enabled (default), the script hides Torn's default leaderboard and presents its own dynamic list.
- Displays driver position, color indicator, car image, name, and real-time telemetry.
- Highlights your own driver entry.
- Clicking on any driver entry expands it to show detailed information, including API-fetched stats if configured.
Advanced Stats Panel
Accessible via the '📊 Stats' button (Requires API Key), this panel provides deep insights into your racing performance based on your recent official race history.
- Overall Performance Summary: Win rate, podium rate, crash rate, and more.
- Performance by Track & Car: Tables and charts showing your stats for each track and car you've raced.
- Current Track Analysis: View track records, analyze top-performing cars, and see stats for your currently selected car.
History Panel
Accessed via the '📜 History' button, this panel tracks your long-term racing progression.
- Logs entries whenever a change in your Racing Skill or Class is detected.
- If an API key is provided, it also periodically checks and logs your Racing Points.
- Includes an interactive line chart visualizing your Skill and Points progression over time.
Interface Controls
The script adds a control bar above the driver list:
┌─────────┐ ┌───────────┐ ┌─────────┐ ┌──────────┐ ┌──────────┐
│ ℹ️ Info │ │ 📜 History│ │ 📊 Stats│ │ 💾 Export│ │ ⚙ Settings│
└─────────┘ └───────────┘ └─────────┘ └──────────┘ └──────────┘
- ℹ️ Info: Opens a panel with script details, version, and notes.
- 📜 History: (Visible if enabled) Opens the History Panel.
- 📊 Stats: (Visible if enabled) Opens the Advanced Stats Panel (Requires API Key).
- 💾 Export: (Visible after race finish) Opens a dialog to export race results.
- ⚙ Settings: Opens the Settings Panel to configure the script and your API key.
Settings Panel
The settings panel allows full customization of the script's features, including:
- Toggling the History and Stats panels on or off.
- Customizing the telemetry display (speed, acceleration, units, animations).
- Managing your Torn API Key for advanced features.
- Configuring data limits and check intervals for history logging and stats analysis.
- Toggling the enhanced driver list.
API Usage & Data Privacy (Terms of Service)
This script is designed with your privacy and security as a top priority. In compliance with Torn's API usage policies, here is a transparent breakdown of how your API key and data are handled:
| Data Storage | Data Sharing | Purpose of Use | Key Storage & Sharing | Key Access Level |
|---|
| Only locally | Nobody | Non-malicious statistical analysis | Stored locally / Not shared | Custom Selections. A 'Limited Access' key is sufficient. Required selections are: user (personalstats, races) and racing (tracks, cars, records). |
In simple terms: Your API key and any data fetched with it are stored only on your own computer within your browser's secure storage. The data is never sent to, shared with, or stored by the script author or any third party.
Installation
Install a Userscript Manager: If you don't have one, install a browser extension like Tampermonkey or Violentmonkey.
Install the Script: Click the link below and your userscript manager should prompt you to install:
Install Torn Racing Telemetry from GreasyFork
Configure (Optional but Recommended):- Navigate to the Torn racing page.
- Click the '⚙ Settings' button added by the script.
- Enter your Torn API Key (Limited Access recommended) to enable the Advanced Stats and History features.
- For Torn PDA Users: The script will automatically detect the app and configure the API key for you. No manual entry is needed!
FAQ
- Does this script violate Torn's rules?
- No. The script enhances the user interface and uses the official Torn API for data retrieval as intended. It fully complies with Torn's policies on scripting and API usage.
- Is my API key safe?
- Yes. Your API key is stored locally in your browser's secure userscript storage. It is ONLY sent directly to the official Torn API (
api.torn.com). For full details, please see the API Usage & Data Privacy section above. - How does this work with the Torn PDA mobile app?
- The script is fully compatible with Torn PDA. It automatically detects when it's running in the app and will configure itself to use the app's managed API key (
###PDA-APIKEY###). This provides a seamless, zero-configuration experience for API-related features on mobile. - Why do I need an API key?
- An API key is needed to fetch data specific to your account or detailed game information not available directly on the race page. The core telemetry display works without a key, but for the best experience (Advanced Stats, History Tracking), a key is required.
- How accurate is the telemetry data?
- The telemetry is calculated based on the progress percentage updates provided by the game. It's a sophisticated estimation and provides a good relative comparison between drivers. However, it's not based on the game's internal physics engine, so it should be used as a guideline.
- The script isn't working after an update. What should I do?
- First, try a hard refresh of the page (Ctrl+Shift+R or Cmd+Shift+R). If that doesn't work, go to the script's Settings panel and use the "Clear Script Data" button (this keeps your API key). If problems persist, contact the author.
Torn Racing Telemetry
Provided under the MIT License. This script is not affiliated with or endorsed by Torn Ltd.
For updates, bug reports, or feature requests, please visit the script's page on Greasy Fork镜像 or contact the author.
