Void.Packer.CLI
1.0.0
There is a newer version of this package available.
See the version list below for details.
See the version list below for details.
dotnet tool install --global Void.Packer.CLI --version 1.0.0
This package contains a .NET tool you can call from the shell/command line.
dotnet new tool-manifest
dotnet tool install --local Void.Packer.CLI --version 1.0.0
This package contains a .NET tool you can call from the shell/command line.
#tool dotnet:?package=Void.Packer.CLI&version=1.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
nuke :add-package Void.Packer.CLI --version 1.0.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Void Packer CLI
Command-line tool for creating, updating, and managing asset packs for Void Engine.
Install
dotnet tool install --global Void.Packer.CLI
Or run from source:
dotnet run --project Void.Packer.CLI -- build -c Content/ -o Packs/
Commands
Build
Creates a new pack from your content directory.
packer build -c Content/ -o Packs/ -n GameAssets
| Option | Short | Description | Default |
|---|---|---|---|
--content |
-c |
Content directory to pack | Required |
--output |
-o |
Output directory | Required |
--name |
-n |
Base name for output files | GameAssets |
--include |
-i |
Include patterns (comma separated) | */ |
--exclude |
-e |
Exclude patterns (comma separated) | None |
--encrypt |
Enable encryption | true | |
--compress |
Compression: None, Deflate, Brotli | Deflate | |
--adaptive |
Use adaptive compression | true | |
--compression-level |
Compression level (1-9) | 6 | |
--chunk-size |
Chunk size in KB (0 = solid) | 1024 | |
--verbose |
-v |
Verbose output | false |
Update
Fast incremental updates — seconds, not minutes.
packer update --pack GameAssets.pack --add Content/newfile.png --remove old/texture.png
| Option | Short | Description | Default |
|---|---|---|---|
--pack |
Existing pack file to update | Required | |
--add |
-a |
Files or folders to add | None |
--remove |
-r |
Virtual paths to remove | None |
--key |
Key file | Auto-detected | |
--output |
-o |
Output path | Overwrite |
Extract
Extracts all files from a pack.
packer extract --pack GameAssets.pack --output Extracted/
| Option | Short | Description | Default |
|---|---|---|---|
--pack |
Pack file to extract | Required | |
--output |
-o |
Output directory | Required |
--key |
Key file | Auto-detected |
Verify
Verifies pack integrity via CRC32 checksums.
packer verify --pack GameAssets.pack
| Option | Short | Description | Default |
|---|---|---|---|
--pack |
Pack file to verify | Required | |
--key |
Key file | Auto-detected |
List
Lists all files in a pack.
packer list --pack GameAssets.pack --detailed
| Option | Short | Description | Default |
|---|---|---|---|
--pack |
Pack file to inspect | Required | |
--key |
Key file | Auto-detected | |
--detailed |
Show detailed info | false |
Auto Key Detection
All commands automatically detect the key file. If you have GameAssets.pack, the tool looks for GameAssets.key in the same directory.
Error Output
User-friendly error messages instead of raw exceptions:
❌ Error: Invalid encryption key.
❌ Error: Pack file not found.
Exit Codes
0= Success1= Failure (CI/CD friendly)
Examples
# Build with exclusions
packer build -c Content/ -o Packs/ -e "**/*.ase*"
# Build with custom chunk size
packer build -c Content/ -o Packs/ --chunk-size 512
# Update a pack
packer update --pack Packs/GameAssets.pack --add Content/newlevel.json
# Extract a pack
packer extract --pack Packs/GameAssets.pack --output Extracted/
# Verify before shipping
packer verify --pack Packs/GameAssets.pack
Requirements
- .NET 10
License
MIT
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
This package has no dependencies.