Welcome to ValveMDL’s documentation!

https://img.shields.io/github/license/pySourceSDK/ValveMDL.svg https://img.shields.io/pypi/pyversions/valvemdl.svg https://img.shields.io/badge/platform-windows%20%7C%20linux%20%7C%20macos-lightgrey.svg https://img.shields.io/pypi/v/valvemdl.svg https://github.com/pySourceSDK/ValveMDL/actions/workflows/CI.yml/badge.svg _images/coverage.svg

ValveMDL is a python library to read and write .mdl files, the model format of the Source engine, along with their .vvd and .vtx companions.

Note

ValveMDL is about serialization and nothing else. It will read a model apart and put it back together; it will not transform meshes, render anything, or convert to other formats.

Warning

ValveMDL is early. The header and the file-set plumbing are in place; the rest of the format is being worked through structure by structure. See the support table for what is actually readable today.

These pages document the mdl format itself as much as they document the library. If you never intend to write a line of python, the Data structures section is still the reference you came for.

Indices and tables