Quick Start Guide

Welcome to the Quick Start Guide!

Here you'll find all the information you need to get started with Flight Fusion.

Step 1: Sign Up or Log In

  • If you're new, join the waitlist or sign up for an account.
  • If you're a returning user, log in to access your dashboard.

Step 2: Create Your Airline

  • Once logged in, set up your airline by providing a name.
  • Upon creation, you will be given a token that is to be used as a bearer token in all API calls!
  • You’ll also start with a budget of $10,000,000, spend it wisely!

Step 3: Purchase an Aircraft!

  • By calling https://api.flightfusion.io/api/aircraft you will get a list of all the aircraft to purchase. Find one that fits your budget!

This list is constantly being updated!

  • To purchase the aircraft, all you need to do is make a POST request to https://api.flightfusion.io/api/airline/purchase-aircraft with the body of:
{
    "aircraftId": "{{AIRCRAFT_ID}}",
    "registration": "FF-123FD" // Note: This is optional! If not provided, one will be assigned at random! 
}

Once purchased, a copy of the data is made and is put into your airline! This is to resemble an aircraft being ordered from a manufacturer and being delivered for you airline ready for service.

To see a list of your aircraft, you can man a GET request to https://api.flightfusion.io/airline/{AIRLINE_ID}

Step 4: Checkout the airports!

  • But calling https://api.flightfusion.io/api/airport you can take a look at the currently available airports that you can schedule flights to!

This list is constantly being updated!

Step 5: Schedule Your First Flight

This is where the magic happens, and how to make money!

  • Use the API to create a flight route as shown below:
  • A POST request is made to https://api.flightfusion.io/api/flightRoute with the following body:
{
    "aircraftId": "{{AIRCRAFT_ID}}",
    "originAirportId": "{{ORIGIN_AIRPORT_ID}}",
    "destinationAirportId": "{{DESTINATION_AIRPORT_ID}}",
    "departureTime": "2029-06-12T10:57:52.136Z",
    "status": "Scheduled",
    "revenueManagement": {
    "baseFare": 500,
    "taxes": 0.10
    }
}

Note: The aircraftId here is the id of the aircraft that you own! By getting your airline, you can see a list of your aircraft! Do so by calling https://api.flightfusion.io/airline/{AIRLINE_ID} If you need help finding your airline id, decode your auth token, it is a JWT after all 😉

Step 5a: The Game Clock

The game passes time in an accelerated maner, to help thigns move along. Rather than waiting real time for flights to complete, I have forced time in FLight Fusion to move in a way that makes 1 real life second = 24 game time secconds or 1 game day lasts about 1 real life hour. With that in mind, trying to find a time to schedule a flight can be a little confusing, especially when it comes to questions like "what time is it in the game?"

I have created 2 ways to know. The first is the game time is returned on EVERY API response, in the response headers. Look for the header called X-Current-Game-Time. This is a quick and easy way to check. The second is a dedicated API endpoint that returns the game time as a string. This can be called as a GET request to https://api.flightfusion.io/api/game-time.

Step 6: Understand Flight Processing

Once your flight is scheduled, the Flight Fusion Simulation Engine will process it over time. Here’s how it works:

  • Time Acceleration: The simulation uses an accelerated clock where 1 real second = 24 game seconds. This means your flights progress faster than real time!
  • Flight Status Transitions:
    • Scheduled → Boarding: Your flight will move to Boarding status 1 hour before the scheduled departure time.
    • Boarding → Departed: At the scheduled departure time, the flight status changes to Departed.
    • Departed → InFlight: After 15 minutes of game time (about 37.5 real seconds), the flight transitions to InFlight.
    • InFlight → Landed: When the current game time reaches the scheduled arrival time, the flight status updates to Landed.
  • Revenue Calculation: Once the flight lands, the revenue is calculated based on the number of customers booked, the base fare, and taxes. For example, with a base fare of $500, taxes of 0.10 (10%), and 5 customers booked, the total revenue would be:
    • Base revenue: $500 × 5 = $2500
    • Taxes: $2500 × 0.10 = $250
    • Total revenue: $2500 + $250 = $2750

Step 7: Check Flight Status and Increase Bookings

Monitoring your flight’s status not only keeps you updated but also helps you earn more revenue! Here’s why:

  • IMPORTANT Checking Flight Status: You can check the status of your flight by making a GET request to https://api.flightfusion.io/api/flightRoutes/{id}, where {id} is the flight’s ID.
  • Booking Seats: Each time you check the status of a flight while it’s in the Scheduled status, the simulation engine may add more customers to the flight (up to the aircraft’s capacity). This is handled automatically by the simulation engine:
    • The engine randomly books additional seats based on the remaining capacity.
    • For example, if your aircraft has a capacity of 50 seats and 10 seats are already booked, checking the status might add a random number of customers (e.g., 5 more), increasing the total to 15 booked seats.
  • Why This Matters: More booked seats mean more revenue when the flight lands, so check your flight status frequently before departure to maximize bookings!
  • Scheduling flights with expensive tickets may lead to customers not wanting to book with your flight, so plan accordingly!

Please note: This is only temporary as a custom flight processor is being implemented to take care of this for you.

Feedback

If you have any questions, check out the full documentation or reach out via the Contact/Feedback form.

Community

Lastly, if you join our Discord you will be the first to know of new features, bug fixes, and general updates. Additionally, joining will bring into a community of other players to talk strategy! Flight Fusion Discord