Readme
Search a player
To open the search dialog simply right-click anywhere in the server list.
Now you have the possibility to search for the player only in a certain game, or in all games.
Also you decide if you search for a player whose name starts with or contains the specified string (note that the search is case insensitive).
To start the search, hit enter.
Add a server
Adding a server is easy. You only have to gather need the servers IP and PORT to put them in the corresponding fields.
In most games you can get those information through the server list.
Or check this: http://www.gametracker.com
If you don't know how to use your systems script and just want to start the game you may ignore the 'big' textarea.
There is a drop down menu at the bottom of the window, it is used to select a game.
If you add a server for a game you don't have added, you have to go to the options, and add it.
If you leave the field "Display Name" empty and change the game, the content of the script area and the port will change to the games default setting defined in the options.
Add a game
To add a game you have to navigate to "Options" => "Games".
This window contains a table listing all loaded games, their executable, protocol and protocol status.
To add a new game you now have to click the add button.
A dialog window will open. Fill in the fields with the information you have.
If you don't know what to type in the query port or game port you may want to check these sites and see if your game is listed:
(Don't be worried that these sites are german. You just have to take a look at the list)
Some games use relative query ports (Unreal tournament 2004).
In this case you can just add/substract a number to the game port.
So for example you can type in +10 (game port+10) or -215 and so on.
If you leave the query port empty it will use the game port (this is the way to go for most of the games).
If you don't know how to use your systems scripts, you only have to edit the games script if it has different start parameters.
If you want to do something (Starting musicplayer, gaming tools, etc..), but still don't have any idea how to use them, you should just browse the internet for "batch basics" (as windows user).
The scriptarea
The game is started by a batch/bash script.
So you can basically do anything you can do in a normal .bat or .sh file.
Also there are a few variables depending on the Server.
Before the script gets executed they are replaced by their value.
%IP% -> Whatever you have entered in the IP field
%PORT% -> Same...
%GAMEPATH% -> Path to the game executable
%EXECUTABLE% -> Name of the game executable
%PASSWORD% -> The password you have entered when trying to join a password-protected Server
If you have no idea of batch/shell scripts but want to use them, just google!
Windows users have to search how to write batch scripts, Linux users have to find out how to write shell scripts.
What are protocols and why do I need them?
A protocol is simply a guideline/structure for the client-server communication./p>
You could imagine it as a language that the server and the client talk together.
If they talk different languages, they won't understand each other.
The client will ask the server for information, but it won't understand anything.
So it will either, just not respond, or it will answer with something the client won't understand.
This is why you have to install a protocol so the software can correctly ask for informations
and knows what to do with the reply.
Supported Games
This table shows only games that I have tested.
In theory all games that use one of these protocols are supported, but some games modify them, which breaks compatibility.
So if you want to try a game that is not listed in the table but uses one of the protocols, just try it out and you'll see if it works.
| Protocol | Games | Note |
|---|---|---|
| Doom 3 |
Doom 3, Enemy Territory: Quake Wars, Quake 4 |
Can't get a player list for |
| GameSpy |
Battlefield 1942, Unreal Tournament |
|
| GameSpy II |
Battlefield: Vietnam, Halo |
|
| Half Life |
Half Life, CounterStrike, CounterStrike:Condition Zero |
Can't get a player list for |
| Quake3 |
Call of Duty, Call of Duty 2, Call of Duty: United Offensive, ioQuake3, Jedi Academy: Jedi Knight III, Jedi Outcast: Jedi Knight II, Quake 3, Urban Terror, Warsow, Wolfenstein - Enemy Territory, World of Padman |
|
| Source (A2S) |
Counter Strike: Source, Half life 2 |
I can't test all games because I don't find servers for any game.
The list below contains games that I don't have tested, but use one of the supported protocols.
If you tested one of these games, please contact me with your gathered information.
Axis & Allies RTS, Age of Empires, America's Army: Operations, Battlefield Vietnam, Close Combat III: The Russian Front, Chaser, Chaser Demo, Colin McRae Rally 4, Contract Jack, Deer Hunter 2004, Deer Hunter 2005, Disciples 2: Dark Prophecy, Dead Man's Hand, Empire Earth II, FEAR: First Encounter Assault Recon, FEAR: First Encounter Assault Recon MP Demo, F.E.A.R. Perseus Mandate, Gotcha!, Ground Control 2: Operation Exodus, Halo Custom Edition , Halo, Hidden & Dangerous 2, Heroes of Might and Magic III, Jack Nicklaus 6: Golden Bear Challenge, Men of Valor, Medal of Honor: Pacific Assault, Moto GP 2, NetAthlon 2 for Bikes, NASCAR Thunder 2004, Neverwinter Nights, Original War, Painkiller, Race Driver 2, Real War: Rogue States, Rise of Nations: Thrones and Patriots, Soldiers: Heroes of WWII, SuperPower 2, SWAT 4, Star Wars Battlefront II, Star Wars Battlefront, Star Wars Republic Commando, Tribes: Vengeance, Tribes Vengeance Demo, TRON 2.0, Wings of War Demo
Editing a Game, Server or Settings file
These files are Java Properties files.
To use one of these signs as a value : # ! \ you have to put a \ in front of them.
For example \\ will be \
\# will be #
Get more information at the Wikipedia article.
Java
You need a working Java Runtime Environment installation of at least version 7u25 (1.7.0_25)
If you don't have it installed, get it here http://www.java.com/de/download/
Find out your version
You have to open the systems commandline and execute this command:
java -version
What I can change the UI colors?
Tell me more about it!
To change the colors of the user interface you have to open the /Colorsets/ui.txt file.
It is a Colorset file.
With some notable differences.
Only special keywords have an effect, they all MUST be set and you may ONLY use hex-colors!
There are different keys you can use to change the colors.
| background | #27DEE8 |
| playerlist | #FFFFFF |
| serverlist | #FFFFFF |
| unreachable | #BABABA |
| unreachableselected | #999999 |
| reachable | #75FF9A |
| reachableselected | #36FF6B |
| category | #08B5FF |
