Estimate progress to your next Torn level.
# Torn Level Progress+
Estimate how close you are to your next level in Torn, right on the page — no more guessing or manually digging through the Hall of Fame.
## What it does
Torn doesn't show you a progress bar toward your next level — you're either "Level 5" or "Level 6" with nothing in between. **Torn Level Progress+** fills that gap.
It works out your position between two "inactivity markers": long-inactive players sitting at the top of your current level and the bottom of the next one. Comparing your Hall of Fame rank against those two markers gives a stable, meaningful percentage — instead of something that swings wildly every time active players around you level up or drop levels.
The result is shown as a small, color-coded progress bar placed right next to your stats panel (Name / Money / Points / Level / Rank), so it's visible wherever your level number normally is. It automatically refreshes as you browse, and also settles into a floating panel if it ever can't find that stats panel on a given page.
## Features
- **Live progress bar** — fills from red to green as you approach your next level, with a smooth color gradient rather than sudden jumps.
- **Status line** — "Just Started," "Making Progress," "Over Halfway," "Excellent Progress," so you get a read at a glance.
- **Estimated days remaining** — once it has a couple of data points, it looks at your recent progress history and estimates how many days until you level up at your current pace.
- **Smart caching** — the expensive Hall of Fame lookup is cached for 24 hours; only your live rank is re-checked on every refresh, keeping API usage light.
- **Auto-refresh** — updates automatically once a minute, and also whenever you navigate to a new page within Torn.
- **Settings panel** — press `Ctrl+Shift+L`, use the on-page gear button, or the Tampermonkey menu to update your API key, clear the cache, clear your progress history, and disable/enable floating window
- **Rate-limit aware** — respects Torn's API limits and backs off automatically if you're close to them.
## Requirements
- A Torn **API key** (Public access is enough — the script only reads Hall of Fame and your own level/rank data).
- A userscript manager: [Tampermonkey](https://www.tampermonkey.net/) (recommended), Violentmonkey, or similar.
## Installation
1. Install Tampermonkey (or your preferred userscript manager) for your browser.
2. Install this script.
3. Visit any page on torn.com. Click the Tampermonkey icon → **Configure API Key** (or use the on-page gear button / `Ctrl+Shift+L`) and paste in your Torn API key.
4. That's it — the progress panel appears automatically.
## Privacy & data
Torn API Terms of Service disclosure:
Data Storage: Persistent — stored only in your browser's local userscript storage
Data Sharing: Nobody — nothing leaves your browser
Purpose of Use: Personal progress tracking only
Key Storage & Sharing: Stored locally via Tampermonkey; never transmitted anywhere except directly to api.torn.com
Key Access Level: Public
Your API key and all cached data (Hall of Fame markers, progress history) are stored locally by your userscript manager and are never sent anywhere except directly to Torn's own API. Nothing is collected, logged, or shared with the script author or any third party.
## How the math works (for the curious)
Every level in Torn has a huge range of possible ranks. The script finds two reference points:
- The **highest-ranked inactive player** still sitting at your *current* level (someone who hasn't played in a long time, so their position is a stable anchor).
- The **highest-ranked inactive player** at your *next* level.
Your percentage is simply how far your live rank sits between those two anchors. Because both anchors are long-inactive players, they barely move — so the percentage progresses steadily instead of jittering around as active players shuffle past you.
## Known limitations
- Progress is an *estimate* based on Hall of Fame position, not an exact percentage Torn itself calculates — it's a best-effort approximation.
- The "days remaining" estimate needs at least two refreshes spaced apart to have any history to work from; it'll say "Collecting progress history..." until then.
- Very high levels (near 100) or levels with unusually few inactive players nearby may produce less precise estimates.
## Changelog
**2.0.0-alpha1**
- Rewritten from the ground up with class-based structure, request rate limiting, and 24-hour caching.
- Added settings panel, progress history tracking, and estimated days-to-level-up.
- Smooth color-graded progress bar.
- Auto-refresh every 60 seconds plus on in-page navigation.
