TribesIP 3.5a - by Cowboy - http://www.planetstarsiege.com/cowboy/


-- The "Sales Pitch" --


Ok... You asked for it, and you got it... TribesIP has server query!

Where TribesIP 3.0 had been completely rewritten, cool new features added, code streamlined, and a dialog-based interface implemented, TribesIP 3.5 now features individual server query, a GameServerList.cs search feature, and an improved favorites management.

And before you ask me all those questions you have, READ THIS README! Because I have answered ALL of your questions in here. And I can tell when you haven't read this... More likely than not, I'll just tell you to read this anyways, as I'm a pretty busy guy!


-- Installation --


Make sure you have mIRC 5.7 or 5.71 installed. TribesIP 3.5 has been thoroughly tested with both these versions, and will NOT work correctly with an older version of mIRC. Compatibility is NOT guaranteed with newer versions, either. (although it would be nice!)

If you are upgrading from an old version of TribesIP, unload the old script by typing in:
/unload -rs tribesip.mrc

Unzip the TribesIP .ZIP file into your mIRC directory. In a window in mIRC, type:
/load -rs TribesIP.mrc

Follow the on-screen installation instructions, and you're all set!


-- What's NEW in this version: --

  Individual Server Query  

Double-clicking any link (or clicking the appropriate Server Query button) in the TribesIP Chooser will bring up a new information dialog. This shows all the pertinent info for the server in question, including any map, mod, password, etc. Also shown is a list of all the players (up to 25) in the server along with their team, score, PL. Clicking the Auto-Refresh button allows it to continually update the dialog in real-time.

  GameServerList.cs Search  

Importing from Tribes' own GameServerList.cs is now even easier! You can search up or down in the list for words, phrases, or wildcard strings! For example, "ckb" or "cheat" or even "*nerz*vip*" is bound to give you a result!


-- What's basically UNCHANGED in this version: --


  Dialog-based install  

No more 'status window' stuff! Just install by typing: /load -rs TribesIP.mrc in any window, and follow the on-screen instructions in the dialog boxes! It will check to see if the files get created properly, and tell you! and every time you start mIRC or the TribesIP Chooser, it checks to see that critical variables have not become unset - if they have, it prompts you to reinstall!
  
  Dialog-based Chooser  

If you used any of the previous versions of TribesIP, you will remember the big listbox that stored all the favorites and caught servers... well, you're not going to use that window anymore! All you have to do now is right-click on a channel window to bring up the TribesIP Chooser, or double-click on a dropped link directly in the channel window!
  
  Choose Player  

The new Chooser is where ALL the TribesIP options "live" ... Once you get that open, you can do everything you need to do in there! When you join a server, you can now also choose the player you want to play as! (as well as choose a server password and record a demo) Just select it all, and click Join!

  Direct-Click Links  
  
Whenever someone drops a link in a channel, you can double-click it right there! No more fumbling aoround looking for menus or windows! Just double-click the link!

  Import from GameServerList.cs  

You can still import servers from the list created every time you refresh in Tribes. These are added to your "favorites" and stored in your mIRC directory, in the file TribesIPfavorites.txt
  
  Manual Add IP  

If you'd like, you can manually type in a server here (or cut & paste) in the format: 123.45.67.89:28000:01 and also add a server name too. Doing this will add the server to the "Choose Server" list. If you press the "Insert Selected IP" button, it takes the currently selected server in the "Join Server" tab and inserts it there so you can edit it.
  
  /addip Command  

You can still manually enter an IP in a channel window, example: /addip server Big Deal [IP:123.4.5.67:28001:00] ... Proper syntax is: /addIP server SERVER NAME [validIPaddress] or: /addIP [validIPaddress] 
  
  Post IP, Don't Join  

It's called "Post Selected IP in Channel" now, but it works the same. Just bring up the Chooser, Select an IP, and right-click on a channel window. It will post the server there (as opposed to the "Post IP Globally" option which posts it to all channels you are in)

  Join Selected Server  

If you want to join a server, but only post the link to one specific channel, just select an IP in the Chooser, right-click the channel window, and choose "Join Selected Server" - To post globally, click the "Join" button in the Chooser.
  
  Demo Record Mode  

It's an Checkbox in the Chooser now, what could be easier?

  Auto-Away  

Yes, when you join a server, TribesIP automatically sets you marked as 'away' when you connect, this was a much requested feature, so... it stays! It is STRONGLY suggested that you go into mIRC's options (Alt-O -> IRC) and check "Cancel away on keypress" to clear your /away when you come back from Tribes!

  Auto-Notice Joiners  

You can automatically privately /notice people who join channels you are in, with a server and some additional information! Great for your tribe's matches! (just put your tribe's tags in there as the match string, and it will only give the server, etc to them)

It's funny.. I removed this feature, then people asked me to put it back in! Cool.. So, I did.. and now it's all controlled via the Chooser too! You can select different channels (or combinations of them, press shift/control) You can enter a case-sensitive match string (no match string means it will notice to everybody), to limit the people you auto-notice IP's to, and you can type in a custom message to send to them also! The server it uses is the one displayed in the greyed-out box, You can change that by selecting a server in the "Join Server" tab and pressing the "Update Server" button! When you're done, press "Accept Changes" ... if you want to disable the feature, press "Clear all fields" then "Accept Changes" and it will turn Auto-Notice Joiners off. And note, it will echo any messages to the status window.. so, watch for it there.
  
  The TribesIP Window  

Well... It still exists, it's where all those dropped IP's get stored, but now it's hidden, and you should never need to use it at all! Don't worry about it! Pretend I never mentioned it!


-- Troubleshooting --


If TribesIP doesn't start, how do you know? Well, you won't be able to double-click on dropped IP's, and you won't be able to right-click on the channel window to bring up the TribesIP Chooser... If this happens, just go to your Commands menu (it's up there by DCC, File, edit, etc.) There should be a "Start TribesIP" menu option - just hit it, and boom, done.

Running the script for the first time creates 3 files. TribesIP.bat in your mIRC directory, and both TribesIP.cs and TribesIPRecord.cs in your tribes\config\ directory. If for some reason these files aren't created right, and no matter what you do they still don't get created right, perhaps a directory doesn't exist, maybe the disk is full... In the TribesIP .ZIP file, there is an extra folder called "TribesIPextras" - I have placed "default" versions of these files in there, copy them to the appropriate places, and edit them if necessary. Good luck!

If you get a '/run: command locked in options dialog' error, you have to ENABLE that command to be able to execute the tribes .EXE file! Here's how to do it: Go into the DCC menu -> OPTIONS screen (Alt-O) then General -> Lock and UNCHECK the 'Disable commands: /run' option!


-- A TribesIP History Lesson --


I first saw TribesLinker on Rasia's old page (on fortunecity, before he moved to PSS).. and as I had already been working on a Tribes IP Linker, I figured I'd check his out... Well, it was WAY better than mine.. Creating a separate window for the captured IP links was ingenious!

A few problems though, is the installation procedure was problematic, with no error-checking.. And it wouldn't actually create a working .bat file!

Also, I play a lot of password-protected servers, so I *needed* to be able to join a server with the right password!

So, I modified his script, cleaned it up, got it working...

And Now, with version 3.0, the code has almost TOTALLY rewritten.. I still use the @TribesIP window, as there are no "arrays" in mIRC.. but a listbox-window acts as one... (again, good idea Rasia) And the @TribesIP window is hidden away... I have utilized some new features in mIRC 5.61 to make the dialog-based Chooser as robust as possible, and still be easy to use.. and of course, the on 1:HOTLINK remote so you can double-click links in a channel window!

The only thing I have to add.. is the ability to ping servers and get game information from within mIRC.. maybe someone can do up a DLL version I can interface with? If you have ideas, let me know! Thanks! (I decided to leave this comment in here from the 3.0 release .. it's funny)

Other than that... I think I'm done (barring any nasty bugs that need to be squashed)


-- The "Particulars" --


Thanks to VeKToR and Fyren for the UDP server query code. Even though Fyren's "Master Server Query" didn't make it in to TribesIP (because mIRC is WAY to slow to parse all the server info) -- VeKToR's "Individual Server Query" code is used here to drive that interface!

Thanks to Tim Gift and Mark Frohnmeyer for supplying me with the technical specifications of the tribes server query!

Thanks to Labrat for insights into the Demo-recording code, and how to get it to actually work!

Thanks to Khaled Mardam-Bey for writing mIRC, and making it so that I have to totally rewrite TribesIP and all my other scripts for every new version!

Thanks to the Tribes Dev team, for... well.. making Tribes! Yoohooooo!

And all the guys in #scripters, for the help, the support, the spam, etc.. :)

Oh yeah -- and the members of Cabal kaBob -- for being my personal guinea pigs. Visit http://rj3.net/ckb/ for the coolest tribal website in existence!


  Original TribesLinker by: Rasia  
rasia@planetstarsiege.com
http://www.planetstarsiege.com/TheDen/

  TribesIP by: Cowboy  
cowboy@planetstarsiege.com
http://www.planetstarsiege.com/cowboy/
http://rj3.net/ckb/


TribesIP is (c)2000 "Cowboy" Ben Alman, please do not modify it or "borrow" code in any way without my permission, thank you!