OC Spawn Assistance — Setup guide

← Back to start

Automated organized-crime slot filling, ready-to-spawn signals, and a banker-claim flow for Torn factions running organized crimes.

1. Install the userscript

  1. Install Tampermonkey in Chrome / Edge / Firefox (skip if you already installed it for FactionOps)
  2. Open https://tornwar.com/scripts/oc-spawn-assistance.user.js
  3. Tampermonkey shows an install prompt — click Install
  4. Reload torn.com/factions.php?step=your
  5. The OC Spawn panel appears under your OC list

2. Authenticate

The script asks for your Torn API key on first load. Use a Limited Access key — never a Full key.

Limited tier already covers everything OC Spawn reads (faction crimes, members, basic faction info). Don't use Full Access — OC Spawn never needs write permissions.

Key safety: every API key warboard stores is encrypted at rest with AES-256-GCM. The decryption key lives only in the server's environment variables. Keys are never sent back to the browser after the first paste, never logged, and never exposed via any API endpoint. Revoke any key at any time at https://www.torn.com/preferences.php#tab=api and the next warboard call using it will fail.

3. Configure admin roles (one-time, faction admin)

OC Spawn has its own admin roles list (independent from FactionOps). It controls who sees the Admin / Manager / Engines / Members tabs.

In OC Spawn:

  1. Open the Admin tab (only leadership sees it initially)
  2. Edit the Admin roles field
  3. Save

Default: leader, co-leader. Add banker if your bankers handle vault claims.

4. FFScouter API key (optional)

If your faction has someone registered at https://ffscouter.com, paste their key into OC Spawn → Settings → FFScouter API Key. OC Spawn uses it server-side to attribute crime-blocker delays to each member's real takeoff time (so a member flying 6h shows 6h delay; one flying 20 min shows 20 min — instead of both showing the OC-ready age).

Without it, OC Spawn falls back to each member's own stored key and only resolves the lookup for members personally registered at FFScouter. The same key is shared with FactionOps if you also use that service.

5. PWA notifications (optional, recommended for bankers)

A separate PWA at https://tornwar.com/notifications rings the device when:

Setup (per device):

  1. Important for Torn PDA users: open the URL in your phone's real browser (Safari on iOS, Chrome on Android) — not inside the PDA app. PDA's WebView can't receive Web Push, so the PWA has to live outside it.
  2. Add to Home Screen (iOS Share menu → Add to Home Screen; Android ⋮ → Install app)
  3. Open from the new home-screen icon (this launches it as a standalone PWA, separate from your browser tabs)
  4. Paste your Torn API key, tap Enable on this device
  5. Tick the notification preferences you want
  6. Send a test push to confirm

iOS 16.4+ required for Web Push. Once installed, notifications ring even when the PWA isn't open and even when PDA isn't running.

6. OC-specific issues

SymptomLikely causeFix
OC Spawn tabs missingYour role isn't in the OC admin roles listOC Spawn → Admin → add your role
"Access restricted"Faction not on partner allowlist or trial expiredContact RussianRob
Spawn signal not firingOC isn't actually full / member not opted inCheck the slot list; member needs to be opted into spawn assistance
Notifications stopped after iOS updateWeb Push subscriptions expireRe-enable on the device via the PWA
"Outdated script" 426 errorTampermonkey hasn't pulled the latest versionTampermonkey dashboard → Check for userscript updates

Subscription tiers

TierHowDuration
Partner factionGranted by RussianRob via /adminPermanent or N weeks
Xanax subscriberSend Xanax to RussianRob via faction armoury7 days (2 xanax) or 30 days (20 xanax)
TrialFirst xanax sent grants instant trial access7 days

Renewals via xanax are detected within 5 minutes.

Getting help

Send a message to RussianRob [137558] in Torn with:

Don't paste your API key. Ever.

Quick reference

← StartHomeTermsPrivacy