Real-time war coordination for Torn factions: target calls, chain bar, hospital alerts, scout reports, post-war analytics, and mobile apps with push notifications.
torn.com and navigate to your faction pageYou'll create two keys at https://www.torn.com/preferences.php#tab=api. Both must be Limited Access tier.
On Torn's API page, click Create a new key, pick the Limited Access radio option, give it a name (so you can identify it later), and click Create. That's it — Limited tier already covers every endpoint warboard reads (chain, faction members, attacks, bars, cooldowns, armoury news, etc.). Don't use Full Access — warboard never needs write permissions.
This is the key each member uses individually. It powers their personal status (energy, cooldowns) and lets them act inside FactionOps (calls, claims, broadcasts).
The faction key is stored server-side and used by warboard's pollers on behalf of the whole faction — chain monitor, war-status sweeps, attacks-feed, ranked-war report. It's what keeps everyone's data fresh even if no member has FactionOps open at that moment. Set it once; warboard handles the rest.
Every API key warboard stores — personal FactionOps keys, the faction key, and pool-shared keys — is encrypted at rest with AES-256-GCM before being written to disk. The decryption key lives only in the server's environment variables, separate from the data files. If a stored key file were ever leaked on its own, the contents would be unreadable without the env-side secret.
Keys are also never sent to the browser after the first paste, never logged, and never exposed via any API endpoint. You can revoke any key at any time from https://www.torn.com/preferences.php#tab=api — the next warboard call using it will fail and the key auto-evicts from caches.
Click ⚙ to open settings. The connection dot should turn green. The Subscription line shows your status:
Below that, the Faction API Key section shows "Key saved ✓" once an admin has stored the faction key.
By default only Leader and Co-leader see admin-only panels (Members bars, post-war report, broadcasts). To delegate, configure the Admin Roles list.
In FactionOps:
leader, co-leader, banker, warmasterThis list gates: Member bars / cooldowns view, post-war report, shout / broadcast.
Warboard polls Torn for chain status, hospital events, attack feeds, and war scores. To avoid burning a single key's 100 calls/min quota, members can opt their key into a shared pool that warboard rotates through.
Recommendation: encourage 5+ members to opt in. Spreads polling load and means you survive any one member being offline / their key being revoked. Use Limited keys only.
The setting is in FactionOps ⚙ Settings → Share my API key with faction pool.
FFScouter (https://ffscouter.com) is a community stat-estimation service. If your faction has someone registered there, paste their key into FactionOps so warboard can use it server-side for:
Set it once in ⚙ Settings → FFScouter API Key. The same key is shared with OC Spawn Assistance — setting it in either place updates both. Leave blank if no one in your faction is on FFScouter; the rest of FactionOps still works fine.
| Platform | How |
|---|---|
| iOS | TestFlight invite from RussianRob [137558] |
| Android | Download https://tornwar.com/warboard.apk and install (allow unknown sources) |
Once installed and signed in with your API key, the apps automatically register for push notifications (no extra setup). They add:
FactionOps fires push notifications for: chain panic, chain about to break, target hospitalized (when one of your called targets pops out), target called by another member, war started / ended, and bonus-imminent (next chain milestone within 2 hits).
How to receive them depends on where you're using warboard:
| Platform | Setup |
|---|---|
| iOS app | Auto-enabled on first launch; allow notifications when prompted |
| Android app | Auto-enabled on first launch; allow notifications when prompted |
| Torn PDA (mobile WebView) | Two options: (a) inside PDA, open FactionOps ⚙ Settings → toggle PDA Notifications on (uses PDA's native bridge — chain alerts only); (b) open https://tornwar.com/notifications in your phone's real browser (Safari / Chrome — not inside PDA), tap Add to Home Screen, then open the new icon and enable. The PWA route works for the full set of warboard notifications and rings even when PDA isn't running. |
| Desktop browser | In-overlay toast notifications only — no OS-level push (use the mobile apps if you need away-from-keyboard alerts) |
Per-notification preferences (which types to ring) are configured per-app: open the app's settings tab. The PWA at https://tornwar.com/notifications has its own preferences page once installed.
| Symptom | Likely cause | Fix |
|---|---|---|
| "Disconnected" persists | API key invalid / faction not subscribed | Check the key in settings; contact RussianRob |
| "No active war" right after a war ends | Server's 12h cutoff filtered the war | Should auto-fall-back within 30s; refresh War tab |
| Member bars empty for some members | Those members haven't opened FactionOps / app | Bars are self-reported by each client; nothing to fix server-side |
| "Outdated script" 426 error | Tampermonkey hasn't pulled the latest version | Tampermonkey dashboard → Check for userscript updates |
| Tier | How | Duration |
|---|---|---|
| Owner faction (Dead Fragment, 42055) | Permanent | — |
| Partner faction | Granted by RussianRob via /admin | Permanent or N weeks |
| Xanax subscriber | Send Xanax to RussianRob via faction armoury | 7 days (2 xanax) or 30 days (20 xanax) |
| Trial | First xanax sent grants instant trial access | 7 days |
The Subscription line in FactionOps settings shows your current status. Renewals via xanax are detected within 5 minutes.
Send a message to RussianRob [137558] in Torn with:
Don't paste your API key. Ever.