First Timers

Firstly you need to install the complete version of bSpy from the downloads page (redundant?). Once you do this grab the latest exe (if there is one normally above the bspy.zip file) if not then the latest is contained in the setup file. The installation is fairly straightforward it's a generic Win32 (vb6) setup.

NOTE: if you have run the full install you SHOULD uninstall the previous version before installing a new one from a full install. I will try to make it auto upgradeable as much as possible to avoid repeated phat 4mb downloads.  

Experts

Ok so you have got it up and got weird msgbox prompts about no profile or something. Well it's simple really BEFORE you can play you need to tell bSpy which games you want and where the hell the game exes and config files are. It will not look for them.

Step 1 - Game Selection   Top

Choose the games you want to play by clicking on the tool bar button called Games yeah the one with the tick on it.

Good now you should see the following screen. If you dont then try again from Step 1

You're a genius, well not really but I appreciate your interest in continuing as does Besmella Quake :P

What you will see is a list of games bSpy currently supports (this will grow) if there is a tick that means you want to see that game on the list of games you can take the tick off or put it on by clicking your mouse pointer in the little box next to the game name.

NOTE: On initial install ALL games will be ticked :D

Once you have selected the games you want then click the APPLY button, this will save the information to the ini file in your bSpy directory (I think). From this point on only the selected games will be listed when you're browsing etc.

Step 2 - Profiles   Top

You have come this far why give up now? Well the next step is simple really you need to setup profiles. See the button with the cogs and the word profiles? Well click on it.

And you should see the following screen pop up

So this part is simple pick the game you want to setup a profile for by clicking the drop down list called Game. Then to the right is the profile list. It will contain your current profiles (if any) or you can simple enter one in. Any words/numbers can be used but if you make it meaningful it will help later. I normally have different profiles for different clients I use for Quakeworld. Such as Fuhquake-gl, MQWCL-SW etc

Game Nick :enter the nick name to assign as default when you enter a game (this can be overwritten by executing the config you specify though  so it's not a biggy. You can leave it blank and you will get a default name of Unnamed-Fag when you play a game using the profile with a blank nick.

Command line : Click on the browse button it will show you the Windows open file box find the EXE or BAT file you use to play the desired game. Click on the filename and it will put the full path and exe name in the field. You can add additional parameters to it as well such as -heapsize 60000 etc.

Default Config File: Use this to specify a file which can be exec'ed within the game when it starts. YOU MUST HAVE SOMETHING IN HERE THAT IS VALID.

Default Config Path: This will be auto filled once you specify the config file in the previous field.

None of the fields can be left blank.

When you want to save it click the apply button up top

Apply: Will save you profile

Delete : Will remove the profile

Reset : Will clear the screen without saving changes

You will then see the following screen

You can pick a specific game or leave it at ALL Games. In the grid is a list of Import sources which will be used (over time this will increase as I get access to more sources).

There are currently 2 types supported Besmella Spy Sources from Besmella-Quake or Server Query Sources from various ISP's which support Server Query Lists. The DLDType is 0 for Besmella Spy Lists and 2 is for Server Query Lists. Type 1 is for future Gamepsy format Lists with the expectation of further types to update from various master servers.

To import all Lists click in the grid on the first row and holding down the shift key down arrow till you get to the end. Or you can simple highlight individual lists using the standard selection method in windows combinations of CTL/+SHIFT and down arrow or mouse click.

If you change the Game then the import process will only import the servers for that game.

Once you have selected the sources click the import button. This will add and update any servers in the Standard bSpy server lists not your favourites.

It will give you a message saying how many servers got updated or added.

Once you have then the following screen will pop up.

On the left is a list of currently defined favourites. On the right is where you edit or define new ones.

The nifty thing is you can use the same import sources to build your favourites list.

To setup a basic favourite which you will use to add servers from the Standard Lists Just put the name of your favourite in the Favourite Name field. Leave the Import List check box unticked and then click apply. This will add the favourite you specified to the left list. To Edit or Delete click the list on the LEFT this will put the info on the right and then you can DELETE it. If you edit it will create a New one so you really can't rename it just delete the one you don't want and setup a new one.

To setup a Import Favourite then do the same as above but this time click the Import List from the net. Only one list is allowed at this stage and it HAS TO BE a web based list like a web address

EG http://games.netspace.net.au/sq/full.txt

You then need to tell it what type of list it is. Currently Bspy Format or ServerQuery Format. Then Save your favourite by clicking Apply. You can import the list through this screen any time which will update your favourites. To do this click on the favourite on the left it will load the info on your right and then click the import button.

When you're done click Exit.

This will then pop up the following screen

It will pre-fill the port information from the Game Type you select. Again you must tell it what type of game it is. Then you just type in the IP Address of the server you want to add eg 123.124.125.126 It must be a valid ip format and all fields must be filled in. The scan process will determine if the server is wrong and will report 999 ping.

To delete a server from the grid

Then click on the Add Fav button at the top

You will then see the following screen

The top part of the screen has a list of your CURRENT favourites (you can't setup new ones here) clicking on the favourite will show you a list of servers in the grid beneath it. with the Server you want to add in the first row.

Click Apply and save it.

Click Delete to delete ALL servers in the selected Favourite.

Select the Game you want to play by clicking on the Game List OR select the Favourite List you want by clicking on the Favourites list at the top

If you select the Current Game then the Current Favourite will show NONE

If you select the Favourite then the Profile to use will default to the Profile being shown corresponding to the Current Game. So if you want to play using Favourites list then Select the game you want FIRST then the Profile you Want THEN the Favourite List you want.

As you can have multi-games in the Favourites List if you select play a game that is not the currently selected game it wont do it and tell you to pick the desired Profile after it sets the Current game the to game type you selected to play by highlighting the grid.

Now you have the list and your profile you want to use selected then simply click on the server you want to play on this will re-ping it and update the players etc.

Then click the Play/Spex0r button. You will then be launched into the game and you're playing.