Inspired by this amazing article about Choco Jumps and HOU5E's schedule charts. Highly recommend reading this article before starting ur jumps!
Choco Jump Helper — userscript for timing your Choco Jumps
Fixed banner at the top of every Torn page that walks you through the Choco Jump cycle end-to-end. Live data via your API key — banner ticks every second.
What it does
- Cycle phase guidance — Fill Energy → Pop Xanax → Ecstasy CD → BBC + Ecstasy → Train + Refill → Wind Down → Stack Xanax. Color-coded: green = act now, amber = wait, red = problem, grey = rest.
- Online-hours-aware — set when you're in-game; helper won't tell you to pop Xanax if the BBC step lands outside your hours, and times the bedtime Xanax to your declared bedtime.
- Bedtime energy stacking — works out the exact stop-training moment so energy regens back to 150 by bedtime, letting you pop Xanax then and wake to 400 stacked energy for tomorrow's first Xanax.
- Optional Daytime Xanax window — auto-derived from your live booster CD (no manual logging needed).
- Half (Double) Choco Jump mode for 2 jumps/day at 24 BBC + 12h booster CD.
- HUD readouts — Energy, Drug CD, Booster CD, Next Jump time, all updated from the API every 15s.
Install
Script on GreasyFork: greasyfork.org/en/scripts/579806-choco-jump-helper
Desktop (Chrome / Firefox / Edge / Safari)
- Install a userscript manager — Tampermonkey is the easiest. Violentmonkey and Greasemonkey also work.
- Open the GreasyFork page and click Install this script. Tampermonkey will pop up — confirm.
- Visit any
torn.compage. The banner shows up at the top. - Click the ⚙ icon on the banner. Paste your Torn API key (generate one at torn.com/preferences → API — Public scope is enough). Set method (Full / Half) and your online hours. Save.
TornPDA (iOS / Android)
- Open TornPDA, then go to More → Userscripts.
- Tap + Add new.
- Paste this URL into the script source field:
https://greasyfork.org/scripts/579806/code/choco-jump-helper.user.js
(or copy it from the GreasyFork page's Install this script button.) - Save, then reload Torn inside TornPDA. The banner should appear at the top.
- Tap the ⚙ icon, paste your API key, set your method and online hours.
Note for TornPDA: the banner is responsive — under ~560px width it collapses the title to a coloured edge bar to keep the action text readable.
Privacy
API key stays in your userscript manager's local storage. The script talks only to api.torn.com — no third parties, no telemetry.
Credits
Schedule charts and cycle definition by HOU5E [2337920] (forum article linked at top). This script just makes them tick in real time.
Crafted by Nicram [3702492] — all tips welcome ♥
Feedback / bug reports welcome — drop a reply.
Mentions: HOU5E [2337920] · Nicram [3702492] · Choco Jump (Happy Jump Alt)