Frequently asked questions
==========================

Last updated 12/10/98 for v1.06b
--------------------------------

Q. I want to run Fragstats for my Quake 2 server. How do I do it?
A. If you are using CTF or RA, they have logging built in. Otherwise, download
   a mod which enables Frag logging; eg. GS log mod, ServerConfig Mod or Lithium
   (see fragstats.txt for where to get these).
   Set them to generate Frag logs (or Stdlog.log). Configure Fragstats for the appropriate
   log style, and you should be set.

   As of v1.06 you can record and display any special bonus scores recorded using the GS
   log standard. See the templates.txt and fragstats.cfg files.

Q. But I don't like GS log mod, ServerConfig Mod or Lithium because <insert reason here>.
A. There are other mods that generate logs. Check them out. If they generate GS or QW
   style logs, Fragstats can work.

Q. How do I find out what special bonuses are recorded by my mod?
A. Check the mod docs to see what they record. If they're not clear (or non-existant),
   run Fragstats against your logs and have a look at the console output it generates.
   Any special bonuses that are found in the logs will be shown there. I've even made
   the output formatted so you can cut and paste it straight into your config file.

Q. How do I use the user defined tags once I have them defined?
A. You use them just like any of the inbuilt system tags. Check out the default templates
   included in the package.

Q. Can you please explain how Frags/Deaths/Rank/Efficiency/Suicides/Skill/Duel is calculated?
A. Check out:
   http://quake.tip.net.au/statsexp.html
   for an explanation of these statistics.

Q. I've set up Fragstats and can get the HTML output, but can't get Qplayer to produce
   individual statistics. Can you help?
A. 1. Make sure your CGI directory is set up correctly.
   2. Make sure you've specified the correct path for cgidir and URL mapping for cgiurl.
   3. Make sure the players.db & victims.db files are in the CGI directory.

Q. The name search facility in the sample scores.html doesn't work. Why?
A. 1. Check the above steps first.
   2. Make sure you've modified the scores.html file, changing the action statement in
      the form to reflect the correct URL mapped location and name for Qplayer.
   3. If it still doesn't work, try changing the method statement in scores.html to GET
      rather than POST. The Apache web server is one web server I know of that doesn't
      support the POST method.

Q. I keep getting a 'Cannot open players.db' message from Qplayer. Why?
A. If you are using Website, there is a known problem where Qplayer's working directory
   doesn't default correctly to the CGI correctly. There is no fix that I know of. If
   you're using another web server, check the above Q&A.

Q. I get a message from Qplayer saying 'Wrong database version'. Why?
A. You either need to reinitialise your database or update your version of Qplayer.
   In the first case, delete the last.dat file and re-run Fragstats.

Q. Why do I get an 'Error parsing' message in the Fragstats output?
A. You have some records in your logs which have been truncated or malformed due to server
   crashes, they haven't been written out to disk yet or perhaps a bug in the Q2 mod you
   are using. This message is just a warning, ignore it.

Q. My HTML editor screws up the Fragstats tags, eg. <?server> becomes &lt?server&gt.
   What can I do?
A. Try using the alternate tag mechanism, eg. <!--server-->. This should not be messed
   up by your editor. One known exception to this is in the <TITLE>...</TITLE> field.
   You can always modify the HTML by hand (ouch).

Q. I'm running a recent version of Ret Hat Linux and the date displayed by Fragstats
   seems to be out by several hours. What can I do?

A. A few people have noted that Fragstats on recent RH linux versions doesn't seem to
   take into account the timezone when displaying the date. I don't know why this is.

   Workaround:
   1. Define a user defined tag in your config file that references a file to include
      in your HTML, eg.

      deftag realdate as file "/tmp/fragstats.date"

   2. Modify how you run Fragstats so a new date is written to the file
      /tmp/fragstats.date every time you run Fragstats, eg. In a script:

      date > /tmp/fragstats.date
      fragstats

      The modification above takes the output from the date command and redirects
      output into "/tmp/fragstats.date". Fragstats runs immediately after you've
      extracted the date into "/tmp/fragstats.date"

   3. Use the tag you defined above (ie. <!--realdate-->) in your HTML templates
      instead of the <!--date--> tag. You should then end up with the current date
      (as produced by the date command) inserted into your HTML.