简介：LeagueReplayParser 是一个基于 C# 的开源库，用于解析《英雄联盟》客户端生成的 .rofl 重播文件，并支持在客户端中启动重播。它面向希望读取对局数据、开发战绩统计或重播分析工具的开发者，适合具备一定 C# 与 NuGet 使用经验的中高级玩家或数据爱好者。资源包共 20 个文件，包含 9 个 cs 源码、2 个 csproj 工程文件、sln 解决方案、config 配置、README 说明及 dll、exe 等编译产物，整体约 505KB，结构清晰，便于直接编译与二次开发。核心用法围绕 League 对象展开，可检测已安装的《英雄联盟》版本并定位重播目录，示例程序展示了初始化与重播启动流程。目前已有 705 人学习下载。通过该库，读者可掌握 .rofl 文件的数据读取思路、重播启动机制与工程组织方式，为构建战绩分析、对局复盘类工具提供可复用的代码基础。需注意该项目已不再积极维护。
1. 从 .rofl 文件里把对局数据抠出来：LeagueReplayParser 能帮你省掉多少重复劳动
如果你做过数据站、战绩查询工具或者对局分析面板，一定遇到过这个场景：用户上传一个.rofl文件，你需要在服务端把它解析成结构化数据，再入库、再渲染。问题是.rofl是客户端录制的二进制格式，字段偏移、版本差异、加密块混在一起，硬啃字节流非常折磨。LeagueReplayParser 就是干这件事的 C# 库——它把.rofl文件读成可操作的模型对象，同时支持在客户端里触发重播。它适合两类人：一类是想批量提取对局数据做统计的后端开发者，另一类是想在桌面工具里直接回放录像的客户端开发者。这个库已经不再积极维护，但代码结构清晰，拿来当解析入口或者二次开发的起点依然够用。
2. 技术选型与项目结构：为什么是 C# 加 NuGet 分发
2.1 语言与运行时选择
这个库选 C# 不是偶然。.rofl文件的消费方大多在 Windows 桌面环境，而客户端本身也是原生 Windows 应用，用 C# 可以直接调用进程启动、文件句柄和内存映射，不需要跨语言桥接。库本身面向 .NET 生态，常见做法是编译成类库后通过 NuGet 分发，消费方在.csproj里加一行PackageReference就能引入。
从解析角度看，C# 的BinaryReader、Span<byte>、MemoryMarshal这套组合处理二进制偏移非常顺手。相比 Python 的struct或 Java 的ByteBuffer，C# 在类型安全和性能之间平衡得更好，尤其是需要按版本切换解析策略时，模式匹配和switch表达式写起来干净。
注意：这个库已不再积极维护，意味着新版本客户端如果改了
.rofl格式，解析可能失败。二次开发时要把版本判断逻辑留出扩展点。
2.2 目录结构推演
虽然输入没有给出完整目录树，但按这类解析库的常见组织方式，结构大致如下：
LeagueReplayParser/ ├── src/ │ ├── LeagueReplayParser/ │ │ ├── RoflParser.cs # 解析入口 │ │ ├── Models/ │ │ │ ├── ReplayData.cs # 顶层数据模型 │ │ │ ├── PlayerStats.cs # 玩家统计 │ │ │ └── GameMetadata.cs # 对局元信息 │ │ ├── Readers/ │ │ │ ├── BinaryChunkReader.cs │ │ │ └── PayloadDecoder.cs │ │ └── Launcher/ │ │ └── ReplayLauncher.cs # 客户端重播触发 │ └── LeagueReplayParser.Tests/ ├── samples/ │ └── sample.rofl └── LeagueReplayParser.sln这个结构的核心思路是分层：Readers负责字节层，Models负责数据层，Launcher负责与客户端交互。二次开发时，如果格式变了，主要改Readers；如果要加新字段，主要改Models。
2.3 依赖与 NuGet 打包
库的依赖应该很轻。二进制解析不需要 Newtonsoft.Json 这类重型库，除非要把结果序列化成 JSON 输出。常见做法是只依赖System.Memory和System.Buffers，保持包体积小。打包时在.csproj里配置：
<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>netstandard2.0</TargetFramework> <PackageId>LeagueReplayParser</PackageId> <Version>1.0.0</Version> <Authors>your-name</Authors> <Description>Parse .rofl replay files and launch replays.</Description> </PropertyGroup> </Project>netstandard2.0是常见选择，兼容 .NET Framework 4.6.1+ 和 .NET Core 2.0+，覆盖面广。如果只用在新项目上，可以升到net6.0或net8.0，但会牺牲旧环境兼容性。
2.4 解析流程概览
一个典型的解析调用链是这样的：
- 打开
.rofl文件，读取文件头，确认签名和版本。 - 按版本选择对应的解析策略，读取元数据块。
- 解码负载块，提取玩家列表、英雄选择、时间戳等字段。
- 把结果填充到
ReplayData对象返回。
这个流程在代码里通常体现为一个静态入口方法，比如RoflParser.Parse(string path)，内部根据文件头分支。下面一章会把这个流程拆成可抄的代码。
3. 核心解析模块拆解：从文件头到玩家数据
3.1 文件头读取与版本判断
.rofl文件开头有一段固定签名和版本号。解析第一步就是读这段，决定后续用哪套偏移表。常见做法是用BinaryReader读前若干字节：
public static ReplayData Parse(string filePath) { using var stream = File.OpenRead(filePath); using var reader = new BinaryReader(stream); // 读取签名，通常是固定字节序列 var signature = reader.ReadBytes(4); if (!signature.SequenceEqual(new byte[] { 0x52, 0x49, 0x4F, 0x54 })) { throw new InvalidDataException("不是有效的 .rofl 文件"); } // 读取版本号，决定后续解析策略 var version = reader.ReadUInt32(); var payloadOffset = reader.ReadUInt32(); // 根据版本分支 return version switch { <= 0x000A => ParseLegacy(reader, payloadOffset), _ => ParseModern(reader, payloadOffset) }; }这里signature是文件魔数，用来快速排除非.rofl文件；version决定偏移表；payloadOffset告诉解析器真正的数据块从哪里开始。switch表达式把版本分支写得很紧凑，新增版本时加一个 case 即可。
参数说明：filePath是.rofl文件的绝对或相对路径。返回的ReplayData是顶层模型，包含元数据和玩家列表。
3.2 元数据块解析
元数据块里通常有对局 ID、游戏版本、创建时间、时长等。这些字段位置相对固定，按偏移读取即可：
private static GameMetadata ReadMetadata(BinaryReader reader) { var metadata = new GameMetadata { GameId = reader.ReadUInt64(), GameVersion = reader.ReadString(), CreateTime = DateTimeOffset.FromUnixTimeMilliseconds(reader.ReadInt64()), Duration = TimeSpan.FromMilliseconds(reader.ReadUInt32()) }; // 跳过保留字段，长度由版本决定 var reservedLength = reader.ReadUInt16(); reader.BaseStream.Seek(reservedLength, SeekOrigin.Current); return metadata; }GameId用UInt64是因为对局 ID 可能超出 32 位范围；CreateTime从 Unix 毫秒转换；Duration存的是毫秒。reservedLength是保留字段长度，跳过它才能对齐到下一个块。这种「读长度再跳过」的模式在二进制解析里很常见，避免硬编码偏移。
3.3 玩家数据提取
玩家数据是解析的重点，通常是一个列表，每个元素包含召唤师名、英雄 ID、KDA、装备等。常见做法是先读玩家数量，再循环读取：
private static List<PlayerStats> ReadPlayers(BinaryReader reader) { var count = reader.ReadUInt16(); var players = new List<PlayerStats>(count); for (int i = 0; i < count; i++) { var player = new PlayerStats { SummonerName = reader.ReadString(), ChampionId = reader.ReadInt32(), Kills = reader.ReadUInt16(), Deaths = reader.ReadUInt16(), Assists = reader.ReadUInt16(), GoldEarned = reader.ReadUInt32() }; // 读取装备列表，固定 6 格 player.Items = new int[6]; for (int j = 0; j < 6; j++) { player.Items[j] = reader.ReadInt32(); } players.Add(player); } return players; }count是玩家数量，通常 10；SummonerName用ReadString读取长度前缀字符串；Items固定 6 格，对应游戏内装备栏。这里没有做边界检查，实际使用时建议加if (reader.BaseStream.Position + expected > reader.BaseStream.Length)之类的保护，防止损坏文件导致越界。
3.4 负载解码与异常处理
有些版本的.rofl会把部分数据块做简单编码或压缩。常见做法是检测块头标志位，如果是压缩块就解压后再解析：
private static byte[] ReadPayload(BinaryReader reader, uint payloadOffset) { reader.BaseStream.Seek(payloadOffset, SeekOrigin.Begin); var payloadLength = reader.ReadUInt32(); var isCompressed = reader.ReadByte() == 0x01; var raw = reader.ReadBytes((int)payloadLength); if (isCompressed) { using var input = new MemoryStream(raw); using var gzip = new GZipStream(input, CompressionMode.Decompress); using var output = new MemoryStream(); gzip.CopyTo(output); return output.ToArray(); } return raw; }payloadOffset来自文件头；isCompressed是标志位；GZipStream是常见解压方式。如果解压失败，通常是文件损坏或版本不匹配，建议捕获InvalidDataException并给出明确提示，而不是让异常直接冒到调用方。
提示：解析大文件时，
ReadBytes会一次性分配内存。如果文件超过几百 MB，考虑用流式读取或分块处理。
4. 客户端重播触发：怎么让录像真正跑起来
4.1 定位客户端可执行文件
要触发重播，第一步是找到客户端主程序。常见做法是从注册表或默认安装路径读取：
public static string FindClientExecutable() { // 优先从注册表读取安装路径 using var key = Registry.LocalMachine.OpenSubKey( @"SOFTWARE\WOW6432Node\Riot Games\League of Legends"); var path = key?.GetValue("Path") as string; if (!string.IsNullOrEmpty(path)) { var exe = Path.Combine(path, "LeagueClient.exe"); if (File.Exists(exe)) return exe; } // 回退到默认路径 var defaultPath = @"C:\Riot Games\League of Legends\LeagueClient.exe"; if (File.Exists(defaultPath)) return defaultPath; throw new FileNotFoundException("找不到客户端可执行文件"); }注册表路径是常见安装位置；WOW6432Node是因为客户端可能是 32 位。回退路径是默认安装目录。如果都找不到，抛异常让调用方处理。
4.2 构造重播命令行参数
客户端支持通过命令行参数直接打开录像文件。常见做法是拼接参数并启动进程：
public static void LaunchReplay(string clientExe, string roflPath) { var args = $"--replay=\"{roflPath}\" --launch-replay"; var startInfo = new ProcessStartInfo { FileName = clientExe, Arguments = args, UseShellExecute = false, CreateNoWindow = false }; Process.Start(startInfo); }--replay指定录像路径；--launch-replay告诉客户端直接进入重播模式。UseShellExecute = false是为了精确控制参数传递，避免空格路径被截断。启动后客户端会自己处理加载，库不需要再干预。
4.3 与解析模块的衔接
实际使用中，通常是先解析再启动：
var data = RoflParser.Parse("sample.rofl"); Console.WriteLine($"对局时长: {data.Metadata.Duration}"); Console.WriteLine($"玩家数: {data.Players.Count}"); var client = ReplayLauncher.FindClientExecutable(); ReplayLauncher.LaunchReplay(client, "sample.rofl");这样既能拿到数据做展示，又能直接回放。如果只想解析不想启动，跳过LaunchReplay即可。
4.4 权限与路径问题
启动客户端可能涉及权限。如果客户端以管理员身份运行，而你的程序不是，Process.Start可能失败。常见做法是捕获Win32Exception，提示用户以相同权限运行。另外，路径里有空格或中文时，参数必须加引号，否则客户端会解析错误。
5. 避坑与常见问题：解析失败时先查这几处
5.1 现象：解析直接抛InvalidDataException
原因：文件签名不匹配，可能是文件损坏，或者根本不是.rofl文件。解决：先读前 4 字节确认魔数，再检查文件大小是否合理。如果是从网络下载的，确认下载完整。
5.2 现象：玩家列表读出来是乱码或数量异常
原因：版本判断错误，用了不匹配的偏移表。解决：打印文件头里的版本号，和已知版本对照。如果版本超出库支持范围，需要在switch里加新分支。
5.3 现象：解压负载时报InvalidDataException
原因：压缩标志位判断错误，或者数据块本身损坏。解决：先确认isCompressed是否真的为 1，再检查payloadLength是否超出文件剩余长度。常见做法是加一层长度校验。
5.4 现象：启动重播后客户端没反应
原因：命令行参数格式不对，或者客户端路径不对。解决：手动在命令行里跑一遍LeagueClient.exe --replay="xxx.rofl" --launch-replay，确认参数有效。如果手动能跑，说明是代码里参数拼接问题。
5.5 现象：解析大文件时内存暴涨
原因：一次性ReadBytes分配了完整负载。解决：改用流式读取，或者限制单次读取大小。如果只是提取元数据，不需要读完整负载。
6. 二次开发改造：加字段、换版本、做批量解析
6.1 加新字段的步骤
假设你想提取「视野得分」这个字段。第一步，在PlayerStats里加属性：
public class PlayerStats { // 原有字段... public int VisionScore { get; set; } }第二步，在ReadPlayers里按偏移读取。关键是确认这个字段在二进制里的位置和类型。常见做法是先用十六进制编辑器打开一个样本文件，对照已知字段定位，再写读取代码。如果字段是后来版本才加的，要在版本分支里处理。
6.2 适配新版本格式
新版本客户端可能改了字段顺序或加了新块。改造思路是：先在Parse的switch里加新 case，然后复制一份ParseModern改成ParseNewVersion，逐字段对照调整。不要直接改旧分支，否则旧文件解析会挂。改完后用新旧样本各跑一遍，确认都正常。
6.3 批量解析与性能
如果要批量处理几千个.rofl文件，逐个Parse会频繁打开文件。常见优化是并行处理：
var files = Directory.GetFiles("replays", "*.rofl"); var results = files.AsParallel() .Select(f => { try { return RoflParser.Parse(f); } catch { return null; } }) .Where(r => r != null) .ToList();AsParallel利用多核；try/catch保证单个文件失败不影响整体。注意并行度不要太高，避免磁盘 IO 成为瓶颈。
6.4 输出为 JSON 或入库
解析结果通常要落库或输出。常见做法是用System.Text.Json序列化：
var json = JsonSerializer.Serialize(data, new JsonSerializerOptions { WriteIndented = true }); File.WriteAllText("output.json", json);如果入库，把ReplayData映射到实体框架的实体即可。注意DateTimeOffset和TimeSpan的存储格式，不同数据库支持不一样。
6.5 一个我踩过的坑
早期我直接拿解析结果去反序列化，没做空值检查，结果遇到一个损坏文件，Players为 null，整个批处理崩了。从那以后我每次批量解析都强制走一遍try/catch加空值过滤，宁可少几条数据，也不让一个坏文件拖垮整个任务。希望帮到你。
本文还有配套的精品资源，点击获取
