This guide is a work in progress!

Not all information is complete, and there are likely to be errors.

Prelude

This book aims to describe the process of how to implement CS2 Demo parsing and streaming.

As of writing (Apr 2024), there is very little information on how read and process this format. We intend to detail it here, collecting information from a number of implementations and our own research.

Referencing this guide will help us double/triple check our implementation, and we hope that developers can implement and understand this format/protocol and not go through the pain that we did.

Resources

To make understanding easier, I would recommend a few resources:

Contributing

This book is not perfect. If you spot a mistake, wish to update or refactor wording your more than welcome too. We use MDBook, and it's all written in Markdown, so it's easy to edit. Open an Issue or a Pull-Request on GitHub and We'll give it a look!

Questions & Feedback

If you have any questions or feedback, please feel free to reach out to me on discord (samhdev)

Alternatively, an unrelated project has a Discord Server that sometimes helps with demo parsing. They're a friendly bunch of people who are interested in the topic.

Authors