This file is a guide to the common warnings and errors that you may find in
TreeQBSP.  For now it will be a little bit rough (I've skipped some of the
more obscure warnings and errors), but I hope to flesh it out some more for
future versions.  These are generally worded a little differently from the
standard QBSP in order to make them more intelligible or provide more info.
Another good source of info on editing errors is the following hard-to-find
(for me at least) web site:

http://www.planetquake.com/quakelab/bsp.htm


*** Warnings

Warnings are things which QBSP runs across which look suspicious but in
general won't stop it from creating a valid .BSP that will run in Quake.
Some of the warnings may cause QBSP to ignore a faulty brush in your map

 0: No wad or _wad key exists in the worldmodel
    Add a "wad" "c:\some\path\name.wad" key to your world entity.  Most
    editors should already guarantee this.

 1: No valid WAD filenames in worldmodel
    QBSP could not open any of the .WAD files listed in your .MAP.  Add
    the name of at least one .WAD that exists on your computer.

 2: Multiple info_player_start entities
    Quake will only use one info_player_start entity, so multiple entities
    are useless.

 3: line X: Brush with duplicate plane
    You can edit your .MAP file with a text editor and remove the specified
    line to get rid of this error.

 4: line X: Brush plane with no normal
    The brush plane is invalid and will be ignored.

 5: No info_player_start entity in level
 6: No info_player_deathmatch entities in level
    These are warnings that the specified (optional) entities do not exist.

 8: Point (X Y Z) off plane by D
    This is the infamous "point off plane" error, reduced to a warning.
    The coordinates are provided so that you can investigate that area of
    your map if you so desire.

10: Reached occupant at (X Y Z), no filling performed.
    QBSP does not think that your level is sealed properly.  Make sure that
    no entities exist on the "outside" of your level.  Use the .pts file
    that QBSP creates to help find the leak.  You may see this warning up
    to 3 times for a given level (once per hull).

16: Texture X not found
    The given texture, referenced somewhere in your .MAP was not found in
    any of the given .WAD files, and will be replaces with a default
    checkerboard pattern.

19: No entities in empty space -- no filling performed (hull X)
    You must have at least one entity that is more than 32 units away from
    any wall (in "empty space") before QBSP will attempt to check your
    level for leaks.


*** Errors

Errors are "fatal" problems which QBSP encounters, which cannot be ignored
and will terminate the program.  These must be fixed before QBSP will
generate a .BSP file for you.  I will only include the most common errors
here, look for a more complete list in the next release.

Any errors that begin with the words "Internal error" signify a flaw in
QBSP, rather than any problems with your .MAP file.  (Generally it means
that QBSP has underestimated the amount of the dynamic memory necessary to
hold a given type of data for your .MAP.)  I would like to hear from you
if you run across any errors of this nature.

53: Out of memory
    Buy more RAM.

60: Clipnodes in map exceed 32767
    This is a hardcoded limit in the Quake file format.  Try to reduce
    the complexity of your map in order to lower the number of clipnodes
    generated.