Faction Stats shows real‑time and historical data for all members of your faction:

• Member list – IDs, names, positions, levels, and days in faction.
• Live bars – Energy, nerve, life, happy (updated every 5 minutes via background cron).
• Cooldowns – Drug, medical, booster timers.
• Battle stats – Strength, speed, defence, dexterity (raw and effective).
• Status and activity – Current status (Okay, Hospital, Traveling, etc.) and last action time.

All data is now stored in MySQL – no files are used. This improves performance and reliability.

The Faction page displays your faction's header (banner, name, tag, leader/co‑leader, rank) and a sortable member list.

• Sortable columns – click any column header (ID, Name, Level, Days, Position, Status, Last Action) to sort ascending/descending. Your sort preference is saved.
• Status indicators – a coloured dot shows the member's current state (green = Okay, red = Hospital/Jail, orange = Traveling, yellow = Idle, etc.).
• Countdown timers – for statuses with a duration (e.g., Hospital, Jail), a live countdown shows remaining time.
• Last action – shows the member's last activity relative to now.
• Row background – members inactive for more than 24 hours appear with a fading background.

The member list is cached for 120 seconds (2 minutes). Use the Refresh button to manually update it (60‑second cooldown).

Required scope: faction.

The Faction Stats page provides a comprehensive table with live bars, cooldowns, and battle stats for all members.

• Bars & cooldowns – shown only for members who have opted in and set their share level appropriately (see Privacy section).
• Battle stats – displayed as effective (bold) and raw (parentheses) values, with modifier percentages.
• Sortable columns – click any column header to sort by that metric (e.g., total effective stats).
• Stale data warning – if a member's stats are older than 300 seconds (1 hour), they are flagged with a yellow or red badge.
• Individual growth chart – click the 📈 button next to a member's total effective stats to view their personal stats growth chart.

This table refreshes automatically every 300 seconds (5 minutes) for opted‑in users via the background cron.

Required scopes: faction (for member list), bars & cooldowns (for live bars), stats (for battle stats).

Member list & basic info – Fetched from the faction API endpoint (cached for 120 seconds in MySQL).

Bars, cooldowns, and battle stats – Only collected for members who have opted in.

• If you are opted in, your bars, cooldowns, and battle stats are updated every 300 seconds via the background cron (update_all.php).
• If you are not opted in, your data is not collected – other members will see — for your bars and stats.

Stale data warning – If a member’s battle stats are older than 300 seconds, they will be flagged as stale (🟡 or 🔴). This usually means their API key no longer has the stats scope, or the cron hasn’t run recently.

Your bars, cooldowns, and battle stats are shared according to TWO conditions:

1. You must be opted in. If you are not opted in, nothing is shared – regardless of your share setting.
2. Your share setting (None, Leaders only, All members) only takes effect if you are opted in.

Share setting meanings:

• None – Only you can see your own bars, cooldowns, and battle stats.
• Leaders only – Faction Leader and Co‑leader can see your bars, cooldowns, and battle stats.
• All members – Every faction member can see your bars, cooldowns, and battle stats.

Important reminder: If you are not opted in, setting your share to "All members" does nothing – your data will still be hidden from everyone (except yourself).

You can change these settings on your Profile Settings page.

Log in to see your current opt‑in status, share setting, and your role (leader/viewer/member).

Faction Leaders and Co‑leaders can grant viewer permissions to trusted members, allowing them to see all opted‑in members' battle stats (similar to leaders).

• Viewers are managed via the Stat Viewers page (available to leaders and existing viewers).
• Viewers can see bars, cooldowns, and battle stats of all opted‑in members, regardless of individual share settings (as long as they allow "Leaders only" or "All members").
• This permission is useful for war generals, recruiters, or analysts who need full visibility.
• Viewers are automatically removed if they leave the faction.

Required scope: faction (to load the member list) and stats (to view battle stats).

The War Payout Calculator helps you fairly distribute war rewards based on member performance.

• Enter a Ranked War ID to fetch the war report from Torn.
• Set a PAYPOOL – leave blank to auto‑calculate ( $1,000,000 × total attacks ).
• Choose payout mode: By Score (respect earned) or By Attacks (number of attacks).
• Payouts are rounded down to whole dollars and displayed per member.
• Reports are automatically saved to your faction's report history for later reference.

Required scope: faction (to fetch the war report).

Different faction features require different API key scopes. Here is exactly what each feature needs:

Important: The stats, bars, cooldowns, and faction scopes are not "higher level" – they are simply scopes that you can enable or disable when generating your API key on Torn. To see full faction data, your key must have faction, bars, cooldowns, and (for battle stats) stats scopes enabled.

Recommended: A key with faction, bars, cooldowns, and stats scopes enabled (or a Full Access key) for the best experience.

Need to update your key? Go to Torn API Settings and check the required boxes.

• Faction member list – cached for 120 seconds (2 minutes). Refresh manually with the "Refresh" button on the Faction page (60‑second cooldown).
• Bars, cooldowns, battle stats – updated every 300 seconds (5 minutes) by the background cron for opted‑in users.
• If you see stale data – wait for the next cron run (300 seconds) or check your opt‑in status and API key scopes.

All caches are stored in MySQL and automatically pruned.