Program name: SBRelay Version: 1.2 Author: Russell Gilbert (fshost@chocolatesoftware.com) Simulator version: Microsoft Flight Simulator 2004 SquawkBox version: 2.3b5 Platform: Windows 95 and up License: Freeware / ChocolateWare (see below) ------------ DESCRIPTION: ------------ SBRelay is a program to enable FS2004 with SquawkBox 2 (SB) and the various networks it supports (VATSIM, IVAO, etc.). It does this by creating an FS2002 session and an FS2004 session internally, and then translating and forwarding all SB players from the FS2002 session to the FS2004 session. By connecting both SB and FS2004 to SBRelay, you can fly in FS2004 and be connected to the network, just as you did with FS2002. SBRelay is a multi-threaded C++ Windows application built for high performance, and uses very little CPU or system resources. ------------------------- INSTALLATION AND STARTUP: ------------------------- - Extract the zip file (SBRelay12.zip) to any directory. (For example: "C:\Program Files\SBRelay" would be fine) - Go to the directory you extracted the files to, and run the program (SBRelay12.exe). - After a few seconds, the servers will start automatically and print messages in the log window. You can then connect SquawkBox 2 and FS2004 to SBRelay. It doesn't matter which one you connect first. DETAILED INSTRUCTIONS: - Install SB. - Install the CSL aircraft for FS2004. Please see the note below about installing SB and the CSL aircraft. - Install FSUIPC for FS2004. Please see the note below about FSUIPC. - Start SBRelay. - Start FS2004. - In FS2004, click "Multiplayer" on the startup screen, then click "Open Multiplayer Session", enter your "Player name", leave the "IP address" field blank, and click "Search". After a few seconds it should show the session "SBRelay - FS2004" in the "Sessions" box. If you don't see the session, try entering the IP address "127.0.0.1", which is a special IP address that always points to your own machine. When you see the session, click "Join" to connect. After connecting, you should see your player name listed in SBRelay. You can then click "Create A Flight" on the FS2004 startup screen to setup your flight. - Start the SB Host program, "SB Host.exe". Please see the note below if you're using the "HostSB.dll" module inside FS2004 instead of the separate "SB Host.exe" program that originally came with SB. - Start the SB main program, "squawkbox.exe". The player name should be set to "Squawkbox", and "Internet TCP/IP connection" should be selected in the list. Click OK. Then click "Start Search". Leave the IP address field blank and just click OK. After a second or two, you should see the session name "SBRelay - SquawkBox2 (1/814)". (If it just says, "Looking for games" and never finds the session, click Cancel and you'll have to start again. Click "Click here to get into the action", then close the entire SB Host program by clicking the X in the upper right corner. Start again from the previous step, and try the IP address "127.0.0.1" instead.) After connecting, wait a few seconds, and then you should see the SquawkBox player name listed in SBRelay. - You can then use SB to connect to the network as usual. When new planes are added to the session, you should see them listed in SBRelay, as well as visually inside FS2004. Chat messages are forwarded from FS2004 to the network servers as usual. It is no longer necessary to run the FSChatScroll program, since FS2004 doesn't have the scrolling bug that FS2002 did. ---------------- TROUBLESHOOTING: ---------------- Please see the Help page on the SBRelay web site for all the latest info about connection problems. New information is continually being added: http://www.chocolatesoftware.com/sbrelay -------------------- PRICE AND LICENSING: -------------------- - Free! - SBRelay is ChocolateWare! ---------------------- WHAT IS CHOCOLATEWARE? ---------------------- ChocolateWare is a combination of Freeware and DonationWare, but with a twist... All donations of $1 or more are converted directly to chocolate and given to my wife. It's my mission to hear her say, "I love Flight Simulator!" some time before I die. This is also good for you, because if my wife is happy, it means I have more time to work on programs like this. I'll make every effort to convert your donations to chocolate and give them to my wife within 48 hours of receiving your donation. I'll also send an email confirmation back to you, to let you know how it was received (and eaten). You can even request a particular type of chocolate if you like. This can be candy, cakes, pies, ice cream, or just about anything else you can think to put chocolate in (or on, or with). To make a chocolate donation, please donate to my PayPal account. This is very easy. Just go to the SBRelay web site below and click the "PayPal-Donate" link. If you already have a PayPal account of your own, just enter the amount you want to donate (all donations of $1 or more are graciously accepted -- you decide the amount) as well as your password, and click Continue. If you don't have a PayPal account, you can easily enter your credit card info (the site is extremely safe and uses SSL encryption) and the password you want to create, and a temporary account will be created at the same time. Depending on where you live, you may be charged an additional $1.95 membership fee, but PayPal will give that back to you when you verify your account and send your next payment to someone. PayPal is a great service and very easy to use :-) SBRelay web site: http://www.chocolatesoftware.com/sbrelay/ ---------- COPYRIGHT: ---------- © Copyright 2003 Russell Gilbert All rights reserved. THIS WORK MAY NOT BE SOLD FOR PROFIT, NOR MAY IT BE INCORPORATED INTO A COMMERCIAL WORK without prior written permission from the author. Any modification of this work, or the preparation of derivative works based upon this work, for commercial use or private, is strictly forbidden without prior written permission from the author. This copyright statement pertains to the SBRelay program executable and all files included with the executable in the download package. Information is subject to change without notice. This work is distributed WITHOUT ANY WARRANTY and without any implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. ------------- CONTACT INFO: ------------- PLEASE NOTE: I am not an expert at VATSIM, IVAO, CSL, FSUIPC, or even SquawkBox. If you need help with any of those networks or programs, please contact the authors directly. I can only help you with problems directly related to SBRelay itself. If your question is about SBRelay, send an email to fshost@chocolatesoftware.com and I'll try to get back to you as soon as I can. Also, please take a look at the web site before sending an email, because your question may have already been answered there: http://www.chocolatesoftware.com/sbrelay/ Thanks -- enjoy the program! :-) Russell ("OzzieYank") -------------------- A NOTE ABOUT FSUIPC: -------------------- You can download FSUIPC version 3 for FS2004 from www.schiratti.com/dowson.html Put the FSUIPC.dll file in the "...\Modules" folder under FS2004. If you haven't registered FSUIPC version 3, you can use the free code below that allows it to work with SquawkBox 2.3. Start FS2004, create a flight, click the Modules menu, select FSUIPC, click the "Register an application program" button (NOT the "Register FSUIPC" button), and enter the following info (it's best to copy and paste): Program name: Squawkbox Key: LWVQ 7I2V 9GPB (note that the character after the 7 is the letter I, not the number 1) ------------------------------------------------------- A NOTE ABOUT USING HostSB.dll INSTEAD OF "SB Host.exe": ------------------------------------------------------- The original "host window" program that came with SB was "SB Host.exe", and you'll find it in your SB directory. If you're using this program it should be started first, and it will create an empty window. Then start "squawkbox.exe", and it will prompt you to connect to the session in SBRelay. Some time after the initial release of SB, another file called "HostSB.dll" was released. This file goes in your "...\Modules" folder under FS2004. If you then start FS2004, create a flight, and click the "Modules" menu, you'll find a sub-menu called "HostSB". Select "Run" under that menu, and it will create the empty host window. Then start "squawkbox.exe", and it will prompt you to connect to the session in SBRelay. If you're using "HostSB.dll", you'll want to add a line to your fs9.cfg file to prevent a warning about old modules when FS2004 starts up. Edit the fs9.cfg file (see below for the location of this file on your hard drive) and search for [OldModules]. Then add a line just below it, so it looks like this: [OldModules] HostSB.dll=1 -------------------------------------------- FINDING THE FS9.CFG FILE ON YOUR HARD DRIVE: -------------------------------------------- For Windows XP users the fs9.cfg file is located in: C:\Documents and Settings\\Application Data\Microsoft\FS9 This is a hidden folder by default so you need to modify the Folder Options. Go to Start / Settings / Control Panel / Folder Options, change to the View tab, and select "Show hidden files and folders". For Windows 95/98/ME users the fs9.cfg file is located in: C:\Windows\ApplicationData\Microsoft\FS9 ------------------------------------------------ A NOTE ABOUT INSTALLING SB AND THE CSL AIRCRAFT: ------------------------------------------------ - If you already have SB installed for FS2002: You need to copy all of the CSL aircraft files from FS2002 to FS2004. Copy the entire "...\FS2002\Aircraft\csl" directory tree to your "...\Aircraft" directory under FS2004. (The default location of FS2004 is "C:\Program Files\Microsoft Games\Flight Simulator 9", but you may have installed it somewhere else) Then make sure that the file in the "...\Aircraft\csl" directory is named "aircraft.cfg" and not "aircraft.csl". If it's named "aircraft.csl", all of the planes will look like whatever you're flying. - If you don't have SB or FS2002 installed on your machine: If you only have FS2004 on your machine and need to install SB, it will prompt you for the location of the FS2000 or FS2002 directory. When it prompts you, point it to the FS2004 directory ("C:\Program Files\Microsoft Games\Flight Simulator 9", or wherever you installed it). It'll also ask you if you're installing it for FS2000 or FS2002, and you should select FS2002. It will copy a lot of files to the "...\Aircraft\csl" directory under FS2004, and everything should be setup. - A note about warnings in FS2004: Each time FS2004 sees a new aircraft from the Common Shapes Library (CSL), it will show a warning saying the aircraft is not fully compatible, and will ask if you want to disable the unsupported features on the aircraft. From what I can tell, the best thing to do here is to click "No". FS2004 will then add a line to the fs9.cfg file so that it won't give you the same warning for that particular aircraft again. If you'd like to add all of the lines to the fs9.cfg file in advance (and prevent the warnings), just copy the lines below and paste them in the [FrameCallNoWarn] section. See the section above for how to find the fs9.cfg file on your hard drive. If you've never been warned about an aircraft before, you probably won't be able to find a [FrameCallNoWarn] section in the fs9.cfg file. Be sure to search for it to make sure, but if you can't find it, just go to the bottom of the file and add it, along with all the other lines for the individual aircraft. Here are the lines to add (only add the first line if it's not already in the file somewhere): [FrameCallNoWarn] ~van=1 A320=1 A340=1 AT72=1 B1=1 B206=1 B52=1 B707=1 B727=1 B737=1 B744=1 B767=1 BA46=1 BE10=1 BE18=1 BE35=1 BE55=1 C130=1 C152=1 C172=1 C182=1 C188=1 C5=1 CAR=1 CONC=1 CSL=1 D8100run=1 DC10=1 DC3=1 DC4=1 DC9=1 DH8B=1 DHC2=1 DHC6=1 F14=1 F4=1 F5=1 ffg7=1 FORD_POS=1 G21=1 J3=1 LJ45=1 M113=1 Master CSL=1 OHP=1 P28A=1 P28R=1 P32R=1 P51=1 Pa28r180=1 SAIL=1 SF34=1 SH33=1 ST75=1 STS=1 T37=1 TOBA=1 TUG=1 Tug1=1 TWR=1 U2=1 UH1=1 UH1D=1 UH60=1 ULT=1 VAN=1 XSR=1