Category : Recently Uploaded Files
Archive   : AFSIM131.ZIP
Filename : AFSIM.DOC

Output of file : AFSIM.DOC contained in archive : AFSIM131.ZIP
AFSIM v1.3
VGA Planets Battle Simulator
Sean Martens, 1994.


AFSIM is essentially a menu-driven front-end to the VGA Planets VCR program.
You can use AFSIM to simulate any battle scenario that could take place in
the game itself. If it's possible in a battle then it's possible in AFSIM.

This includes:

Battles involving up to 50 ships, plus a planet and starbase.
Battle-order determined by ship #id, friendly code, mission, and
primary enemy.
Engine-tech shield bonus.
Race bonuses (such as Fed "Scotty" bonus).
Any race can use any ship.
Variable torpedo, fighter, and crew complements.
Battles that start with drained shields and/or hull damage.
The result of one battle becomes the input to the next.
Ships without fuel fighting or not fighting, depending on planetary
NUK code.

Additional features:

Transparent support for alternative race names, ship designs and
weapon setups (as in ALTLIST2, etc).
User-friendly, menu-driven capture screens.
Re-run battles as many times as you like.
Quickly edit battle set-ups to run multiple "what-if" scenarios.
Log battle results to disk.
Save battle set-up to disk for later retrieval.
Save time by importing your actual game data using INFORMER.

AFSIM uses VCR itself. If you have patched VCR to remove sounds or
explosions then AFSIM will still work...but faster. AFSIM shares hardware
with VCR and this will cause a small amount of "space junk" to appear on your
screen whilst running a battle. These graphic glitches are not a problem
and battle outcomes are not affected.

The chance part of VCR is generated by the Host generating a random integer
as an input variable to each battle. AFSIM duplicates this precisely...and
this is why it is a good idea to run all simulations several times in order
to build up an average picture of the outcome.

Because AFSIM uses VCR itself it also duplicates all of VCR's little
"features", such as beams that do not fire and Empire carriers that fail
to launch their fighters on occasion. Don't blame me...blame Tim!

AFSIM is shareware and can be used successfully without registration.
However, there are several features that are partially disabled in the
unregistered version:

Limit of 4 ships
Limit of 60 defence posts on a planet.
Limit of 20 fighters on a starbase.
Fleet imports from Informer are allowed...but are pruned in line with
the above limits.

See REGISTER.DOC for prices and other registration details.

Copy the files from the AFSIM archive into the directory that also
contains your VGA Planets executable files. AFSIM only requires
VCR.EXE - but VCR.EXE requires various resource files that are
distributed with the game. To start up AFSIM, merely type AFSIM and
press [ENTER].

The editable file AFSIM.CFG is used to define variables, such as the
percentage by which engine tech boosts shield power, and also stores the
registration name and code (if applicable). The file, automatically
created by AFSIM if it does not already exist, has the following default


: An integer value from 0 to 100. The % by which engine tech
boosts shield power.
: YES/NO. Fed crew bonus. All Fed ships get a 25% shield boost
between battles. All damaged weapons are still able to fire.
: YES/NO. Enables or disables an special battle-end detect
algorithm within AFSIM. If a battle ends with a ship
exploding then the time taken to start the next battle, or
return from VCR to AFSIM, is greatly reduced.
: YES/NO. Append to AFSIM.LOG or overwrite old file.

An additional two lines of registration details can be added to
AFSIM.CFG manually, although AFSIM contains an internal registration
process that will update AFSIM.CFG for you:

Fred Bloggs

The registration name and code are both case sensitive. The case
of the name will be exactly as you request when registering the
product. You can register "Fred Bloggs" or "fred bloggs" or "FRED
BLOGGS"...but only one name and one code will work in AFSIM.CFG.

Line order is not important in AFSIM.CFG. AFSIM will assume default
values for any line that is deleted. The engine tech and Fed crew
bonuses are variables that can defined in the Host by HCONFIG...and
are not available in older versions of the Host program. Simulation
results from AFSIM will only be the same as results from the Host if
these variables are the same as and .

Over-rides quick battle-end determination.

The following keys have similar functionality throughout all AFSIM data
entry screens:

[F5] Call up pick-list, if applicable (race type, ship hull
selection, etc).
[F10] Process all data entered, and exit screen. You can press this
key no matter how few or how many fields you have edited.
[ENTER] Accept field value.

The "up" and "down" arrow keys are used to move from field to field and
work in the same way as the [ENTER] key if data has been changed.

Only data to the left of the cursor is accepted by AFSIM. Everything
else is trimmed. As an example, you can edit a crew of 480 to a crew
of 10 merely by typing 10 and then pressing "up", "down" or [ENTER].

All fields will default to the maximum allowable value if you type a
value that is higher than the maximum. For instance, if you enter 99
beams for a Golem Class Baseship the field will automatically revert
to 6 beams as soon as you press [ENTER] or move to another field
(assuming you are not using ALTLIST).

Combat: Fight between two units.
Battle: One or more combats.

Two Outrider Class Scouts with lasers fighting each other is one combat.
When one Scout, after 2 time-outs, finally beats the other Scout, you've
had a battle with 3 combats.

Options on the AFSIM main menu will appear and disappear as appropriate.
As an example, you will not be presented with the option "View log file"
when there is no log file to view.

The following menu options are used:

Add a ship
Review a ship
Delete a ship
Add planet to battle
Edit planet details
Edit starbase details
Save battle to disk
Load battle from disk
Delete saved battle
Run the battle
View log file
Delete log file
Config options
Enter registration code


"Add a Ship" allows a new ship to be added to the order of battle (OOB),
calling a data entry sub-menu with the following fields:

Field Name ³ Values ³ Picklist ³ Comments
Race of owner ³ 1-11 ³ Yes ³ May be different to race of
³ ³ ³ builder... you can simulate
³ ³ ³ captured or traded ships.
Ship ID ³ 1-500 ³ ³ Least importance for OOB
Friendly code ³ 1-999 ³ ³ Number 3 determinant of OOB
value ³Non-numbers³ ³
Primary enemy ³ 0-11 ³ Yes ³ Number 2 determinant of OOB
³ ³ ³ 0 = no primary enemy.
Mission set to ³ Y/N ³ ³ Most important for OOB
kill? ³ ³ ³
Hull type ³ 1-105 ³ Yes ³ The picklist gives a list of
³ ³ ³ races. Selecting the race that
³ ³ ³ can build the desired hull
³ ³ ³ gives a colour coded hull
³ ³ ³ "shortlist".
³ ³ ³ Dark Grey = freighters
³ ³ ³ Beige = beam only hulls
³ ³ ³ Yellow = torpedo ships
³ ³ ³ Pink = carriers
Engine type ³ 1-9 ³ Yes ³
Beam type ³ 1-10 ³ Yes ³ Remember that beam slot is not
³ ³ ³ always the same as beam tech
Beam count ³ 0 or more ³ ³
Torp type ³ 1-10 ³ ³ Remember that torp slot is not
³ ³ ³ always the same as torp tech
Torp count ³ 0 or more ³ ³ Number of launchers
Torp/fighter ³ ³ ³ Number of actual torpedoes or
count ³ 0 or more ³ ³ fighters on board ship
Shield strength³ 0-100 ³ ³
Damage ³ 0-99 ³ ³ If greater than 0, automatically
³ ³ ³ determines max shield strength.
Crew ³ 1 or more ³ ³ Defaults to the normal crew
³ ³ ³ number for the selected hull

Configuring a freighter with beam weapons or a carrier with torpedoes
will not have any effect.
In order to reduce set-up time, repeating the "Add a ship" process will
clone the previous ship edited.

The main menu "Review a ship" option will appear after the first ship
has been added to the OOB. Choosing this option will go straight to the
ship edit screen if there is only one ship in the OOB. Otherwise, the
OOB will be displayed and you can choose which ship you wish to edit.
The OOB displays Ship #ID, friendly code, primary enemy (as a number)
and hull type. Ships with mission set to "Kill" are coloured in Red.
The OOB will be recalculated each time it is displayed.

The main menu "Delete a ship" option will appear after the first ship
has been added to the OOB. If there is only one ship in the OOB,
selecting this option will delete the ship. If there is more than
one ship you will be presented with the OOB. Highlight the ship to be
deleted and press [ENTER]. You will be returned to the main menu.

If you have selected "Add Planet to Battle" then enter :

Field Name ³ Values ³ Picklist ³ Comments
Race of owner ³ 0-11 ³ Yes ³ A planet with Race = 0 does
³ ³ ³ not fight
Defence Units ³ 1-500 ³ Yes ³ [F5] gives defence table,
³ ³ ³ showing relation between N§ of
³ ³ ³ units and N§ of beams, beam
³ ³ ³ beam tech, and N§ of fighters
Friendly code ³ 1-999 ³ ³ All codes valid in VGA Planets
value ³Non-numbers³ ³ can be used, including ATT and
³ ³ ³ NUK. Planetary codes can be
³ ³ ³ very important when you are
³ ³ ³ fighting alongside allies.

The main menu "Edit starbase details" option appears only after you
have entered details for the planet, and "Add planet to battle" will be
replaced by "Edit planet details".

If you have selected "Edit Starbase Details" then enter:

Field Name ³ Values ³ Picklist ³ Comments
Beam tech ³ 0-11 ³ Yes ³ Tech = 0 will remove the base
³ ³ ³ from the matter how
³ ³ ³ many beams or fighters are
³ ³ ³ present
Starbase ³ 0-60 ³ ³
fighters ³ ³ ³
Defence Units ³ 0-200 ³ Yes ³ Remember that starbase defence
³ ³ ³ can increase the N§ of beams.
³ ³ ³ [F5] gives a defence table
³ ³ ³ (offset by the number of bases
³ ³ ³ that you have already entered
³ ³ ³ for the planet) that will allow
³ ³ ³ you to explore this
³ ³ ³ relationship.

At any time whilst entering the details of Ships, Planets, and Starbases
for a battle you can save the current OOB to disk. When you select "Save
battle to disk" you will be presented with 7 slots. Each slot is
accompanied by a text description of up to 35 characters. You will only
be able to save if there are available slots.

The main menu "Load battle" option appears only if there is a battle to
load. There are 8 load slots, the 1st slot being reserved for import
of data from INFORMER versions v2.3 and v2.35. INFORMER v2.4 has the
ability to work with multiple exports.

Loading a battle will overwrite all existing data. AFSIM will ask for
confirmation if any of this data has not been saved.

Note: you can import multiple OOB's from INFORMER v2.3-2.35 by a process
of load and save to new slot. If you run out of slots you can just
rename the saved OOB's: the files bear the names AFSLOT1.DAT to

The main menu "Delete battle" option appears only if there is a battle
to delete. The process is similar to the above.

AFSIM contains a checking mechanism that will only display the "Run
the battle" option when there is a battle that can be run.
To illustrate, if you have entered 10 Empire and 10 Bird Man ships and
none of the ships are set to "Kill" (or have the appropriate primary
enemy set) then you've got a party...not a battle. Also, you can call me
warped, but I do not believe that freighter vs freighter counts as a
battle - no matter what VCR thinks to the contrary.

Selecting "Run the battle" option will run through all combats until
there are no ships left that are capable of fighting. You can interrupt
this process at any stage merely by pressing [ESC] once or twice. The
battle will be logged up to (but not including) the interrupted combat.

When the battle simulation is over, you are automatically returned to
the main menu where you be presented with "View log" and "Delete log"
options. The log file is called AFSIM.LOG, and can be viewed with any
text file viewer or editor.

The log is displayed in AFSIM with 1 screen = 1 combat. You can move

from combat to combat using the "up" and "down" arrow keys and from
battle to battle using [Pg Up] and [Pg Dn]. This second feature is not
applicable if you are not using the logging option.

Below is a sample log screen:

Batavia a GORBIE CLASS BATTLECARRIER Owned by The Evil Empire
10 Heavy Phaser
It had 250 fighters
Starting damage : 0 Starting shield : 100
============================== vs ========================================
Tugela a DETH SPECULA CLASS FRIGATE Owned by The Bird Men
6 Heavy Phaser
4 Mark 8 Photon with 35 torpedos
Starting damage : 0 Starting shield : 100
============================== The outcome ================================
Batavia won
==================== Status after combat ==================================
It had 238 fighters remaining
Ending damage : 0 Ending shield : 73

If you are not using the option, selecting "Delete log" on the
main menu will delete the entire log file. If you are using the
option, you will be presented with a list of the logged battles
and will be able to mark individual battles for deletion (processing
with [F10]).

The main menu "Config options" choice is used to temporarily change
any of the options in AFSIM.CFG. AFSIM.CFG is not written to. This
gives you the ability to do things like:

Turn off
Set up a battle
Run battle without logging
Edit battle and re-run battle until you are happy.
Turn on
Run battle with logging

The "Enter registration code" option is self-explanatory. See
section on AFSIM CFG file for rules on capitalisation of your
name and the code.

Program Author: Sean Martens
Program Docs: Mark Symons
The Rhino: Lisa Martens
Ship Names: British vessels lost at sea 1939-45 (HMSO)
The Conquest of Gaul (Julius Caeser)
Various rivers in Zululand
Metamorphoses (Ovid)
...Because anything's gotta be better than "USS Dave"
The Customer: That's you! The development of AFSIM would have ceased
long ago without all of the encouragemnt I have received
from users.

I will always try and upload new versions of AFSIM and INFORMER to
the VGA Planets ftp sites at colostate...and berlin if I have time.

You can find out if a new version of AFSIM or INFORMER has been uploaded
by sending an email query as follows:

To: [email protected]

USER anonymous
cd pub/planets/utilities

You can then retrieve a file using the following email message (using
AFSIM v1.4 as an example):

to: [email protected]

USER anonymous
cd pub/planets/utilities
get ; 5 files max

I also upload new version to the following South African BBS's:

AECI BBS +27 11 608-1516 ($18/annum subscription)
Fast! BBS +27 11 706-1749 (Free download).

AECI BBS gets all Beta versions of my software...because that is where
the Beta testers hang out.


A final word...
I hope you enjoy using this utility and find it a help in planning and
executing your conquest of the galaxy. I welcome any and all feedback,
suggestions, and bug reports.

Order of battle is often the most critical aspect of a successful
simulation. The following text is an extract from Tim Wisseman's
HOST315.DOC and may help explain things...

"All ships have a new attack order.
They will now fight in an order that depends on three things:
the mission, the primary enemy and the friendly code.
The friendly code can give an attack value from 1 to 999.
To use attack values your friendly code must begin with a
number value. The attack values will NOT affect the way in
which a ships fights, it only effects the battle order.
Your enemy's attack values will NOT effect your battle order.
A attack value of 1 is the lowest possible attack value.

Here are examples of attack values base on some friendly codes
where "x" is any non-number character.

Friendly code Attack values
xxx 1000
1xx 1
10x 10
01x 1
999 999
123 123
18x 18
x23 1000
xx2 1000
x1x 1000

The ship with a "KILL" mission & the lowest attack value will
attack first. If two of your ships have the same attack value
then the ship with the lowest ID number will attack first.
The ship with a "PRIMARY ENEMY" set and the lowest attack value
will attack after all the "KILL" mission ships are done.

Ships with their mission set to "KILL" will fight as a first group.
Ships with a mission other then "KILL" and the primary enemy
set will fight as a second group.
All other ships will be protected by the "KILL" and primary enemy
ships until those ships are destroyed or captured.

Ships that are not on a kill mission and don't have a primary enemy
set will defend themselves in an order based on the friendly
code attack values."

  3 Responses to “Category : Recently Uploaded Files
Archive   : AFSIM131.ZIP
Filename : AFSIM.DOC

  1. Very nice! Thank you for this wonderful archive. I wonder why I found it only now. Long live the BBS file archives!

  2. This is so awesome! 😀 I’d be cool if you could download an entire archive of this at once, though.

  3. But one thing that puzzles me is the “mtswslnkmcjklsdlsbdmMICROSOFT” string. There is an article about it here. It is definitely worth a read: