Skip to content

About

Torn WarRoom connector

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

Β 

History

30 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

RR - Torn War Helper

A userscript that enhances the Torn City war experience by providing real-time attack notifications and comprehensive ranked war statistics.

WarRoom Banner

Features

🎯 Real-Time Attack Coordination

  • 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

Attack Notifications

πŸ“Š Enhanced Ranked War Statistics

  • 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

Ranked War Stats

βš™οΈ Highly Configurable

  • 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

Settings Modal

Installation

Prerequisites

  1. Tampermonkey browser extension

  2. Torn API Key (public level is sufficient)

Install Script

  1. Click here to install: Install RR - Torn War Helper
  2. Tampermonkey will open showing the script
  3. Click Install
  4. Navigate to any Torn page
  5. Click the βš™οΈ settings button that appears
  6. Enter your Torn API key
  7. Configure your preferences
  8. Click Save

Usage

Attack Notifications

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

Creating Coordinated Attacks

When viewing a target's profile:

  1. A "Coordinated Attack" button appears below the attack section
  2. Click it to open the dialog
  3. Set:
    • Number of people needed (2-30)
    • Expiration time (1-15 minutes)
    • Wait until full option
  4. Click Create
  5. The attack is shared with all faction members using WarRoom

Ranked War Stats

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

Settings

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

Controls

Main Buttons

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...

Technical Details

Compatibility

  • 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

Performance

  • Minimal impact on page load
  • Efficient SignalR long-polling connection
  • Smart caching for stats (1-hour TTL)
  • Automatic reconnection on connection loss

Privacy & Security

  • API key stored locally in browser storage
  • JWT tokens expire after defined period
  • No data sent to third parties
  • All communications over HTTPS

RR - Torn Bank Helper

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.

What it does

  • 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 withdraw does

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.

Installation

  1. Install Tampermonkey (see the prerequisites above).
  2. Install the script: Install RR - Torn Bank Helper
  3. Open the Tampermonkey menu on any Torn page and choose Set Torn API key.
  4. 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.

Torn PDA

No setup at all β€” PDA supplies the API key at install time, and no menu command is registered.

Notes

  • 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 cancel in 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.

Support & Contribution

Issues

Found a bug? Open an issue

Updates

Both scripts auto-update through Tampermonkey. Manual updates available at:

Development

Built with:

  • Vanilla JavaScript (ES6+)
  • SignalR (long-polling for real-time)
  • Tampermonkey GM API
  • Modern CSS with animations

Credits

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.

About

Torn WarRoom connector

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages