


                     Tiglari's Entity Tools

                            Oct 1998

These are some little C programs I use to collect entity information.

  - unent:  extracts entity lumps from pak's and bsp's into a series of
            files with extension *.ent, one for each .bsp.  Code derived
            by minor fiddling with the QEU suite by Raphael Quinet.

            Works with Quake, Quake2, Hexen 2 and the Heretic 2 demo,
            but not the Sin demo (it really doesn't, it's not just
            barfing at an exotic bsp version #).

  - entlist: reads the results of unent, and produces a summary of what
             entities appear with what keys, recording their frequences
             (optional keys in parentheses, followed by frequency numbers)

  - entfind: lists out all occurrences of specified entity in unent output,
             indexed by map and cracking spawnflags.

  - entval:  like entlist, but writes out all values of specified fields,
             cracking spawnflags (good for finding out all the thingtype
             values, for example).

The source code for unent in the subdirectory unent, that for the others
in the subdirectory entdoc, TC3 .prj files include, not that they're
really need.

These programs supersde versons I've distributed indivdually and in
the `entprg' collection.  Not included here are some PERL scripts I've
used for making Quark5 add-on files.

Permissions:

For use of the unent code, you are bound by Raphael's conditions, as
stated at the beginning of the files.  You can do anything you like
with the others (the ones in the entdoc folder), except that if you
manage to make millions off them, it would be cool if you gave some of
it to me.

But if you do enhance unent to deal with additional games, it would be
especially cool if you would let me know.


 - tiglari@hexenworld.com
