Torn Racing Telemetry README
🏎️ Torn Racing Telemetry
Enhance your Torn.com racing experience with a professional UI, highly accurate real-time telemetry, detailed stats analysis with charts, and personal history tracking.
✨ What's New in v3.4.1 ✨
- 🚀 Major Telemetry Engine Overhaul: The core calculation engine has been completely rebuilt. It now uses an advanced Exponential Moving Average (EMA) model for incredibly smooth and accurate Speed & Acceleration tracking, gracefully handling gaps in game data. Lap time estimates are now significantly more stable and predictive.
- 🆔 Race ID Capture & Export: The script now identifies and includes the unique Race ID in all data exports, making it easier than ever to log and analyze specific races.
- ⚡ API Caching & Reliability: Static data (track names, car stats) is now cached for 24 hours, drastically reducing API calls and making the Stats Panel load much faster. API requests are also more robust with a new auto-retry mechanism.
- 📜 History Panel Export: You can now export your entire racing progression log (skill, class, points) directly from the History Panel.
📋 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 highly accurate real-time telemetry, detailed driver statistics, advanced race performance analysis with charts, and personal racing skill/points history tracking. It integrates seamlessly into the Torn racing page, offering valuable insights to give you a competitive edge.
Version: See the GreasyFork page for the latest version.
Author: TheProgrammer [2782979]
Key Features
| 📊 Enhanced UI & Telemetry | 📈 Data & Analysis | ⚙️ Tracking & Configuration |
|---|
- Accurate Real-time Telemetry: Highly smoothed Speed, Acceleration, & Est. Lap Times using an advanced prediction model.
- Customizable Display: Choose units (mph/kmh), data points, color-coding, and animations.
- Enhanced Driver List: Optional replacement for Torn's list, always 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).
- Track & Car Analysis: View records, win/podium/crash rates, and analyze top-performing cars (Requires API Key).
- Interactive Charts: Visualize performance trends for tracks, cars, and personal skill progression.
- Efficient API Usage: Caching for track/car data reduces load times and API call frequency.
| - History Panel: Automatically logs changes in your Racing Skill, Class, and Points over time (API Key required for Points).
- Race ID Capture: Tags each race with a unique ID for better logging and exporting.
- Race Results Export: Download or copy final race results in various formats (HTML, CSV, JSON, Markdown, Text).
- History Export: Download your full skill/points progression from the History Panel.
- Fully Configurable: Fine-tune every aspect of the script through the modern settings panel.
|
Enhanced Driver List & Telemetry
When enabled (default), the script hides Torn's default leaderboard and presents its own dynamic list, complete with telemetry data. Clicking on any driver expands their entry to show a detailed stats panel.
Understanding the Telemetry:
- 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) A stable, predictive time remaining for the current lap, shown in parentheses (~X:XX).
- Status Icons: 🥇 🥈 🥉 for podium, 🏁 for finished, and 💥 for crashed.
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. It loads faster than ever thanks to intelligent data caching.
- 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.
- Features an 'Export' button to download your entire progression history.
Settings & Customization
The '⚙ Settings' button opens a panel allowing full customization of the script's features.
- 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 its 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 for userscripts. 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 any 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 full 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 accurate is the telemetry data now?
- As of v3.4, the telemetry engine is significantly more accurate. It uses an advanced Exponential Moving Average (EMA) model to smooth data and predict values during game update lags. While it's still an estimation based on the visible progress bar, it provides a very stable and realistic comparison between drivers.
- What is the new "Race ID"?
- The Race ID is a unique number that Torn assigns to every race. The script now captures this ID and includes it in your exported race data. This is useful for keeping a perfect log of your races, as you can uniquely identify every single result.
- 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, full History Tracking), a key is required.
- 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.
