RETURN TO SWITCHBOARD                   12A. Asteroid   12K. Teleport
Return to Add-On Sub-Menu   12B. Jump Gate   12L. Machines of Yore
1. Introduction to VGA Planets   7. Minefields Sub-Menu   12C. Raceplus    
2. Race Information Sub-Menu   8. Combat Sub-Menu   12D. Starbase Plus    
3. Friendly Codes Sub-Menu   9. Ion Storm Sub-Menu   12E. Tachyon    
4. Planet Information Sub-Menu   10. Misc. Information Sub-Menu   12F. Fortress Host (Fhost)    
5. Starbase Information Sub-Menu   11. Strategy and Strategy Guides   12G. Nemesis    
6. Ship Information Sub-Menu   12. Add-on Information   12H. Gryphon    
  12I. Jupiter    
  12J. Banzai!    
TELEPORT ADD-ON:  
  Teleport An Add-On for VGA Planets V3.5 (Host 3.2x)  
  Teleport  is copyright Andrew Sterian, Thomas Voigt, and Steffen Pietsch  
  VGA Planets is a trademark of Tim Wisseman  
  Overview  
    A modifed version of the Portable Host Development Kit EXAMPLE PROGRAM #5  
    I've made very few changes, it does not generate the "xyz has been teleported" messages, has some  
      getch ()s in case of problems and displays a bit of what is going on to the screen.  
    This program is meant to demonstrate what an AUXHOST add-in program might look like. It is really no different   
  from an external program except that it calls WriteAUXHOSTMessage() instead of WriteMessageToRST()  
  or WriteExternalMessage() to write player messages.  
  This example program implements rudimentary transporter technology for starbases. Starbases may  send one   
  type of mineral (or colonists, supplies, and money) to another starbase on each turn. The amount of  
  that substance or item to transport is fixed at 20% of the current stock but this can be made configurable   
  or intelligent by some enterprising young programmer.  
  Contents  
    TELEPORT.EXE  
  New Game Setup  
  This utility is meant to be run in the AUXHOST1 phase. For example, in a PHOST batch file, you would type:  
  PHOST -1 gamedir  
  TELEPORT gamedir  
  PHOST -2 gamedir  
  PHOST -3 gamedir  
  Using HOST 3.20, the AUXHOST1.BAT file should contain:  
  TELEPORT gamedir  
  and the AUXHOST2.BAT file may be left blank.  
  Game Info  
  The planetary friendly code is used to effect transfer. If a planet's friendly code is 'TX_' (where _ is N, T, D, M,  
  C, S, or $) then the starbase in orbit of that planet is a transmitter. The special transmit friendly codes, then,  
  are:  
  TXN Transmit Neutronium  
  TXT Transmit Tritanium  
  TXD Transmit Duranium  
  TXM Transmit Molybdenum  
  TXC Transmit Colonists  
  TXS Transmit Supplies  
  TX$ Transmit Megacredits  
  The starbase will transmit 20% of the current stock of the item to the receiver starbase. The receiver   
  starbase must have its friendly code set to 'RX_' where '_' is once again the letter code for the item  
  to receive (as above). Multiple transports may be occuring at once on the same turn but they are all done  
   in order of base ID numbers. That is, the lowest numbered base with a transmit friendly code is found, and  
  then the lowest numbered base with a matching receive code is used as the receiver. The next-lowest  
  numbered base is  found with a transmit code, etc.  
  HOST Sequence  
  AUXHOST 1  
  Credits  
  Design and Programming: Andy Duke  
  9-Jan-97 Andy Dukes - eMail ADukes@CityScape.Co.UK  
  REGISTRATION INFORMATION  
   This file is copyrighted by the PDK authors Andrew Sterian, Thomas Voigt  and Steffen Pietsch   
  in 1995. You may copy and distribute this file freely as long as you retain this notice and explicitly   
  document any changes you make to this file (along with your name and date) before  
  distributing modified versions.  
  This is an example program for instructional purposes only. It is not guaranteed to work correctly, or even  
  to necessarily compile on all systems. You use this program at your own risk.