pbo

README

go-pbo

A Go library for working with PBO files from Bohemia Interactive.

pbotool

Included is a command line tool for manipulating PBO files.

COMMAND
  pbotool

USAGE
  pbotool SUBCOMMAND ...

SUBCOMMANDS
  inspect   Inspect the contents of a PBO
  grep      Search non-binary files in a PBO
  unpack    Unpack all files from a PBO
  pack      Pack files into a PBO
  version   Print version and build date information

Inspect

COMMAND
  inspect -- Inspect the contents of a PBO

USAGE
  pbotool inspect <file.pbo>

$ pbotool inspect ViralSuppresor.pbo
[Properties]
- product: dayz ugc
- prefix: ViralSuppresor

[Files]
- config.cpp (2138 bytes)
- data\Viral_AK_Sup.paa (601349 bytes)
- data\Viral_AK_Sup.png (1612340 bytes)
- scripts\4_World\Classes\recipe\CraftUniSuppressor.c (4131 bytes)
- scripts\4_World\Classes\recipe\PluginRecipesManagerBase.c (198 bytes)
- texHeaders.bin (208 bytes)

Grep

COMMAND
  grep -- Search non-binary files in a PBO without unpacking

USAGE
  pbotool grep <file.pbo> <pattern>

FLAGS
  -i, --ignore-case   Perform case-insensitive matching.

$ pbotool grep -i ViralSuppresor.pbo cfg
config.cpp:1:class CfgPatches
config.cpp:21:class CfgMods
config.cpp:54:class cfgVehicles

Unpack

COMMAND
  unpack -- Unpack all files from a PBO

USAGE
  pbotool unpack [flags] <file.pbo> <output directory>

FLAGS
  -u, --unrap   De-binarize raP files (i.e. config.bin -> config.cpp)

$ pbotool unpack --unrap ViralSuppresor.pbo ViralSuppresor
2026/03/11 12:54:53 Unpacking config.bin
2026/03/11 12:54:53 Unpacking data\Viral_AK_Sup.paa
2026/03/11 12:54:53 Unpacking data\Viral_AK_Sup.png
2026/03/11 12:54:53 Unpacking scripts\4_World\Classes\recipe\CraftUniSuppressor.c
2026/03/11 12:54:53 Unpacking scripts\4_World\Classes\recipe\PluginRecipesManagerBase.c
2026/03/11 12:54:53 Unpacking texHeaders.bin

$ tree ViralSuppresor
ViralSuppresor
├── config.cpp
├── data
│   ├── Viral_AK_Sup.paa
│   └── Viral_AK_Sup.png
├── scripts
│   └── 4_World
│       └── Classes
│           └── recipe
│               ├── CraftUniSuppressor.c
│               └── PluginRecipesManagerBase.c
└── texHeaders.bin

6 directories, 6 files

Pack

COMMAND
  pack -- Pack files into a PBO

USAGE
  pbotool pack [FLAGS] <file.pbo> <input file>...

FLAGS
  -p, --property STRING   PBO property in the form of key=value. Can be repeated.
  -r, --recursive         Recursively add files from directories.

$ pbotool pack -p "product=dayz ugc" -p prefix=ViralSuppresor -r out.pbo ViralSuppresor
+ ViralSuppresor/config.cpp
+ ViralSuppresor/data/Viral_AK_Sup.paa
+ ViralSuppresor/data/Viral_AK_Sup.png
+ ViralSuppresor/scripts/4_World/Classes/recipe/CraftUniSuppressor.c
+ ViralSuppresor/scripts/4_World/Classes/recipe/PluginRecipesManagerBase.c
+ ViralSuppresor/texHeaders.bin

References

https://community.bistudio.com/wiki/PBO_File_Format

Documentation

Index

• func NewBuilder() *builder
• type File
  • func (f *File) ReadSeeker() (io.ReadSeeker, error)
  • func (f *File) Reader() (io.Reader, error)
• type MimeType
• type PBO
  • func Load(in io.ReadSeeker) (*PBO, error)

Functions

func NewBuilder

func NewBuilder() *builder

Types

type File

type File struct {
	Filename string
	// contains filtered or unexported fields
}

func (*File) ReadSeeker

func (f *File) ReadSeeker() (io.ReadSeeker, error)

func (*File) Reader

func (f *File) Reader() (io.Reader, error)

type MimeType

type MimeType uint32

const (
	Vers  MimeType = 0x56657273
	Cprs  MimeType = 0x43707273
	Enco  MimeType = 0x456e6372
	Dummy MimeType = 0x00000000
)

type PBO

type PBO struct {
	Properties map[string]string
	Files      []File
	// contains filtered or unexported fields
}

func Load

func Load(in io.ReadSeeker) (*PBO, error)