
		PboX


	What is it?

PboX is a program to pack and unpack OFP pbo files. It will pack the addon dirs with
only store or with compression also. It will unpack those so called "locked" addons 
too. It previews p3d's (ODOL + MLOD without textures), config.cpp and textures in a 
3d window without the need to unpack the pbo.


	Install

Unrar the release packet into any directory, if you have WrpTool installed, then we 
suggest you place the PboX.exe into the same directory. PboX runs with the two 
standard "wrpTool" dll's (bolndmm.dll & cc3260mt.dll) which can be found in WrpTool 
or ODOL Explorer v2.0 downloads.


	How to use it?

First select "DePbo File" or "Pbo Directory" on the main program window. Depbo is 
where you unpack various pbo files and Pbo directory is to pack directories into 
pbo's.

DePbo file selection displays you a source and target directory browse areas. 
Choose a pbo file first from the source browser, then you can view the contents of 
the pbo in the larger window at below the target browser. You can click the files 
after you have ticked the "Preview selected file" on the right side. Then PboX 
Preview window pops up and you can view p3d ODOL files, paa/pac texture images and 
config.cpp files in this window.

When you have browsed to a source pbo, it has not yet unpacked, if you want to 
unpack (depbo) it to your hard drive you must first press the "Extract All" button 
under the target directory browser. If the target directory browser is not ticked, 
the pbo is unpacked to a subdirectory of the <filename>.pbo at the dir where the 
pbo is located. If you have ticked the target directory browser, then the pbo is 
unpacked to a directory shown in the browser.

The (C) marking in front of the files inside a pbo means that the specific file has 
compression used in the pbo packing. If there is no (C) then its not compressed file.

At the Pbo Directory selection you have two windows, left one is the browser for 
which directory to pack, right one is the contents of the currently selected 
directory. Under is the source directory display which changes every time you browse. 
Target directory browser works the same way as in unpacking, if you have it ticked, 
you need to browse a directory where the contents of the selected source is packed 
as PBO file.

Finally you have the buttons Pbo Directory and Abort. The Abort button only activates
when PboX is currently packing a pbo, so you can abort this process. Next to the 
Abort button is drop down selector of the compression method. There you have three 
options to choose from, compress all, none or as defined in .def file. Read below for 
more details about .def file configuration and compression.


	PboX.def file

The util has configuration file called pboX.def which is created to the PboX.exe 
directory. This includes some configs for the util history like last pbo unpacked 
and last pbo dir packed up to pbo file.

Then there is setup for compressing the files inside a pbo directory. The config 
looks like following:
---
[CompressExt] 
Count=5 
0=.sqm 
1=.sqs 
2=.sqf 
3=.ext 
4=.cpp 
---
That means that we have 5 file extensions chosen to be compressed, they are from 
0 to the 4 (counting five, but you can use more, just remember to update the 
"Count=" value) and as you see we got sqm, sqs, sqf, ext and cpp files to be 
compressed. If you configured the file extensions here, then you can use the PboX 
util and choose:
Compress none
Compress All
compress as defined in Pbox.def
To select which sort of compression, if any you want to use.

Other config parts in the pboX.def you can ignore since they arent really helpful 
to be edited from this file. 

One tip about compressing; if you make lets say campaign with tons of mission dirs 
with mostly text based files (not sure if this goes for addon image/etc files) and 
you want to have the smallest download size, you should NOT COMPRESS the files. 
Instead use no compression at all and then pack the pbo with latest WinRAR (get it 
http://www.rarlabs.com) which compresses it nicely (much smaller than ZIP format), 
so users downloading your release can have smaller download size.

PboX compressed pbo file wont pack as small as uncompressed. So you need to decide 
if you want to have the pbo compressed for OFP or smaller download size on the 
release RAR size.


	Drag and Drop

When you are browsing My Computer and you have PboX running, you can drag and drop 
a PBO file into the DePbo File windows source directory slot. You can also do the 
same for addon, mission, campaign directory and drop it to the Pbo Directory windows 
Source directory slot.


	Parameter passed

Parameter means, that you can set a connection (extension) in windows, so *.pbo 
files are automatically opened by PboX if you doubleclick them.


	Problems?

If you have any problems running PboX, you have bug to report or feature to ask, 
feel free to send us feedback on the WrpTool forum at 
http://flashpoint.nekromantix.com/cgi-bin/yabb/YaBB.cgi?board=7

We are there to support this util if any problems comes up, hopefully there are none.


Credits goes to:
* JaZzBrE author of pbotool, which was the basis of PboX 
* Rom & feersum endjinn for texture research 
* Confucius & OFPInternals for pbo research 
* Lester for testing and great inputs


http://flashpoint.nekromantix.com/wrp.php

October 12th, 2004.
WrpTool Development Team
Dschulle & Snake Man
