WinBSPC version 1.3

by Mr Elusive

1999-05-29

Contents

Description
System requirements
Usage
Troubleshooting
Legal stuff
Availability
Credits
Version changes

Description

WinBSPC is a tool designed to do the following:

- Convert .BSP or .MAP files to .AAS files that the Gladiator bot needs to play a map.
- Convert .BSP files to .MAP files. Handy if you lost your original .MAP file.
- Extract files from .PAK or .SIN files.

Note that it can read to be converted .BSP files directly out of .PAK or .SIN files.

WinBSPC can be used with all BSPs (game maps, mission pack maps, custom maps etc.) of the following games:

- Quake 1
- Quake 2
- Heretic 2
- Sin
- Half-Life

System requirements

A PC running Win95/98 or WinNT.

Usage

Launch the application using windows explorer or the Run command.

1. Converting files

1.1 How to

To convert BSP or MAP files to AAS, or BSP or MAP files go to the File menu and choose Convert.
Multiple .bsp, .map, .pak or .sin files can be selected in the Open dialog. If .pak or .sin were selected then the Pak File dialog will popup for every one of them. Multiple files can also be selected In this dialog. After selecting all the files several settings can be specified in the Conversion Settings dialog.

Conversion settings:

number of threads |  | number of threads to use for converting, NOT recommended to use more than one thread on single processor systems.
no verbose |  | don't print verbose output.
no CSG |  | the brush overlap won't be removed.
best match texturing |  | texture placement won't be exactly correct but less brushes will be created.
no brush merging |  | brushes will not be merged, the created map file will have more brushes.
no liquids |  | the water, slime and lava brushes won't be written to a map file.
output folder |  | folder to output the converted file(s) to.

The conversions will be listed in the list view at the left. Any number of conversions can be listed and will be processed one by one.
While converting new conversion can be added to the list. Conversions listed can be changed and/or deleted by right clicking on them.

1.2 AAS Files

The AAS removes the whole business of messing around with (often?) badly placed waypoints. We think waypoints are old-fashioned anyway. Comparing the waypoint system with AAS, and we came up with this: All other bots navigate a map like blind men in darkness using a flashlight while wearing sunglasses, while the AAS file is the same as if seeing persons running around in daylight with sunblock factor 60 on. Yeah that's the ticket!
Currently the Gladiator bot only supports Quake2. Although creating .AAS files for the other games is possible, you won't be able to use them with the Gladiator bot!

2. Extracting files

To extract files from .PAK or .SIN files go to the File menu and choose Extract.
Multiple .pak and .sin files can be selected in the Open dialog. For all the selected .pak and .sin files the Pak File dialog will popup. The files to be extracted can be selected in this dialog.

3. Scripting

A script is used to automate converting or extracting files. A script can be loaded using the Script option in the File menu. A script file has been included for scripting examples.
Note: the WinBSPC command-line is also interpreted as a script.

Troubleshooting

Game: Quake 2
Q2DM3: There is a misplaced ladder brush just outside the lava trap with the hyperblaster bait, next to the real ladder. Occasionally the Gladiator bot has problems using this virtual "ladder".

Please include the 'winbspc.log' file in bug reports.

Legal stuff

By using this product you agree to exempt, without reservation, the authors and owners of this product or components thereof from any responsibility for liability, damage caused, or loss, directly or indirectly, including but not limited to, any interruptions of service, loss of business, or any other consequential damages resulting from the use of or operation of this product or components thereof. No warranties are made, expressed or implied, regarding the usage, functionality, or implied operability of this product. All elements are available solely on an "as-is" basis. Usage is subject to the user's own risk.

This product may be distributed as long as all the files in this archive remain intact and unmodified and are distributed together and there is no charge for the distribution. Any commercial use of WinBSPC without prior written consent by the author is prohibited.

id Software, Valve and Ritual entertainment do not distribute, nor support this product.

WinBSPC is designed to decompile material in which you own the copyright or have obtained permission to decompile from the copyright owner. Unless you own the copyright or have permission to decompile from the copyright owner, you may be violating copyright law and be subject to payment of damages and other remedies. If you are uncertain about your rights, contact your legal advisor.
Most game companies and/or map authors probably won't mind using a program like this to decompile their maps and look at how they're constructed, but distributing their maps or using the entire or parts of their maps in other maps is certainly not allowed. Legally, you have no right to decompile maps in which you don't own the copyright.
To quote the Quake2 license agreement:
"You, either directly or in- directly, shall not do the following: reverse engineer, disassemble, decompile, modify or alter the Software. The term "Software" includes all elements of the Software such as data files, images appearing in the Software and screen displays."

Availability

You can find the latest version at http://www.botepidemic.com/gladiator.

Credits

id Software
B.D.Squatt
Mr Freeze

Thanks to the beta testers:

Adrian [Pinky] Finol
Allan [Strider] Kivlin
Dominic [Cube] Rutter
Matt [Genocyde] Freitas
Timm Stokke

Version changes

WinBSPC version 1.3

- fixed bsp loading problem

WinBSPC version 1.2

- enabled map 2 bsp converting
- fixed beta string and updated .AAS file version
- fixed creating path to store converted files

WinBSPC version 1.1

- Fixed func_door_rotating for AAS

WinBSPC version 1.0

- Fixed multithreading.
- Added number of threads selection combo box to the conversion settings dialog.
- Added Q1 & HL best match brush side texture placement.
- Added Q1 & HL exact brush side texture placement.
- Added Q1 & HL brush merging.
- Added 'best match texturing' option to the conversion settings dialog.
- Added 'no brush merging' option to the conversion settings dialog.
- Added Extract progress dialog with cancel option.
- Added overwrite prompt before extracting.
- Added script option and command-line script.

WinBSPC version 0.9

- Fixed sewer64.bsp overflow bug.
- Added conversion properties dialog.
- Fixed blocked conversion thread after properties were shown.
- Added Half-Life brush texturing.
- Added Quake1 support.
- Added extracting files from a Pak File.
- Fixed overwrite bug.
- Added file filter in Pak File dialog.
- Added files sizes in Pak File dialog.

WinBSPC version 0.8

- It works faster than the command prompt version.
- Added Sin support.
- Added Half-Life support.