Metadata-Version: 2.4
Name: blender-asset-tracer
Version: 2.0.4
Summary: BAT parses Blend files and produces dependency information. After installation run `bat --help`
Author: Sybren A. Stüvel
Author-email: Sybren A. Stüvel <sybren@blender.org>
License-Expression: GPL-3.0-or-later
Requires-Dist: cattrs==25.1.1
Requires-Python: ==3.13.*
Description-Content-Type: text/markdown

# Blender Asset Tracer BAT v2

Tool to manage assets with Blender.

Blender Asset Tracer, a.k.a. BAT, is a tool for finding dependencies of blend files, and for packing those dependencies into a self-contained directory.

## Documentation

[BAT documentation](https://projects.blender.org/blender/blender-asset-tracer/src/branch/main/docs/index.md) is available on blender.org.

## Requirements

BAT v2 requires Blender 5.1 or newer.

## Known Limitations

- BAT v2 needs Blender 5.1 or newer to function.
  - Blender 5.1.0 does not report legacy particle system cache files correctly. This is fixed in [blender!155720](https://projects.blender.org/blender/blender/pulls/155720), which will be part of Blender 5.1.1.
  - Blender 5.1.0 does not report Alembic file sequences correctly, see [blender#155774](https://projects.blender.org/blender/blender/issues/155774). For now, BAT does not handle such files correctly either.
  - Blender 5.1.0 does not report Geometry Nodes simulation cache files files, see [blender#155953](https://projects.blender.org/blender/blender/issues/155953). As a result, BAT does not know about these files and will not report them as a dependency or pack them.

To test cases like the above limitations, run the following in Blender's Python console. It should report the files in use by the current blend file:

```py
>>> {k: v for (k, v) in D.file_path_map().items() if v}
{bpy.data.objects['Plane']: {'//meshcache.mdd'}}
```
