The Faction section of Torn Hub gives you comprehensive tools for managing and analysing your faction:

• Faction Overview – member list, status tracking, and live chain information.
• Faction Stats – detailed table with live bars, cooldowns, and battle stats for all members.
• War Payout Calculator – calculate fair payouts based on war performance, with saved reports and analytics.
• Faction Settings – grant manager permissions to trusted members.

All data is 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.
• Chain card – shows current chain progress, modifier, and countdown timer.

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 (5 minutes), 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.
• Chain card – shows current chain progress, modifier, and countdown timer.

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

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

The War Payout Calculator helps you fairly distribute war rewards based on member performance. It has three tabs:

🧮 Calculate

• 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). Enter 0 to see payouts of $0 (useful for preview).
• Choose payout mode:
  • By Score – distributes based on respect earned.
  • By Attacks – distributes based on number of attacks made.
• Faction Comparison – shows your faction vs opponent with scores, attacks, respect, rank changes, and rewards.
• Payout Table – displays each member's attacks, score, and rounded payout.
• Opponent Top Scorers – shows the opponent's top performers.
• Auto-save – reports are automatically saved to your faction's report history for later reference.
• Clear Report – clears the current report from your session.

Deduplication – members are automatically deduplicated if the API returns duplicate entries.

📂 Saved Reports

• Search – search saved reports by War ID, username, or payout mode.
• Sortable columns – sort by War ID, Created By, Payout Mode, Paypool, Winner, or War Date.
• Load Report – click 📂 Load to restore a saved report and continue working on it.
• Delete Report – leaders and managers can delete reports using the 🗑️ button.
• Pagination – reports are paginated (20 per page).

Who can use it:

• Any faction member can view saved reports.
• Only Leaders and Managers (as assigned in Faction Settings) can create new reports and delete existing ones.

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

📊 Participation Analytics

• Overview – tracks member participation across all saved war reports for your faction.
• Key Metrics:
  • Participation Rate – (Wars Fought / Wars Present) × 100%
  • Attacks Per War – total attacks / wars present
  • Score Per War – total score / wars present
• Charts – visual breakdown of Attacks Per War and Score Per War for top members.
• Trend Chart – shows faction average score and attacks per war over time.
• Filters – sort by any column, filter by participation level (Very Low, Low, Average, High, Very High).
• Warnings – members with participation below 50% are flagged with a warning list.
• Member Performance Table – shows each member's:
  • Wars Present (included in the report)
  • Wars Fought (had at least 1 attack or score)
  • Participation Rate (%)
  • Total Score, Score Per War
  • Total Attacks, Attacks Per War
  • Status (Very High, High, Average, Low, Very Low, Never Fought)
• Only current faction members – members who have left the faction are excluded from analytics.

Note: Analytics requires at least 2 saved war reports to show meaningful data. Charts require at least 2 wars with data.

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.

War reports – fetched from the Torn API when a user enters a War ID. Reports are saved to the database and shared with all faction members.

Chain data – fetched alongside faction data and displayed in the chain card.

Stale data warning – If a member's battle stats are older than 300 seconds (5 minutes), 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 (and any Managers) can see your bars, cooldowns, and battle stats.
• All members – Every faction member can see your bars, cooldowns, and battle stats.

How the "Sharing" column works on the Faction Stats page:

• ✔️ Leaders – You can see this member's stats because you are a leader or manager, and they have set their share to "Leaders".
• 🔒 Leaders – This member has set their share to "Leaders", but you are not a leader or manager, so you cannot see their stats.
• ✔️ Members – The member has set their share to "All members", and you are a member, so you can see their stats.
• 🔒 None – The member has set their share to "None", so only they can see their own stats.
• ❌ No – The member is not opted in, so no stats are shared (regardless of their share setting).

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 Manager permissions to trusted members via the Faction Settings page (previously called "Stat Viewers").

• Managers have elevated rights:
  • View all opted‑in members' battle stats (like leaders).
  • Create and delete war reports.
  • (Future) Manage faction‑wide settings.
• The page itself is now called Settings in the sidebar, and the permission is labelled Manager.
• Leaders and Co‑leaders do not need to be added – they have full access by default.
• If a member leaves the faction, they are automatically removed from the managers list.

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

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 by the background cron for opted‑in users.
• War reports – saved immediately when calculated. Analytics updates when new reports are saved.
• Chain data – updated whenever the faction data is refreshed.
• 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.