GreasyFork listing description

Not part of the script - this is the text meant for the GreasyFork "Additional info" / description field when publishing, kept separate so it can be edited without touching the script or the version changelog.

IMPORTANT: set the Additional info format toggle to Markdown (not HTML) on GreasyFork, or the **bold** and ### headings below render as literal characters.

BUSTR helps you win the busting game before you ever click a prisoner. It shows you how many jail busts you can safely make right now, and which prisoners are the easiest to bust, so your nerve goes into busts that actually land instead of landing you in jail.

What it does

• Reads only your own Torn data (level and perks) plus the jail page already open in front of you. It never touches anyone else's data.
• Adds a hardness score and a live success percentage to every prisoner on the jail page, so your real odds are right there at a glance.
• Tracks your bust penalty, the hidden cooldown that builds up as you bust, and estimates how many busts you have left before your success rate drops off.
• Can learn from your own results over time to fine-tune its predictions to you. This self-calibration is fully passive and reads only the bust-result text Torn already shows you.
• Optional Quick Bust / Quick Bail (off by default): relabels Torn's own bust/bail link so your single click skips the "are you sure?" step.
• Optional Easy Bust / Easy Bail (off by default, behind a consent prompt): a one-tap button on the jail header that sends one request for the single best shown target - bust picks the highest success %, bail the cheapest. Strictly one tap = one request; see the rules note below.
• A jail-list refresh button that reloads just the captive list in place, with no full page reload.
• Puts its settings button in Torn's sidebar right under TornTools, styled to look like a native row.

Your privacy and your account come first

• BUSTR never automates anything: no bots, no loops, no timers, and it never acts on its own or walks the target list. By default it is fully read-only - it reads the page and shows you numbers and colours. Two opt-in helpers (off by default) go further only on your command: Quick Bust relabels your own click to skip Torn's confirm step, and Easy Bust (behind a consent prompt) sends one bust request for one chosen target per tap of its button. Both stay strictly one deliberate tap = one request, same page, never more. The full statement lives in the COMPLIANCE NOTE at the top of the script, and it is a hard rule.
• Your API key never leaves your device. It is stored locally and used only for Torn's own official API. It is never uploaded anywhere, including when cloud sync is on.
• By default everything BUSTR stores stays on your device, through your userscript manager or localStorage on PDA. The only exception is the optional cloud sync below, which is off unless you turn it on.
• Optional cloud sync (opt-in, off by default): you can choose to back up your bust history so it follows you across your devices - desktop and Torn PDA both, so your phone and computer share one history. It asks for explicit consent the first time you enable it, and uploads your bust history along with the context behind your predictions - your bust perks, level, calibration, BUSTR settings and script version - all so the success model can be improved. Never your API key, name, or faction. It can be turned off and its cloud copy deleted at any time from the settings panel. Leave it off and BUSTR is fully local, exactly as before. When it is on it is deliberately lightweight: a whole busting session is saved in a single upload and it only checks for changes from your other devices about once an hour, so it adds no noticeable overhead.

Performance

The refresh rate in Settings (default 30 seconds, down to a 15 second floor) only changes how smoothly the on-screen countdown updates. It does not change how often BUSTR calls the Torn API. Those calls happen only on the jail page, throttled to at most once every 35 seconds there. Off the jail page BUSTR makes no API calls at all: your bust log can only change when you bust (which happens on the jail page), so everywhere else the budget badge is shown from cached data plus simple time-decay, with zero requests. BUSTR also pauses completely whenever its tab is in the background. The result is negligible API, CPU, and battery use, even on lower-end devices.

Helping improve BUSTR

The settings panel has an optional "Copy debug export" button. It is opt-in and one-way, with no import. It copies a JSON snapshot of your level, settings, detected perks, current penalty, calibration, and logged bust history to your clipboard, so you can share it with the maintainer if you want to help improve the model. It never includes your API key, Torn username, ID, or faction, because the script never reads or stores any of those.

Requirements

A Torn API key with the basic, perks, and log selections, which is your level, your bust perks, and your own bust history. Nothing else. You do not need to hand over a Full Access key: the settings panel has a Create a key for BUSTR button that opens Torn's API page with exactly those three boxes pre-ticked and nothing else, so the key it makes cannot touch your money, your mail, or your faction. Generate it there, paste it back in. It is stored on your device only and sent nowhere except Torn's own API.

How this differs from the original BUSTR

This build began as Adobi and Ironhydedragon's original BUSTR (forked at v1.0.11) and has grown well past a simple bugfix branch. Alongside their hardness score and penalty budget tracker, it adds a full per-target success prediction, built from the community Advanced Jail Bust Guide and then fitted and cross-validated against real logged bust outcomes: penalty is weighted at the strength the data actually shows, and the displayed odds are calibrated so they mean what they say. It will never show you 100%, because in the real outcome data even the best-looking targets fail sometimes, and an honest 67% beats a flattering 100%. Add self-calibration that keeps learning from your own results, perk-aware calibration, a proper in-page settings panel, and a dedicated nav button with your live numbers on both desktop and PDA. In short, this one also tells you your odds, not just your hardness and budget numbers.

Credits

This is a fork of BUSTR v1.0.11 by Adobi and Ironhydedragon, published separately with their blessing. The original is still maintained and worth a look if you want the lighter version: search Greasy Fork for "BUSTR: Busting Reminder + PDA".

Everything here is built on their foundation. The hardness score, the penalty budget model and the jail list integration are theirs. This build adds the per-target success prediction and its calibration against real outcome data, self-calibration, reliability and storage hardening, the settings panel, and the PDA nav integration, by The_Baron [1467784].

Credit also to RussianRob and Nosy, whose corrected penalty decay curve landed in the original's v1.1.0 and turns out to match the one derived here independently.

MIT licensed, same as the original.