# RoflLens

> RoflLens is a Python library and CLI for analysing League of Legends ROFL v2 replay containers and network transport. It exports blocks and payloads, and offers patch-specific decoders for events such as movement, spells and deaths when the client version, protocol digest and executable hash match.

- Type: Tool
- Targets: Binary · Game · Protocol
- Category: Protocol analysis tools
- Relationship: Foundation tool
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-06
- Original resource: <https://github.com/ss26367098/rofllens>
- Primary source: <https://github.com/ss26367098/rofllens/blob/62a475a8f05e7dfa94df5990758be2156c892496/README.md>
- Catalog page: <https://awesomerea.org/resources/rofllens/>
- Record JSON: <https://awesomerea.org/resources/rofllens/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/rofllens/index.md)

## Requirements & limits

- **Prerequisites:** Python 3.11–3.13 and a .rofl replay file are required.
- **Prerequisites:** Patch-specific semantic decoding requires optional dependencies and the user's exact matching League of Legends.exe.
- **Limits:** Several gameplay semantics remain unresolved; mismatched clients receive transport-only output or an error.
- **License:** MIT.

## Primary sources

1. <https://github.com/ss26367098/rofllens/blob/62a475a8f05e7dfa94df5990758be2156c892496/README.md>
2. <https://github.com/ss26367098/rofllens/blob/62a475a8f05e7dfa94df5990758be2156c892496/docs/research-methodology.md>

## More in Protocols

- [LogicAnalyzer](https://awesomerea.org/resources/logicanalyzer/index.md) · Tool
- [BtleJuice](https://awesomerea.org/resources/btlejuice/index.md) · Tool
- [NearDrop](https://awesomerea.org/resources/neardrop/index.md) · Tool
- [Impacket](https://awesomerea.org/resources/impacket/index.md) · Tool
- [open-appleremote: Siri Remote protocol reconstruction](https://awesomerea.org/resources/open-appleremote-case/index.md) · Case study
- [GAMEKB-K17: reconstructing a macropad configuration protocol](https://awesomerea.org/resources/gamekb-k17-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.
