Pack3r

Create release-ready pk3 archives quickly from .map-files

Features

Parses through your map, shaders, mapscript, etc. and discovers files are needed for the map, while leaving out editorimages, lightimages and other files not needed for release (unless -s specified)
Performs compression in-memory, does not create or leave intermediate files, and never modifies the original files (see below)
Support for renaming the map to create release versions such as b1, with automatic renaming of bsp, mapscript, levelshots, arena and more, while the original files are left untouched (-r)
Extensive logging to trace why each file was included in the pk3, including the exact line in a source file / shader where the file was referenced (-sd and -rd)
Support for file discovery from pk3's and pk3dirs, such as sd-mapobjects.pk3 or a texture/model pack extracted into a separate pk3dir to keep etmain clean

Usage

Pack3r <map> [options]

Arguments:

<map> Path to the .map file [required]

Options:

-o, --output Path to destination pk3 or directory, defaults to etmain
-d, --dryrun Discover packed files and estimate file size without creating a pk3 [default: False]
-r, --rename Map release name (bsp, lightmaps, mapscript, etc.)
-v, --verbosity Log severity threshold [default: Info]
-l, --loose Complete packing even if some files are missing [default: False]
-s, --source Pack source files such as .map, editorimages, misc_models [default: False]
-sl, --shaderlist Only read shaders present in shaderlist.txt [default: False]
-sd, --shaderdebug Print shader resolution details (Debug verbosity needed) [default: False]
-rd, --referencedebug Print asset resolution details (Info verbosity needed) [default: False]
-f, --force Overwrite existing files in the output path with impunity [default: False]
-i, --includepk3 Include pk3 files and pk3dirs in etmain when indexing files [default: False]
--ignore Ignore some pk3 files or pk3dir directories [default: pak1.pk3|pak2.pk3|mp_bin.pk3]
-e, --exclude Never pack files found in these pk3s or directories [default: pak0.pk3|pak0.pk3dir]
-m --mods Adds pk3s in these mod folders to exclude-list
-?, -h, --help Show help and usage information
-v, --version Show version information

Example:

.\Pack3r.exe 'C:\Temp\ET\map\ET\etmain\maps\sungilarity.map' --o 'C:\Temp\test.pk3'
.\Pack3r.exe 'C:\Temp\ET\map\ET\etmain\maps\sungilarity.map' --dryrun --includepk3
.\Pack3r.exe 'C:\Temp\ET\map\ET\etmain\maps\sungilarity.map' --output 'C:\releases\' --rename sungilarity_b1 --mods etjump --verbosity debug_

Limitations

Usable only through CLI, no GUI application is planned
Only brush primitives map format is supported (NetRadiant default)
Shaders/textures are parsed from ase, md3, mdc, skin files. Other model formats such as obj are not yet supported (open an issue).
terrain shaders (1to2 etc) are not supported (open an issue)
For performance reasons only a subset of files are considered for packing, see PackableFile() in file Tokens.cs

File priority order

pak0.pk3 (and other --exclude pk3s/directories), if a file or shader is found there, it won't be included in the release
Files inside the relative etmain of your map file (directory contaning /maps)
etmain, if the map is for example in some.pk3dir/maps/mymap.map
pk3dir-folders in etmain, in reverse alphabetical order BSP, lightmaps, mapscript, speakerscript, soundscript, etc. are always assumed to be in the same relative etmain as your map file.

Example

Map is etmain/void.pk3dir/maps/void_b1.map, the priority is: pak0.pk3 -> etmain/void.pk3dir/ -> etmain/ -> any pk3 files in etmain Mapscript must be in etmain/void.pk3dir/maps/ in this case and not directly in etmain

ovska / Pack3r