
                        ENTITY INFO PROGRAMS
                              v. 1.1

These programs are to help analyse entity info from Quake-engine
game maps (Q1, Q2, H2), which appears as an `entity lump' (the first
lump) in the .bsp's in the following format:

{
"MIDI" "casa1"
"wad" "gfx/castle.wad"
"classname" "worldspawn"
"CD" "2"
"message" "105"
}
{
"classname" "light"
"origin" "-2032 1728 184"
"angle" "399"
}
{
"light" "500"
"origin" "-1902 1436 448"
"classname" "light"
}
...

This info can be extracted automatically with my `unent' utility,
based almost entirely on Raphael Quinet's QEU.

ENTLIST
Lists all of the entities in all of the entity files, alphabetically,
and for each entity its keys, first the ones that always occur, then
the ones that don't always occur, in parentheses.  Note that `always
occurs' doesn't really mean obligatory, since what's in the map
doesn't necessarily correspond exactly to what the code requires;
and furthermore, sometimes the .hc code supports keys that never wind
up actually getting used.

Also note that the spawnflag field codes difficulty & play-type flags.

The command-line format is:

  entlist [-f filename] [classname]

If no parameters are present, it collects all the entities from all
the *.ent files, and complains & reminds you of the format if it
can't find any entity files at all.

The useful output can be redirected to a file named [file]
with '> [file], while progress-indicators, etc. go to standard
error & just appear on the screen.

ENTFIND
This one lists the instances of entities which have the specified
keys, and which entity-list files they're found in.  The
command line is:

  entfind [-f filespec] classname [key1] ... [keyn]

Spawnflags are now cracked.

As with ENTLIST, no filespec is equivalent to *.ent.

SECURITY, PERMISSIONS, etc.
The full source-code is provided (pardon my dubious attempts at
writing C++ classes), compiles under TC3.  The directory searching
routines are all that I'd expect to be Borland/DOS-specific.  .prj
files for both programs are also provided.  You can do anything you
like with the source except try to patent or copyright it, tho if you
make megabucks off it, please consider giving some of the lettuce to
me...  More realistically, if you make any enhancements, please let
me know or at least do something to make them generally available.  

I've checked the .exe's for viruses with McAffee Jan 98; feel
encouraged to take whatever further precautions you deem prudent.


  tiglari@hexenworld.com


