|
|
PsychoQuery Readme File.
-------------------------
Online documentation can be found out:
http://www.psychostats.com/pqdocs/
There is no installation required for PsychoQuery other then just
uncompressing the archive somewhere. There is a directory called
'themes' in this archive. It contains all the themes for PQ. You can
edit any of them or create your own.
Programmers who want to make their own server query utilities will find
the included pq.pm useful. It contains the core routines to allow anyone
to query Halflife servers for information. Quake3 support is implemented
but is still buggy, not well tested and not all games supporting the Q3
engine will work.
REQUIREMENTS:
--------------
PsychoQuery requires Perl (linux) or ActivePerl (windows). Windows users
can download Perl here:
http://aspn.activestate.com/ASPN/Downloads/ActivePerl/
EXAMPLE SETUP:
---------------
(In any example below the command "pquery.pl" might not work for Windows
users, if this happens to you simply run the command like this:
"perl pquery.pl " ... And then the rest of the command shown in the
examples.
As an example of how pquery works, I setup a cronjob to have it query my
server every minute (yes, thats every minute). It only takes a second
or 2 to receive a query. And pquery updates an html file within my HTML
root folder. Then on my stats page, I use an SSI tag to have the pquery
generated page (rtstats.html) included into my main stats page. The SSI
code is as follows:
<!--#include virtual="rtstats.html"-->
"pquery.pl -h" will display the command line syntax.
IMAGES:
--------
The PsychoQuery archive will no longer provide any images within the archive.
You can download images from the PsychoStats.com website in the 'contribs'
section. All themes created for PQ will have its <img> html tags hard coded
for a specific directory and will most likely not work for all systems. So you
might have to manually edit the path in some of the themes in order for the
images to work correctly.
CUSTOM THEMES:
---------------
This archive comes with a kickass default theme. If you want to make your
own all that is required is some HTML knowledge and what variables pquery
looks for in the html theme file. Look through the included file:
theme_notes.txt. It contains all the variables that you can use in the
PQ theme.
FINAL NOTES:
-------------
There is a test.txt file included in this archive which you can use to
test the output of pquery.pl at a command prompt. Simply run pquery.pl
like this:
pquery.pl -srcfile test.txt -server 1.2.3.4:27015 -gametype=halflife
Make sure the 'server' is set correctly for your server. And you'll see
all the basic info about your server including players and rules. The
test.txt file is not meant to be pretty. Its only meant to show you some
simple text output from pquery.
CONTACTING ME:
---------------
At this time, please do not email me asking how to set this up if you do
not understand what SSI tags are, or how to use CGI on your webserver. I
do not have the time to help people do this. However, the forums on the
psychostats.com website are available for users to post problems and
questions.
Go to the online forums at the http://www.psychostats.com/ website for
more help. This would be the best method to get help for any reason.
--
Jason Morriss
stormtrooper@psychostats.com
http://www.psychostats.com/ |
|
IP卡
狗仔卡
发表于 2002-11-15 23:53:26
提升卡
置顶卡
沉默卡
喧嚣卡
变色卡
显身卡
发表于 2002-11-17 00:27:23