Chain cordinator

Torn / Torn PDA chain watch coordinator with mobile-safe chain countdown, IndexedDB storage, synced target cache, draggable settings, and target finder

You will need to install an extension such as Tampermonkey, Greasemonkey or Violentmonkey to install this script.

You will need to install an extension such as Tampermonkey to install this script.

You will need to install an extension such as Tampermonkey or Violentmonkey to install this script.

You will need to install an extension such as Tampermonkey or Userscripts to install this script.

You will need to install an extension such as Tampermonkey to install this script.

You will need to install a user script manager extension to install this script.

(I already have a user script manager, let me install it!)

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install an extension such as Stylus to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

You will need to install a user style manager extension to install this style.

(I already have a user style manager, let me install it!)

Author
vreebn
Daily installs
1
Total installs
14
Ratings
0 0 0
Version
26.5.6.0
Created
2026-04-24
Updated
2026-05-06
Size
111 KB
License
MIT
Applies to

Chain cordinator

Chain cordinator is a userscript for Torn and Torn PDA built to help factions maintain a chain, not just start one.

The main goal is simple: make it easier to see who is covering the chain now, who is next, where the gaps are, and how much chain time is left.


Start / Stop control

You can temporarily Stop the script from its settings popup when your faction is not chaining.

This hides the floating panel and stops the script activity without uninstalling it or disabling it from your userscript manager. When you need it again, go to your faction page and press Start.


What it does

The script adds a small floating panel in-game and helps with:

  • detecting your player and self-faction safely from Torn Home
  • reading live chain value and chain timer when visible on the page
  • supporting Torn desktop and Torn PDA / mobile layouts
  • letting you register your own watch
  • showing the current watch and next watch
  • displaying a live chain countdown
  • showing a simple coverage graph and timeline
  • keeping important UI and cached data between refreshes and page changes
  • optionally loading attack targets through FFScouter


What the panel shows

The panel can show things like:

  • Online now
    This is not Torn's real faction online count. It only reflects people who are currently active and using the script.
  • Current watch
    The person currently covering the chain, including when their watch is expected to end.
  • Next watch
    The next person expected to take over.
  • Chain timer
    The live chain countdown read from Torn when available.
  • Faction energy
    Shared energy from users who chose to send it.
  • Coverage graph / timeline
    A quick view of upcoming watch coverage and possible weak spots.


Mobile chain timer behavior

On smaller mobile layouts, Torn does not always show the chain timer directly unless the chain area is opened or tapped.

When the script can read the timer, it starts counting down locally. If the chain value changes, the cached timer is reset until Torn exposes the timer again. This avoids showing an old or misleading chain countdown.


Settings

Settings are available from a draggable ⚙ Chain button on your faction page:

https://www.torn.com/factions.php?step=your

From there you can set:

  • FFScouter API key
  • Fair Fight min / max
  • target count
  • default watch duration
  • share energy
  • Start / Stop


Watch system

You can create your own watch by choosing:

  • start now
  • or a custom TCT time
  • plus a watch duration

Once saved, your watch is synced and shown on the shared board, coverage graph, and timeline.


Target finder

The script includes a Find target section.

That part uses your FFScouter API key to load candidate targets, filter them by your Fair Fight range, and show quick Attack and Profile links.

Targets are cached locally and synced between open Torn tabs. When you open a target's attack or profile link, it is removed from the current target list so the same target is not reused by accident.


API keys

This script does not need a Torn API key for its main chain watch features.

Only the target finder needs an FFScouter API key.


Persistence

The script uses lightweight local storage through IndexedDB so it can recover after refreshes, navigation, and Torn PDA page changes.

It keeps things like:

  • panel position
  • hidden / collapsed state
  • Start / Stop state
  • current UI section
  • saved FFScouter key
  • self player / faction cache
  • recently loaded targets


Important note about faction detection

The script reads your faction identity from your own Torn Home page and then reuses that cached identity on other pages.

This avoids accidentally mixing your faction with faction information from other players' profiles or pages.


Who it is for

This is mainly useful for factions that want a cleaner way to manage chain coverage, handoffs, and visibility during active chains.