Skip to main content

​
Overview

The ReplayReader class provides methods to read and parse Fortnite replay files. You can read from either a file path or a stream, and control the level of detail parsed using the ParseType parameter.

​
Basic Usage

​
Reading from a File Path

The simplest way to read a replay is using the ReadReplay(string fileName) method: 
using FortniteReplayReader;
using FortniteReplayReader.Models;
using Unreal.Core.Models.Enums;

var reader = new ReplayReader();
var replay = reader.ReadReplay("path/to/replay.replay", ParseType.Full);

// Access parsed data
var players = replay.GameInformation.Players;
var eliminations = replay.Eliminations;
var stats = replay.Stats;

​
Reading from a Stream

For more control, you can read from a stream using ReadReplay(Stream stream): 
using var stream = File.Open(fileName, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);
var replay = reader.ReadReplay(stream, ParseType.Full);
The stream is automatically wrapped in a BinaryReader and disposed after reading.

​
Parse Type Parameters

The ParseType enum controls how much data is extracted from the replay:

EventsOnly

Parses only events (eliminations, match stats, etc.)

Minimal

Parses events and initial game state

Normal

Parses events and full game state

Full

Parses everything currently handled

​
Parse Type Comparison

Parse TypeEventsGame StatePlayer LocationsInventoryFloor Loot
EventsOnly✅❌❌❌❌
Minimal✅Basic❌❌❌
Normal✅✅✅✅✅
Full✅✅✅✅✅
Higher parse types take longer and consume more memory. Use the lowest parse type that meets your needs.

​
Complete Example from ConsoleReader

Here’s a real-world example from the ConsoleReader project: 
using FortniteReplayReader;
using FortniteReplayReader.Models;
using Microsoft.Extensions.Logging;
using System.Diagnostics;

class Program
{
    static void Main()
    {
        // Setup logging
        var serviceCollection = new ServiceCollection()
            .AddLogging(loggingBuilder => loggingBuilder
                .AddConsole()
                .SetMinimumLevel(LogLevel.Warning));
        var provider = serviceCollection.BuildServiceProvider();
        var logger = provider.GetService<ILogger<Program>>();

        // Create reader with settings
        var reader = new ReplayReader(logger, new FortniteReplaySettings
        {
            PlayerLocationType = LocationTypes.None,
        });

        // Read replay files
        foreach (string replayFile in Directory.GetFiles(@"Replays\\"))
        {
            Console.WriteLine(replayFile);

            var sw = Stopwatch.StartNew();
            var replay = reader.ReadReplay(replayFile, ParseType.Full);
            sw.Stop();

            // Access parsed data
            var players = replay.GameInformation.Players.OrderBy(x => x.Placement);

            Console.WriteLine($"Elapsed: {sw.ElapsedMilliseconds}ms");
            Console.WriteLine($"Total Players: {players.Count()}");
        }
    }
}

​
Constructor Options

The ReplayReader constructor accepts optional parameters: 
public ReplayReader(ILogger logger = null, FortniteReplaySettings settings = null)
  • logger: Optional ILogger for diagnostic output
  • settings: Optional FortniteReplaySettings to configure parsing behavior
var reader = new ReplayReader();

​
Accessing Parsed Data

Once you’ve read a replay, access data through the FortniteReplay object: 
var replay = reader.ReadReplay(replayFile, ParseType.Full);

// Game information
var gameInfo = replay.GameInformation;
var players = gameInfo.Players;
var teams = gameInfo.Teams;
var safeZones = gameInfo.SafeZones;

// Events
var eliminations = replay.Eliminations;
var matchStats = replay.Stats;
var teamStats = replay.TeamStats;

// Metadata
var header = replay.Header;
var info = replay.Info;

​
Next Steps

Configuration

Learn about FortniteReplaySettings options

Player Data

Extract player locations, inventory, and more

Game Events

Work with eliminations and match events

Performance

Optimize parsing for better performance

Build docs developers (and LLMs) love

Get started for freeTalk to us