A userscript that enhances the Torn City war experience by providing real-time attack notifications and comprehensive ranked war statistics.
- Live Attack Feed: Receive instant notifications when faction members create coordinated attacks
- Smart Notifications: Toast-style alerts with countdown timers showing time remaining
- Quick Actions: Join attacks, mark as done, or launch attacks directly from notifications
- Auto-Hide: Automatically hide full attacks to keep your feed clean
- Participant Tracking: See who's joining each attack in real-time
- Live Stats Display: View current war limits and requirements directly on the ranked war page
- Member Performance: See individual member stats including hits and average respect
- Compliance Tracking: Visual indicators showing who meets/exceeds war requirements
- Auto-Refresh: Configurable automatic data refresh to keep stats current
- Personal Stats: Quick view of your own performance in the current war
- Flexible Positioning: Place notifications and controls anywhere on screen
- Bottom Left/Right
- Top Left/Right
- Sound Notifications: Optional audio alerts for new attacks (desktop only)
- Toggle Features: Enable/disable individual features as needed
- Persistent Settings: Your preferences are saved automatically
-
Tampermonkey browser extension
-
Torn API Key (public level is sufficient)
- Get yours at: https://www.torn.com/preferences.php#tab=api
- Click here to install: Install RR - Torn War Helper
- Tampermonkey will open showing the script
- Click Install
- Navigate to any Torn page
- Click the βοΈ settings button that appears
- Enter your Torn API key
- Configure your preferences
- Click Save
The script will automatically show notifications when:
- A faction member creates a coordinated attack
- An attack is updated (someone joins)
- An attack becomes full
Each notification shows:
- Target name and ID
- Time remaining (with urgent warning when < 1 minute)
- Number of participants (filled/total)
- List of participants
- Action buttons:
- Join: Join the attack
- Attack: Launch the attack (only if you've joined)
- Done: Mark the attack as complete
When viewing a target's profile:
- A "Coordinated Attack" button appears below the attack section
- Click it to open the dialog
- Set:
- Number of people needed (2-30)
- Expiration time (1-15 minutes)
- Wait until full option
- Click Create
- The attack is shared with all faction members using WarRoom
When on the ranked war page (/factions.php?step=your#/war/rank):
- Current war limits display automatically at the top
- Each member row shows:
- Number of hits (color-coded for compliance)
- Average respect (color-coded for compliance)
- Your personal stats are highlighted
- Click the refresh button to manually update stats
- Toggle auto-refresh with the button icon
Access settings via the βοΈ button. Available options:
General
- API Key: Your Torn API key (required, desktop only)
- Attack Feed: Enable/disable attack notifications
- Auto-hide Full Attacks: Automatically hide completed attacks
Notifications
- Sound Notifications: Play sound for new attacks (desktop only)
- Toast Position: Where notifications appear (4 corners)
Ranked War
- Show Member Stats: Display performance stats on ranked war page
Interface
- Button Position: Where control buttons appear (4 corners)
Maintenance
- Clear Cache: Remove cached target data
- Clear Token: Force re-authentication
- Reset: Restore default settings
| Button | Function | Default Position |
|---|---|---|
| π | Toggle attack feed on/off | Bottom-left |
| βοΈ | Open settings | Bottom-left + 46px |
Button states:
- π Purple: Feed enabled and connected
- π Red with X: Feed disabled
- π Yellow pulsing: Connecting...
- Platforms: Desktop browsers with Tampermonkey
- Pages:
torn.com/loader.php(attack profiles)torn.com/factions.php(ranked war stats)
- API: Uses WarRoom service API + Torn API
- Authentication: JWT-based with automatic token refresh
- Minimal impact on page load
- Efficient SignalR long-polling connection
- Smart caching for stats (1-hour TTL)
- Automatic reconnection on connection loss
- API key stored locally in browser storage
- JWT tokens expire after defined period
- No data sent to third parties
- All communications over HTTPS
A second, separate userscript in this repository: banking.user.js. It puts the faction vault
withdrawal from Discord's /bank withdraw onto the Torn faction page, so a member can ask the
bankers for money without leaving the game.
It does not move money. It creates a request; a banker still pays it on Torn.
- Adds a π° Withdraw button next to the donate control on
https://www.torn.com/factions.php?step=your&type=1#/tab=armoury - Opens a modal for the amount and how long the bankers have (5 minutes to 1 day, 1 hour by default)
- Posts the request to the faction's banking channel on Discord, exactly as
/bank withdrawdoes
Amounts are typed the way Torn players write money β 50m, 1.5b, $50,000,000 β or all for the
whole balance. The amount is sent as text and resolved by the server, so all always means what you
have at that instant.
- Install Tampermonkey (see the prerequisites above).
- Install the script: Install RR - Torn Bank Helper
- Open the Tampermonkey menu on any Torn page and choose Set Torn API key.
- Paste your public Torn API key and click Save. The key is checked immediately.
There is nothing else to configure. To change or remove the key later, use the same menu command.
No setup at all β PDA supplies the API key at install time, and no menu command is registered.
- Your Torn account must belong to a faction registered with the service, and that faction must have a banking channel configured, or the request has nowhere to go.
- You may have one open request at a time. Asking for a second is refused, naming the amount
already outstanding. Cancel it with
/bank cancelin Discord or on the Banking page. - Refusals are shown exactly as the server words them β no message is invented on this side.
- Runs alongside RR - Torn War Helper on the same pages: separate storage, separate styles, separate sign-in.
Found a bug? Open an issue
Both scripts auto-update through Tampermonkey. Manual updates available at:
- War Helper: https://github.com/TuRz4m/warroom-userscript/raw/refs/heads/main/warroom.user.js
- Bank Helper: https://github.com/TuRz4m/warroom-userscript/raw/refs/heads/main/banking.user.js
Built with:
- Vanilla JavaScript (ES6+)
- SignalR (long-polling for real-time)
- Tampermonkey GM API
- Modern CSS with animations
Author: TuRzAm
Version: 1.3.0
License: See LICENSE file
Website: https://torn.zzcraft.net/
This script enhances your Torn City experience. Always follow Torn's rules and terms of service.



