/---------------------------------------------------------------------------------------\
| Tribes Vengeance Server Query |
| v1.4, 10.10.2004 |
| Littlex (t3de team member) * littlex@tribes-3.de * http://www.tribes-3.de |
+---------------------------------------------------------------------------------------+
| |
| 1. #[ LICENSE ]# |
| Tribes Vengeance Server Query is free software; you can redistribute it |
| and/or modify it under the terms of the GNU General Public License as |
| published by the Free Software Foundation; either version 2 of the License, |
| or (at your option) any later version. |
| |
| This program is free software; you can redistribute it and/or modify |
| it under the terms of the GNU General Public License as published by |
| the Free Software Foundation; either version 2 of the License, or |
| (at your option) any later version. |
| |
| You should have received a copy of the GNU General Public License |
| along with this program; if not, write to the Free Software |
| Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, |
| USA. |
| |
| Tribes Vengeance Server Query class, Copyright (C) 2004 Littlex & tribes-3.de |
| Tribes Vengeance Server Query class comes with ABSOLUTELY NO WARRANTY; This |
| is free software, and you are welcome to redistribute it under certain conditions. |
| |
| For more details read GNU_LICENSE.txt |
| |
+---------------------------------------------------------------------------------------+
| |
| 2. #[ What is this? ]# |
| Tribes Vengeance Server Query is a PHP class which is able to read the live |
| status from a Tribes Vengeance (c) (Sierra) Server via PHP sockets without |
| the need of any additional script or tool like qstat. |
| |
| To see a full implemented and working example of this script check |
| http://www.tribes-3.de/query/ |
| |
| The Script will return you a PHP array with all information which are available |
| and some more things.See the example.php for a small how to :o |
| |
+---------------------------------------------------------------------------------------+
| |
| 3. #[ Features ]# |
| Retrieves all basic Server information like, Server- and Mapname, gametype, |
| version, is the server passworded, adminname, adminmail, number of currentplayers, |
| number of maxplayers, teamnames, teamscores, playerinformation per teamside and the |
| script calculates the average ping and score for the whole server and per team. To |
| see the full list run and check the example.php which will output the whole array. |
| |
| You can change the errormessages, the timeoutlimit, add new "Serverversion to |
| readable text" entries and you are able to change the whole structure of the output |
| array to your needs. For more information check the class. |
| |
+---------------------------------------------------------------------------------------+
| |
| 4. #[ Version History ]# |
| v1.1 |
| Fixed two bugs: |
| 1. The Script bugged arround when there was only one player on a server. |
| 2. If there is a non-alphanumeric char, T:V is returning an utf8 encoded |
| string. Now i am decoding utf8 signs so there shouldnt be a problem now |
| with weird signs :) |
| -thanks to Cowboy for reporting those bugs |
| |
| v1.2 |
| Fixed one bug: |
| 1. .'s < "DOTS :)" where ignored in strings because of a programming error :| |
| -thanks to Toaster for reporting that bug |
| |
| v1.3 |
| The Script was made compatible with the T:V demo. |
| Two new information available. (is dedicated server and gamemode [Public, |
| Competition i guess]) |
| Changed the output array a bit. |
| |
| v1.4 |
| Retail 1.0 and 1.01 are supported. |
| Changed the Arraysplit code. |
| Fixed one bug with unknown parameters. |
| Two new information available. (variant and minimum version) |
| |
+---------------------------------------------------------------------------------------+
| |
| 5. #[ Requirements ]# |
| PHP > 4.2 |
| Sockets Support - enabled (check phpinfo();) |
| Open Ports :) |
| And some PHP skills |
| |
+---------------------------------------------------------------------------------------+
| |
| 6. #[ Contact ]# |
| E-Mail: littlex@tribes-3.de |
| IRC (from 20.00 CET): Server - Quakenet, Channel - #tribes.de |
| |
| And the http://www.tribes-3.de forum |
| |
+---------------------------------------------------------------------------------------+
| |
| 7 #[ Authors note ]# |
| It started all with an idea :) After some weeks of research, hard work, a week of |
| vacation and alot of caffeine this script was rewritten two times and reached a |
| point where i decided its ready to be releasd. The first version was given to |
| http://www.tribes-3.de for testing and after some bug fixing it was ready to be |
| handed out to the public :) And that is what happend at the 05.09.2004. |
| |
| I hope you like it, its made with blood and sweat just for the tribes community! |
| The whole work was done by myself. |
| |
| |
| This was scripted in the name of t3de - http://www.tribes-3.de (the only german |
| tribes community webside) So if you use this script please provide a link to us |
| "http://www.tribes-3.de". |
| |
| |
| 6.1 #[ Qstat and other UT query scripts ]# |
| |
| I found out that the usage of Qstat and any other UnrealTournament query scripts |
| is false but works (god knows how long). The communication protocol changed in T:V |
| and i guess vivendi left some code bits behind from the UT engine. |
| |
| Basicly you have to send a "code" to the gameserver to get a response with all the |
| information. In UT 03 this hexcode goes like this: "\0x79\0x00\0x00\0x00". So some |
| smart guys out there thought "hey its based on the ut engine lets try it", and |
| sadly it works. |
| |
| 6.2 #[ Why is the UT 03 code working then if its wrong? ]# |
| The reason is, you just need to send a backslash ("\") to a T:V gameserver to get |
| a response (thats the codefragment i guess vivendi left behind). The Server will |
| allways send you the serverinformation BUT it will answer in the UT way, if you |
| query him with a backslash, which is a bit different to the T:V way (the |
| information structure changed). And because hex code signes are splitted with |
| backslashes this code works, T:V ignors every other sign in the query code. You |
| could even send "\OMG T:V is so teh 1337 and it will give me all i need" and would |
| still get a response. |
| |
| 6.3 #[ Who cares its not hurting anyone!? ]# |
| True, but you could eat your butterbread up side down but is that the right way? :) |
| And why doing it the wrong way, if there is a right way. AND who knows how long |
| that will work? Anyway you dont get all information which are available that way. |
| |
| 6.4 #[ Why i am so sure the usage is wrong? ]# |
| Because i sniffed the T:V client-communication protocol and the hexcombination |
| "\0x79\0x00\0x00\0x00" is total bs. It does not appear anywhere in the Packets. If |
| you are interested how to do it the right way and to find out how to avoid the |
| backslash problem with the real T:V hexcode, check the PHP class. I am to lazy to |
| explain that here :) |
| |
+---------------------------------------------------------------------------------------+
| |
| Btw. dont forget to check http://www.tribes-3.de from time to time to see if there |
| is a new version available. |
\---------------------------------------------------------------------------------------/
Contained files: tvsq/GNU_LICENSE.txt, tvsq/images/arid.jpg, tvsq/images/cavern.jpg, tvsq/images/dangerouscrossingbeta2.0.jpg, tvsq/images/detritus.jpg, tvsq/images/emerald.jpg, tvsq/images/fort.jpg, tvsq/images/garudagorge.jpg, tvsq/images/highlands.jpg, tvsq/images/isle.jpg, tvsq/images/junk.jpg, tvsq/images/lock.gif, tvsq/images/missing.jpg, tvsq/images/royalty.jpg, tvsq/images/spiridian.jpg, tvsq/images/surfacetension.jpg, tvsq/images/tropics.jpg, tvsq/images/utopia.jpg, tvsq/images/winterlake.jpg, tvsq/index.php, tvsq/readme.txt, tvsq/stylesheet.css, tvsq/tvserverquery.class.php, tvsq/tvsq_readme.txt
Noch keine Kommentare vorhanden.