Career Mode User Guide: Difference between revisions

From FSFO Support Hub
No edit summary
No edit summary
Line 30: Line 30:
</div>
</div>


[[FSFO Career Mode User Guide#top|Back to top]]
[[#top|Back to top]]


----
----
Line 49: Line 49:
</div>
</div>


[[FSFO Career Mode User Guide#top|Back to top]]
[[#top|Back to top]]


----
----
Line 82: Line 82:
</div>
</div>


[[FSFO Career Mode User Guide#top|Back to top]]
[[#top|Back to top]]


----
----
Line 99: Line 99:


* '''Must fly scheduled flight'''
* '''Must fly scheduled flight'''
Only credits career progress when you complete the next pending scheduled leg in order. If enabled and you do not fly the correct leg, the flight can still be logged, but it will not advance total legs, average score, balance, rank, or career tier.
Only credits career progress when you complete the next pending scheduled leg in order.


* '''Passenger comfort'''
* '''Passenger comfort'''
Enables passenger-comfort rules so smoother, better-managed flights matter more to your career results.
Enables passenger-comfort rules.


* '''Can be fired'''
* '''Can be fired'''
Enables the career rule that allows poor performance or major failures to put your employment at risk.
Enables employment risk.


* '''Enable fatigue'''
* '''Enable fatigue'''
Turns on fatigue tracking. If enabled, FSFO checks recent workload and can block career-flight readiness when fatigue rises above the allowed threshold.
Turns on fatigue tracking.


* '''Schedule based on rank'''
* '''Schedule based on rank'''
Automatically builds schedules using the pilot's current rank and tier to determine the maximum leg distance. If a full schedule cannot be built within that cap, FSFO falls back to the full eligible route set.
Builds schedules using rank.


* '''Must have type rating'''
* '''Must have type rating'''
Requires the pilot to hold the appropriate type rating before operating aircraft that need one.
Requires appropriate type rating.


* '''Lock schedule until complete'''
* '''Lock schedule until complete'''
Prevents generating a new schedule while an existing schedule still has incomplete legs.
Prevents new schedule generation.


* '''Application based on rank'''
* '''Application based on rank'''
Makes company applications depend on your current rank, including tier eligibility and hiring probability. It also enforces the rejection cooldown for repeat applications.
Controls hiring eligibility.


[[FSFO Career Mode User Guide#top|Back to top]]
[[#top|Back to top]]


----
----
Line 128: Line 128:
== Companies and Company Tiers ==
== Companies and Company Tiers ==


Companies are loaded from ''Airlines.cfg''. Each airline has a tier. That tier affects hiring rules, contract leg requirements, and pay scaling.
Companies are loaded from ''Airlines.cfg''.


<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
<pre>
Current contract-leg requirements by company tier:
Tier 1 = 30 legs
Tier 1 = 30 legs
Tier 2 = 60 legs
Tier 2 = 60 legs
Line 143: Line 141:


<div style="margin:0.6em 0; padding:0.6em 0.8em; background:#fdf7f2; border-left:4px solid #f0ad4e;">
<div style="margin:0.6em 0; padding:0.6em 0.8em; background:#fdf7f2; border-left:4px solid #f0ad4e;">
If you leave a company before satisfying the required legs, Career Mode can apply a contract-break penalty.
Leaving early may result in a contract penalty.
</div>
</div>


[[FSFO Career Mode User Guide#top|Back to top]]
[[#top|Back to top]]


----
----
Line 152: Line 150:
== Ranks ==
== Ranks ==


Career Mode uses a five-rank system:
* Cadet
 
* Second Officer
* '''Rank 1''' - Cadet
* First Officer
* '''Rank 2''' - Second Officer
* Captain
* '''Rank 3''' - First Officer
* Senior Captain
* '''Rank 4''' - Captain
* '''Rank 5''' - Senior Captain
 
Your rank affects:
 
* the maximum leg distance used in automatic scheduling
* your bidding advantage when schedules are generated
* which companies you can apply to if rank-based hiring is enabled
* your promotion eligibility
* your pay multiplier through Career Tier


[[FSFO Career Mode User Guide#top|Back to top]]
[[#top|Back to top]]


----
----


== How Promotions Work ==
== How Promotions Work ==
Promotions are based on two things:
* '''Total Legs'''
* '''Average Score'''


<div style="margin:0.6em 0; padding:0.6em 0.8em; background:#fdf7f2; border-left:4px solid #f0ad4e;">
<div style="margin:0.6em 0; padding:0.6em 0.8em; background:#fdf7f2; border-left:4px solid #f0ad4e;">
<strong>Requirement:</strong> Your <strong>Average Score</strong> must be at least <strong>92.0</strong> before any promotion is possible.
Minimum average score: 92.0
</div>
 
<div style="margin:0.6em 0; padding:0.8em 1em; background:#f4f9f6; border-left:6px solid #5cb85c; border-radius:8px;">
<pre>
Promotion thresholds:
 
50 total legs  = Second Officer
125 total legs = First Officer
200 total legs = Captain
350 total legs = Senior Captain
</pre>
</div>
</div>
If your flight is not credited toward progression, it will not count toward promotion.
[[FSFO Career Mode User Guide#top|Back to top]]
----
== Career Tier and Pay ==
Career Tier increases with promotion. Pay is recalculated using a tier multiplier.


<div style="margin:0.6em 0; padding:0.8em 1em; background:#f4f9f6; border-left:6px solid #5cb85c; border-radius:8px;">
<div style="margin:0.6em 0; padding:0.8em 1em; background:#f4f9f6; border-left:6px solid #5cb85c; border-radius:8px;">
<pre>
<pre>
Current pay multipliers:
50  = Second Officer
 
125 = First Officer
Tier 1 = 1.00x
200 = Captain
Tier 2 = 1.04x
350 = Senior Captain
Tier 3 = 1.08x
Tier 4 = 1.12x
Tier 5 = 1.16x
</pre>
</pre>
</div>
</div>


When you are promoted, FSFO updates:
[[#top|Back to top]]
 
* your rank
* your career tier
* your pay per hour
 
[[FSFO Career Mode User Guide#top|Back to top]]
 
----
 
== Company Applications ==
 
If '''Application based on rank''' is enabled, not every pilot can freely join every airline tier.
 
<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
Current hiring chances:
 
Cadet
- Tier 1 = 100%
 
Second Officer
- Tier 1 = 100%
- Tier 2 = 50%
 
First Officer
- Tier 1 = 100%
- Tier 2 = 100%
- Tier 3 = 50%
 
Captain
- Tier 1 = 100%
- Tier 2 = 100%
- Tier 3 = 75%
 
Senior Captain
- Tier 1 = 100%
- Tier 2 = 100%
- Tier 3 = 95%
</pre>
</div>
 
<div style="margin:0.6em 0; padding:0.6em 0.8em; background:#fdf7f2; border-left:4px solid #f0ad4e;">
If you are rejected by the same company, FSFO enforces a 7-day wait before trying again.
</div>
 
[[FSFO Career Mode User Guide#top|Back to top]]
 
----
 
== Type Ratings and Training ==
 
Use '''Apply Type Rating''' after you have joined a company.
 
Type rating requests will be blocked if:
 
* no pilot profile exists
* the pilot is not currently employed by a company
* the pilot is already in training
* the pilot already holds that type rating
 
Two training paths are available:
 
* '''Private Training'''
Costs money immediately
 
* '''Company Training'''
Extends contract legs instead of charging the balance directly
 
Training duration and costs depend on the type rating group.
 
[[FSFO Career Mode User Guide#top|Back to top]]


----
----


== Schedule Generation ==
== Schedule Generation ==
Schedules are built from your route data and filtered by:
* current airline
* rank
* type rating, if type-rating enforcement is enabled
* current location and preferred airport logic
If '''Schedule based on rank''' is enabled, FSFO automatically applies a maximum leg distance by rank:


<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
Line 312: Line 191:
</div>
</div>


FSFO first tries to build a schedule using that cap. If it cannot build a full schedule, it falls back to the full eligible route pool.
[[#top|Back to top]]
 
If '''Schedule based on rank''' is disabled, the Max NM value entered by the user is enforced strictly.
 
If '''Lock schedule until complete''' is enabled, FSFO will not generate a new schedule while an incomplete schedule already exists.
 
[[FSFO Career Mode User Guide#top|Back to top]]
 
----
 
== Schedule Bidding System ==
 
When rank-based scheduling is enabled, FSFO scores route candidates and applies a bidding system.
 
Route scoring currently considers:
 
* base block-time value
* penalties for very short flights
* rank-based length bias
* preferred-airport bonuses
 
FSFO then divides scored routes into a preferred top bucket and a lower bucket.
 
<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
Current rank-based bid chances:
 
Rank 1 = 10%
Rank 2 = 35%
Rank 3 = 60%
Rank 4 = 90%
Rank 5 = 95%
</pre>
</div>
 
If the bidding roll succeeds, FSFO selects from the top 30% of scored routes. Otherwise, it selects from the lower portion of the list.
 
[[FSFO Career Mode User Guide#top|Back to top]]
 
----
 
== Preferred Airport ==
 
You can set a preferred airport for a company. FSFO uses that airport when generating schedules and gives preference to routes that end there, especially near the end of a generated trip.
 
[[FSFO Career Mode User Guide#top|Back to top]]
 
----
 
== Route Map ==
 
After a schedule is generated, FSFO can build a route map from the loaded schedule legs and open it externally.
 
[[FSFO Career Mode User Guide#top|Back to top]]
 
----
 
== When a Flight Counts Toward Progression ==
 
A flight does not automatically count toward career progression.
 
<div style="margin:0.6em 0; padding:0.6em 0.8em; background:#fdf7f2; border-left:4px solid #f0ad4e;">
If <strong>Must fly scheduled flight</strong> is enabled, the flight must complete the <strong>next pending leg in order</strong>.
</div>
 
FSFO compares:
 
* the actual flight number
* the actual departure airport
* the actual arrival airport
 
For the leg to count, the pilot must:
 
* start at the correct airport
* arrive at the correct airport
* match the next pending scheduled leg
 
If the flight does not meet that requirement:
 
* it can still be logged
* it will not increase Total Legs
* it will not update Average Score
* it will not reduce Contract Remaining Legs
* it will not update Balance
* it will not trigger promotion
 
<div style="margin:0.6em 0; padding:0.8em 1em; background:#f4f9f6; border-left:6px solid #5cb85c;">
If the next scheduled leg is completed correctly, it is marked <strong>COMPLETED</strong>. If that was the final remaining leg, the schedule is cleared.
</div>
 
[[FSFO Career Mode User Guide#top|Back to top]]
 
----
 
== Flying a Career Flight ==
 
Before flight, FSFO captures:
 
* company
* flight number
* aircraft
* departure airport
* arrival airport
 
During flight, Career Mode monitors multiple operational and scoring categories.
 
Examples include:
 
* pitch exceedance
* bank exceedance
* G-force exceedance
* IAS exceedance
* taxi-speed exceedance
* light misuse
* fuel-management failures
* landing-performance issues
 
These events affect the total score and increment the appropriate error counters.
 
[[FSFO Career Mode User Guide#top|Back to top]]
 
----
 
== Landing Score ==
 
Landing Score is based on:
 
* vertical speed
* G-force
* distance from the runway threshold
 
<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
When runway data is available, the current weighting is:
 
Vertical speed      = 40%
G-force            = 30%
Touchdown distance  = 30%
</pre>
</div>
 
If runway threshold data is unavailable, the distance portion is redistributed proportionally between vertical speed and G-force.
 
[[FSFO Career Mode User Guide#top|Back to top]]
 
----
 
== Total Score and Qualification ==
 
Career Mode stores both:
 
* '''Landing Score'''
* '''Total Score'''
 
A flight is currently marked '''Qualified for Progression''' when the total score meets the system's qualification rule. The flight log stores that qualification result along with pay, fines, and error counts.
 
[[FSFO Career Mode User Guide#top|Back to top]]
 
----
 
== Fatigue ==
 
If '''Enable fatigue''' is turned on, FSFO calculates fatigue from your recent workload using both:
 
* number of legs
* block hours
 
It evaluates three rolling workload windows:
 
* '''Last 24 hours'''
* '''Last 72 hours'''
* '''Last 7 days'''
 
<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3; border-radius:8px;">
<pre>
Current formula:
 
Acute Load  = max(legs in last 24h / 4,  block hours in last 24h / 8)
Short Load  = max(legs in last 72h / 8,  block hours in last 72h / 18)
Weekly Load = max(legs in last 7d  / 16, block hours in last 7d  / 35)
</pre>
</div>
 
Each load is clamped from 0 to 1.
 
<div style="margin:0.6em 0; padding:0.8em 1em; background:#f4f9f6; border-left:6px solid #5cb85c; border-radius:8px;">
<pre>
Final fatigue:
 
Fatigue = (Acute Load × 50) + (Short Load × 30) + (Weekly Load × 20)
</pre>
</div>
 
The result is capped at 100 and rounded to the nearest whole percent.
 
If fatigue is above the allowed limit, Career Mode readiness should fail until workload decreases.
 
[[FSFO Career Mode User Guide#top|Back to top]]


----
----
Line 515: Line 197:
== Flight Log ==
== Flight Log ==


The Flight Log is the permanent history of your career flights.
Tracks all flights, scores, and performance data.
 
Each flight log entry stores:


* date
[[#top|Back to top]]
* company
* flight number
* aircraft
* from airport
* to airport
* block time
* landing score
* total score
* landing rate
* landing G
* block fuel
* critical/configuration/lights/speed error counts
* qualification result
* pay earned
* fines paid
 
Use the Flight Log window to review your performance over time.
 
[[FSFO Career Mode User Guide#top|Back to top]]
 
----
 
== Notes ==
 
<div style="margin:0.6em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
Quick reference notes for current Career Mode behavior.
</div>
 
* Career Mode currently supports one local pilot profile
* The current schedule stores only the active trip
* The flight log is the permanent historical record
* The current '''Show Contract''' button is not implemented yet
 
[[FSFO Career Mode User Guide#top|Back to top]]


----
----
Line 560: Line 206:


=== "PilotProfile was not found" ===
=== "PilotProfile was not found" ===
 
Rebuild database and apply to a company.
<div style="margin:0.4em 0; padding:0.6em 0.8em; background:#fdf7f2; border-left:4px solid #f0ad4e;">
Create or rebuild the database, then apply to a company.
</div>


=== No schedule was generated ===
=== No schedule was generated ===
Check routes.csv and filters.


Check that:
=== Flight not counted ===
 
Must match scheduled leg.
* ''routes.csv'' exists
* the file format is valid
* routes match the current airline
* type-rating rules are not filtering everything out
* the requested leg count is realistic for the route pool
 
=== My flight did not count toward progression ===
 
If '''Must fly scheduled flight''' is enabled, verify that:
 
* you flew the next pending leg in order
* you started at the scheduled departure airport
* you arrived at the scheduled arrival airport
* the flight number matched when required
 
=== I cannot generate a new schedule ===


If '''Lock schedule until complete''' is enabled, finish the current schedule first or turn that option off.
=== Schedule locked ===
Complete current schedule or disable lock.


----
----


<div style="margin:1em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
<div style="margin:1em 0; padding:0.8em 1em; background:#eef3fb; border-left:6px solid #1f4fa3;">
For additional setup help, see [[Getting Started]]. For general problem solving, see [[Troubleshooting]].
For additional help, see [[Getting Started]] or [[Troubleshooting]].
</div>
</div>


[[Category:User Guide]]
[[Category:User Guide]]
[[Category:Career Mode]]
[[Category:Career Mode]]

Revision as of 12:22, 26 March 2026

FSFO Career Mode User Guide

This page explains how Career Mode works in FSFO, including pilot progression, schedules, training, scoring, fatigue, and the permanent flight log.

Career Mode uses a local database to track your pilot profile, your active schedule, and your long-term flight history.


Overview

Career Mode is built around three main areas:

  • Pilot Profile

Your pilot's name, company, rank, tier, balance, location, type ratings, score, errors, contract legs, and training status

  • Current Schedule

Your active scheduled legs

  • Flight Log

Your permanent flight history and performance record

Use Career Mode if you want persistent progression across multiple flights instead of isolated one-off sessions.

Back to top


Getting Started

To begin using Career Mode:

  1. Open the Career Dashboard
  2. Click Rebuild Database the first time you use Career Mode
  3. Enter your pilot name
  4. Select a company
  5. Optionally select a type rating
  6. Click Apply Company

Once accepted, your pilot profile is created and Career Mode begins tracking your progress.

Back to top


Career Dashboard

The Career Dashboard includes the following major functions:

  • Rebuild Database

Creates or recreates the local career database

  • Apply Company

Applies for a company and creates your pilot profile if needed

  • Apply Type Rating

Starts type-rating training

  • Generate Schedule

Builds your current schedule

  • Load Stats

Refreshes pilot statistics

  • Save Options

Saves career settings

  • Flight Log

Opens the permanent flight history window

NOTE: The current Show Contract button is not implemented yet.

Back to top


Career Options

These options affect how schedules are generated, when flights count toward progression, and whether readiness checks can block a flight.

  • Start from last airport

Requires you to begin your next career flight from your saved current location. If enabled, FSFO checks that you are within 10 NM of the pilot's stored airport before the flight is considered ready.

  • Fatal crash starts over

If enabled, a fatal crash can end your current career and force you to start over.

  • Must fly scheduled flight

Only credits career progress when you complete the next pending scheduled leg in order.

  • Passenger comfort

Enables passenger-comfort rules.

  • Can be fired

Enables employment risk.

  • Enable fatigue

Turns on fatigue tracking.

  • Schedule based on rank

Builds schedules using rank.

  • Must have type rating

Requires appropriate type rating.

  • Lock schedule until complete

Prevents new schedule generation.

  • Application based on rank

Controls hiring eligibility.

Back to top


Companies and Company Tiers

Companies are loaded from Airlines.cfg.

Tier 1 = 30 legs
Tier 2 = 60 legs
Tier 3 = 90 legs
Tier 4 = 120 legs
Tier 5 = 150 legs

Leaving early may result in a contract penalty.

Back to top


Ranks

  • Cadet
  • Second Officer
  • First Officer
  • Captain
  • Senior Captain

Back to top


How Promotions Work

Minimum average score: 92.0

50  = Second Officer
125 = First Officer
200 = Captain
350 = Senior Captain

Back to top


Schedule Generation

Rank 1 = 350 NM
Rank 2 = 650 NM
Rank 3 = 1100 NM
Rank 4 = 1800 NM
Rank 5 = 3000 NM

Back to top


Flight Log

Tracks all flights, scores, and performance data.

Back to top


Troubleshooting

"PilotProfile was not found"

Rebuild database and apply to a company.

No schedule was generated

Check routes.csv and filters.

Flight not counted

Must match scheduled leg.

Schedule locked

Complete current schedule or disable lock.


For additional help, see Getting Started or Troubleshooting.