BSP HQ Logo by Chainsaw
BSP Headquarters Logo by Chainsaw

|| Back to Main Page ||

Finding Leaks Getting BSP Up and Running Return to the Main Page Problems you Might Encounter
Compiling and Running Your Map

This is a quick summary of what it takes to compile and play your level. Fortunately, BSP makes it easy by providing various compiling options directly in the 'Export' menu. Just look under 'Export' and you'll see 8 different options you can choose from. The first menu selection allows you to run BSPBuild, a program written by Tony Browneller. This is a great program that gives you full control over how you compile your level. It's not required to be able to use BSP, but you might find it handy. Go here if you are interested in it.

The next option is new to version .83. It allows you to select a group of brushes and export just these brushes. It's handy for testing portions of a level without compiling the entire level. Select an area of your map and activate this option. You will see the following dialog box:

Export Selected Dialog box

Chances are the portion of your map you are exporting is going to be incomplete, so BSP gives you the option to include a bounding box around the portion you are exporting. If you select 'Include Bounding Walls', then the wall, floor, and sky textures you select will be used to form a box around the area you have selected as it's exported. Just select an export option from the 'Export Type' dialog and select OK. The options under 'Export Type' are the same as the options on the 'Export' menu (which I'll explain next).

The other six options on the export menu run a combination of 3 different programs with various options enabled. The three programs these menu items run are QBSP, LIGHT, and VIS, which you should have downloaded already. If you don't have them, you need to get them - there's a link on the 'getting started' page to a file called QBSP256ZIP. This file contains all the utilities you need.

The six different compiling options BSP provides are detailed below. One word about these before I explain them. Each option you can select actually runs a *.BAT file which resides in your C:\BSP directory. These batch files compile your level with various options enabled and then run Quake. If you're like me, I prefer to have Quake running permanently in the background. I recommend this if you have at least 24 meg RAM. QBSP requires a LOT of memory and hard disk space. Any less than 24 meg and QBSP may crash with Quake also running.

If you have the horsepower to run Quake in the background, you can edit the batch files in the C:\BSP directory to remove the line which runs Quake. If you go this route, your map file will still be copied into the C:\QUAKE\ID1\MAPS directory. Simply switch over to QUAKE, bring down the console (hit the ~ key) and type MAP (MAPNAME HERE). This will run your map without having to exit and rerun Quake all the time. It can really speed things up if you like to compile and test frequently.

The six compiling options provided by BSP are:

That's about all there is to compiling. When you are done with your level, you might want to do one final thing. There isn't a batch file for this, so you'll have to do it from the command line. Run QBSP with no options selected. Run LIGHT with the '-extra' option enabled. This will provide a much better quality of lighting and shading in your map, but will require much longer to run than a normal LIGHT. Also, you will probably want to run VIS -level 4 on your map. This will make your map as fast as it can be, but this will probably take a long time to run - anywhere from hours to days!

If you run into problems compiling your level, check out my troubleshooting tips here. They may help you solve the problem.

Once you have your map ready for distribution, zip up the *.BSP file along with a text file describing your level and you're ready to go. All the textures you used in your level are included in the BSP file. Happy Quaking!!

|| Back to Main Page ||

BSP is the sole creation of Yahn Bernier. I am only a dedicated user, reporting news and making tutorials so Yahn can spend more time enhancing BSP. QUAKE is a registered trademark of Id Software, Inc. QUAKE(r), the stylized reproduction of the QUAKE(r) trademark, including, without limitation, the Q in QUAKE(r), and the images depicted in QUAKE(r) are the copyrighted property of Id Software, Inc. So there :-P

This web page was created and is being maintained by me (DeadMeat). The main logo for this site was made by QuakeGod. Most everything else was made by me.

All content appearing on this site after August 30, 1997 was written by DeadMeat. Also, DeadMeat's BSP Tutorials were created entirely by DeadMeat. All unauthorized use is prohibited. (c) 1997