AQ5 Teleport Friendly Codes

Moderators: BitMask, Havok

Post Reply
User avatar
Site Admin
Posts: 7585
Joined: Fri Jun 18, 2004 2:22 pm
Location: Look into the sun.

AQ5 Teleport Friendly Codes

Post by Havok » Sat Mar 27, 2010 11:51 am

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.

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.

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.2, the AUXHOST1.BAT file should contain:
TELEPORT gamedir

and the AUXHOST2.BAT file may be left blank.

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.

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.

9-Jan-97 Andy Dukes - eMail ADukes@CityScape.Co.UK

Post Reply

Return to “Messages From Old Games”