FF Scout estimates player battle stats using Fair Fight (FF) calculations from attack logs.

The system uses real attack data and actual battle stats (from opted-in users) to calculate estimates for other players.

Unlike simple FF calculators, FF Scout uses actual hit data from attack logs to build accurate estimates.

1. Users opt in and enable FF Consent in their profile settings.
2. The cron fetches attack logs from users who have consented.
3. For each attack, the system checks if the contributing user has battle stats for the exact date of the attack.
4. If the user has stats for that date, the attack is processed.
5. The system extracts hits, misses, damage, and weapons used from the attack log.
6. Using the contributing user's stats and the attack data, the system estimates the target's stats.
7. Estimates are stored and confidence is calculated based on actual hits, not just number of attacks.

Key insight: Stats must match the attack date exactly. No fallback to different dates.

Confidence is calculated based on actual hits recorded, not just the number of attacks.

Additional confidence factors:

• Total attempts (hits + misses) – More attempts = more data
• Number of attacks – More attacks = more data points
• Age of data – Confidence decays 5% per day with no new data
• Weapons used – Multiple weapons provide more data

Why hits matter more than attacks: A single attack with 10 hits provides more data than 10 attacks with 1 hit each. More hits = more accurate estimate.

For each estimate, FF Scout stores:

• Stats – Estimated strength, speed, defence, dexterity
• Hits & Misses – Total hits and misses from all attacks
• Accuracy – Hit rate percentage
• Weapons – All weapons used and their damage modifiers
• Damage – Total damage and damage per hit
• Age – When the estimate was last updated

To contribute to FF Scout:

1. Go to Profile Settings.
2. Ensure you are opted in.
3. Enable FF Consent (Allow my attack logs to be used for FF estimates).
4. Make sure your API key has the attacks and stats scopes.

Once enabled, the cron will process your attack logs in the next run.

Note: Your attack logs are only used to estimate OTHER players. Your own stats are never shared as estimates.

When viewing an estimate, you'll see:

• Confidence – Percentage based on hits recorded (see table above)
• Confidence Bar – Visual indicator with color coding
• Attacks – Number of attack logs used
• Hits – Total hits recorded
• Misses – Total misses recorded
• Accuracy – Hit rate percentage
• Weapons Used – All weapons and their modifiers
• Stats – Estimated strength, speed, defence, dexterity, total
• Age – How old the estimate is

If confidence is low, the estimate will show how many more hits are needed for better reliability.

Common reasons for low confidence:

• Not enough hits – Need at least 15 hits for good reliability
• Data is old – Confidence decays 5% per day
• Low accuracy – Many misses reduce confidence
• Few attacks – More attacks = more data points
• Contributor has limited stats – More stats = better estimates

To improve confidence, more attack data needs to be collected from consenting users.