https://github.com/ldubos/bevy-histrion-packer
A Bevy plugin to pack assets into a single PAK like file :package:
https://github.com/ldubos/bevy-histrion-packer
assets bevy bevy-engine bundling game-development packing
Last synced: about 1 month ago
JSON representation
A Bevy plugin to pack assets into a single PAK like file :package:
- Host: GitHub
- URL: https://github.com/ldubos/bevy-histrion-packer
- Owner: ldubos
- License: apache-2.0
- Created: 2023-12-28T11:31:04.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-09-02T21:54:48.000Z (about 1 month ago)
- Last Synced: 2025-09-02T23:23:46.057Z (about 1 month ago)
- Topics: assets, bevy, bevy-engine, bundling, game-development, packing
- Language: Rust
- Homepage:
- Size: 10.6 MB
- Stars: 22
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
bevy-histrion-packer

[](https://crates.io/crates/bevy-histrion-packer)
[](https://docs.rs/bevy-histrion-packer)
[](https://github.com/ldubos/bevy-histrion-packer/actions)Pack all your game assets into a single common PAK like file format.
> [!WARNING]
> This crate is in early development.
> Use it with caution as the format and API is not yet stabilized.## File Structure
```
+--------------------------------+ 0x0000
| Header |
+--------------------------------+
| File Content |
+--------------------------------+
| Entries Tables |
+--------------------------------+Header
====================================================
Offset Size Description
0x0000 4 Magic number (HPAK signature)
0x0004 4 Version number (u32)
0x0008 1 Metadata compression method
0x0009 8 Entries offset (u64)Directory Entry
====================================================
Offset Size Description
0x0000 8 Hash of the directory path
0x0008 8 Number of paths in the directory
0x0010 var Array of paths in the directoryFile Entry
====================================================
Offset Size Description
0x0000 8 Path hash (u64)
0x0008 1 Compression method
0x0009 8 Metadata offset (u64)
0x0011 8 Metadata size (u64)
0x0019 8 Data size (u64)Entries Tables
====================================================
Offset Size Description
0x0000 8 Number of directory entries (u64)
0x0008 var Array of directory entries
0x???? 8 Number of file entries (u64)
0x???? var Array of file entries
```## Features
| feature | description |
| ------- | ---------------------------------------------------------------------------------------- |
| writer | Enables the ability to generate a HPAK file with [`HpakWriter`](./src/format/writer.rs). |## Bevy Compatibility
| bevy | bevy-histrion-packer |
| -------- | -------------------- |
| `0.16.0` | `0.6.0` |
| `0.15` | `0.5` |
| `0.14` | `0.4` |
| `0.13` | `0.2-0.3` |
| `0.12` | `0.1` |## License
Dual-licensed under either of
- Apache License, Version 2.0, ([LICENSE-APACHE](/LICENSE-APACHE) or )
- MIT license ([LICENSE-MIT](/LICENSE-MIT) or )at your option.
## Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any
additional terms or conditions.