This file shows the basics of spacewar, and info on creating mods and using the console.

----
Restoring basic spacewar files
----
If you get a missing file error or something when you run spacewar, go to your dos prompt and run
spacewar install
and it will restore the basic files.  You can also run the bat file titled restore original settings that should have come in the spacewar zip file.


----
Opening mods in SpaceWar
----
Open EXMOD.EXE and enter the name of your mod.  It will automatically run spacewar, and load your mod.

or....
When you run spacewar at the dos prompt, enter it in this format:
spacewar -mod [modname]
and the mod will be opened when spacewar is executed.  Make sure you dont type the extension at the end of the mod name.  If you want to execute your mod from windows, go to start > run and enter the path of spacewar (omit the .exe at the end) and do the -mod [modname] thing.  Or you can create a batch file; create a new text file, and enter
spacewar -mod blah
where blah is the name of your mod.  Save the file with a .bat extension and in your spacewar directory.  Run the file and it should execute spacewar with your mod.


----
Using the spacewar console
----
Press the ~ key during gameplay to open the console.  To set values, enter an area (ie: shipcolor,starcolor,starspeed,firespeed,nrg; more are listed at the bottom of this file) followed by an = and then the value and hit enter.  If the console doesn't recognize the area, the line will end with a ?, and will not affect the game.  Spacing around the = doesnt matter.


----
Creating mods with the SpaceWar Console
----
In the console, enter
writemod=[filename without extension]
to begin writing to a mod file.  Every value you set after this will be written to the mod.  To stop writing, enter
closemod=[mod description/info]
and the mod will be saved.


----
Creating mods with a text editor
----
At the top of the file, enter
"[name of mod]", "[mod info]", "[number of modifications]"
followed by a line break (hit enter).  Make sure the number of modifications entered is the right number, otherwise your mod wont work correctly; if the number you enter is less than the real number, then spacewar won't read all of your modifications; if it is more, then you will get a corrupt file error.  Enter the modifications in this format:
"[area to edit]", "[value]"
and follow each with a line break.  When youre done, just save the file.  If it doesnt work correctly, make sure you didnt make any typos or anything like that.


----
Qbasic color commands
----
When you set a color in qbasic, these are the 16 values:
0-black
1-blue
2-green
3-cyan
4-red
5-magenta (pinkish color)
6-brown
7-grey
8-dark grey
9-bright blue
10-bright green
11-bright cyan
12-bright red
13-bright magenta
14-yellow
15-white


----
Areas and values
----
(sorted in order that they were added to SpaceWar)

-Modtitle-
modtitle=title
The title appears at the spacewar main screen.

-windowcolor-
windowcolor=color
Sets the color of your ship's window.

-shipcolor-
shipcolor=ship
Sets the color of your ship.

-starcolor-
starcolor=color
Sets the color of the stars.

-enemcolor-
enemcolor = color
sets the enemy color

-nostars-
nostars=value
value is 1 to turn stars off, 0 to leave them on

-shipdist-
shipdist=dist
default is 1; multiplied by the normal distance, just play around with it to see what it does.

-starspeed-
starspeed=speed
default is 1; multiplied by the normal starspeed

-incoming-
incoming=message
the message shown when the enemy fires at you

-lagmeterx-
lagmeterx = xcoord
x coordinate of the delay meter

-lagmetery-
lagmetery = ycoord
y coordinate of the delay meter

-lagmetersize-
lagmetersize = radius
radius of the delay meter

-lagmetertext-
lagmetertext = textcoord
text of the delay meter

-firespeed-
firespeed = speed
default 1; multiplied by the normal speed

-enemfirecolor1-
enemfirecolor1 = color
first color of the enemies flashing projectiles

-enemfirecolor2-
enemfirecolor2 = color
second color of the enemies flashing projectiles

-enemnrg-
enemnrg = nrg
number of energy points each enemy ship has

-firedamage-
firedamage=damage
number of energy points the enemy loses each time you shoot them

-guibackcolor-
guibackcolor=color
color of the spacewar opening screen background

-guiforecolor-
guiforecolor=color
color of the spacewar opening screen text

-shrooms-
shrooms = value
value is 1 to turn shrooms on and 0 to turn it off.  Flashing background colors, hard to play, trippy!

-enemfirespeed-
enemfirespeed=speed
enemy's projectiles' speed; multiplied by the normal speed.

-enemspeed-
enemspeed=speed
enemy's moving speed, multiplied by normal speed.

-alwayscheat-
alwayscheat = value
if value = 1 then always cheat is on, 0 and it's off; you cant save your high scores

-nrg-
nrg=nrg
sets your number of energy points; default is 10

-gameforecolor-
gameforecolor = color
color of (some of) the text on the game screen

-gamebackcolor-
gamebackcolor = color
the game's background color

-killpoints-
killpoints = points
number of points you get for killing an enemy; multiplied by their distance from your ship

-sound-
sound = value
type of sound; 0 is soundblaster sound, 1 is computer speaker sound, 2 is no sound

-control-
control = value
type of control; 0 is keyboard control, 1 is mouse control 1, 2 is mouse control 2

-lagmeter-
lagmeter = value
turns the lag meter on or off, 1 or 0

-framerate-
framerate = value
turns the framerate meter on or off; No (capital n, lowercase o) to turn it off, anything else to turn it on

-autoadjust-
autoadjust=value
auto adjust frame rate on or off, 1 or 0

-enemyfireprob-
enemyfireprob = value
probability that the enemy will fire; a number from 1 to 30 thousand and some;  Default is 50

-enemdist-
enemdist=distance
sets the distance the enemy starts from you... remember to use your zoom recticle (right click) for far away enemies

-movechance-
movechance=value
value is at least 5; sets the probability that the enemy will move left/right or up/down

-moveit-
moveit=value
value is the distance the enemy moves when using movechance

-explodespeed-
explodespeed=speed
speed that the enemy's explosion moves after you destory their ship

-passlose-
passlose=points
number of points you lose when an enemy passes you, default is 1000

-scrmode-
scrmode=8 or 9
sets the screen mode

>>THE FOLLOWING ARE ONLY USED IN THE CONSOLE<<

-writemod-
writemod=filename
the function used to write mod files in the console; no extension on filename

-modname-
modname=name
sets the name of the mod to be written

-closemod-
closemod=mod description
closes the mod and sets the mods description

-loadmod-
loadmod=modname
loads mods from the console

-message-
message=text
displays a wavy message, like the level one