Provided by: xscorch_0.2.1-1+nmu6_amd64 
NAME
xscorch - Annihilate enemy tanks using overpowered guns.
SYNOPSIS
xscorch
xscorch [options]
xscorch --help
DESCRIPTION
Xscorch is a clone of the classic DOS game, "Scorched Earth". The basic goal is to
annihilate enemy tanks using overpowered guns :). Basically, you buy weapons, you target
the enemy by adjusting the angle of your turret and firing power, and you hope to destroy
their tank before they destroy yours.
GAMEPLAY
First, fiddle with the options in the main menu. There are a number of options which are
described below, which may make the game easier or harder. The default options make for a
reasonable level of gameplay. Most of the game configuration is controlled from the user
interface, although there are a few command-line options which are mentioned below. Once
you are ready to begin a new game, you might want to Save Options to save your
configuration, then select Begin Game to start a new game.
Gameplay is divided up into several rounds. Each round consists of two parts: the
Inventory phase and the Battle phase. In the Inventory phase, you can buy weapons to
shoot at your opponents, and accessories to help defend your tank. See the Inventory
section below for information on the weapons and accessories you may buy. In the Battle
phase, you setup defenses, choose a weapon, aim and fire at your opponents. See the
section on Battle below, for more information.
INVENTORY
The player has the option to buy weapons and accessories to make the game more
interesting. Weapons are just that: an assortment of missiles, including ICBM-like
warheads, napalm, lasers, and a number of custom weapons to bring down specific defenses.
Accessories are methods to make gameplay easier for the player and increase their chance
of survival, with guidance systems, shields, fuel, batteries, and other odds-and-ends.
At the beginning of a round, each player is given an opportunity to buy or sell weapons
and accessories. Each player may have up to 99 of any item in their inventory. A few
weapons have an infinite supply (for example, Baby Missiles) - these weapons cannot be
purchased.
Weapons and accessories are sold in bundles; the price for the bundle is displayed in the
inventory, and you must buy items as a complete bundle. The exception to this is when a
player attempts to buy more of an item than their inventory can hold; in this case, the
bundle will be broken and the weapons are sold on an individual basis, with a small markup
applied.
Weapons and accessories may also be sold from a player's inventory. Again, items are
generally sold as a bundle. The player will receive a reduced amount of money for the
sale - hey, the middleman has to make money somewhere :)
In the Inventory screen, two panels are displayed, listing the weapons and accessories
that are available. The Tab key will switch between the various panes. Up Arrow and Down
Arrow will allow the player to scroll through the list of items, Right Arrow will buy a
bundle, and Left Arrow will sell a bundle of the currently highlighted item.
For each item, the name, bundle size/total price, and current inventory are displayed.
Items which can neither be bought or sold will appear darkened. If the player has maxed
their inventory for that item, or they cannot afford to purchase the item, or the item has
a higher arms level than the player is allowed, then the item cannot be purchased. Items
which can be bought will appear with an arrow pointing to the right, and items which can
be sold will appear with an arrow pointing to the left.
The items that are available are listed in the next two sections.
WEAPONS LIST
This list will be added once the weapons list is reasonably stable.
ACCESSORIES LIST
This list will be added once the accessories list is reasonably stable.
BATTLE
This overview is sadly, incomplete.
TANK CONTROLS
Left, Right
Change the turret angle. This will adjust the turret angle in increments of 5
degrees. For finer control, hold Shift to adjust the angle in increments of 1
degree.
Up, Down
Change the firing power, in the range of 0 to 1000. This will adjust the firing
power in increments of 20. For finer control, hold Shift to adjust the firing
power in increments of 1.
Tab Select the next weapon available in your inventory.
Shift+Tab
Select the previous weapon available in your inventory.
B, b Activate a battery. A single battery can restore 5% of damage done to your tank,
and therefore restore the maximum firing power by 5% when you are damaged. You
must have a battery to discharge in your inventory to excercise this option.
E, e Activate or energize the currently selected shields.
F, f Activate your fuel tanks. A window will be displayed, indicating the amount of
fuel you have available. As long as you have fuel, you may use the Left and Right
arrows to move one unit to the left or right, respectively. In general, you cannot
move your tank up a steep hill. Immobile tanks will not be able to excercise this
option.
R, r Force a redraw of the screen.
S, s Toggle the currently selected shields. The currently selected shields are the
shields which will be used when you Energize. Shields are classified by a power
number with a type suffix: M for magnetic shielding, F for force shielding, and S
for your standard, run-of-the-mill shields. If no shields are available, 0S is
displayed.
T, t Toggle contact triggers on/off. This is only meaningful if you actually have some
contact triggers of course, and when tunneling is enabled. Weapons that are fired
after this point will have contact triggers equipped (until you run out).
0 - 9 Display information about a particular player. 1 gives information about Player 1,
and 0 gives information about Player 10.
Enter Accept your orders.
Ctrl+Y Bring up the System Menu (this can also be accessed from the menus). You can
control certain graphics options from the system menu, clear the screen of smoke
trails, and end a round prematurely.
Ctrl+Z Pauses the game.
Ctrl+R Resign from the game. This will end the game for everyone. You will be asked to
confirm the resignation.
SYSTEM MENU
The system menu gives you some control over the game while it is in progress. In this
menu, you will have options to change how the game is displayed (e.g. the Graphics Fast
option described below). You also have access to a few useful commands, described below.
Mass Kill
Kills everyone still alive in the round. No player gets credit for the kills, and
none are considered a suicide. This option is useful if all human players have
already been eliminated from the game, but the AI players are making no progress
whatsoever in annihilating each other. This option ends the current round only.
Erase Smoke
If you have used smoke tracers or have Trace Paths enabled, then this option will
clear all smoke trails from the sky.
Retreat
N/A
Resign Game
Resigns from the current round and all remaining rounds. This option ends the
entire game, and will take you back to the intro screen.
Sound Setup
Takes you to the Sound Options window.
AI PLAYERS
Human The humans believe they are the superior mind. The AI's rather disagree with that
sentiment. Keep this in mind when you are wondering why 9 AI's would want to
simultaneously target your tank...
Moron This AI fires at random. Of all the AI's, this one has by far the highest suicide
rate. An alternate name is ``Cannon Fodder''.
Shooter
This AI goes for targets it has a line-of-sight to. It's not a great player
otherwise. This AI buys weapons that have the best economical yield, but during
the game it will select weapons which have the highest yield.
Spreader
This AI is similar to the Shooter, except a Spreader buys weapons with the highest
yield, without regard for the price.
Chooser
This AI chooses a victim. Once chosen, the victim is attacked until they are dead,
or the Chooser loses the ability to reach the victim. This AI does not need
line-of-sight, but fortunately it cannot compensate for wind.
Calculater
This AI is like Chooser, except a Calculater can compensate for the wind. These
guys are fairly deadly in a fight; they also tend to allocate large budgets to
defense and offense.
Annihilater
This AI goes for weapons that will cause as much damage as possible, without much
regard for individual victims. This AI prefers spread weapons to the more focused,
precision weapons. A few Annihilaters can clear the terrain easily. These AI's
don't worry about defenses too much. With their destructive tendency, they won't
survive long anyway - but neither will anyone else.
Insanity
No one knows what this AI thinks...
Unknown
This selects one of the above AI's at random, but you will not be informed which AI
was selected.
CONFIGURATION OPTIONS
Players/Rounds:
Number of Players (integer, 2-10)
Set the number of players participating in the game.
Number of Rounds (integer, >= 1)
Set the number of rounds to play for this game.
AI Type (list)
Select the AI type. Human players are ``Human''; the remaining AI's are documented
above.
Player Name (string)
Give a unique name for each player.
Tank Style (list)
Select the type/shape of the tank, for each player.
Economics:
Interest Rate (float, 0-0.30)
Interest rate for savings, compounded once per round.
Dynamic Interest (toggle)
If enabled, interest rates will change during the game.
Initial Cash (integer, 0-1000000)
Amount of money each player should start with.
AIs Can Buy (toggle)
If enabled, computers are permitted to buy items. The AI's are very uninteresting
if this option is turned off.
AIs Buy Aggressively (toggle)
If the previous option is enabled, the AI's will buy items conservatively. With
this option, the AI's will allocate larger budgets and buy bigger items early in
the game.
Free Market (toggle)
N/A
Scoring (list)
Specify how scoring works, selecting from Basic, Standard, Greedy, or possibly
other methods defined in the configuration file:
Basic Players only receive money for kills and survival.
Standard Players receive less money for kills and survival, but they will also
receive money for damaging an opponent.
Greedy Players are paid as in Standard scoring, but with bonuses for unused
inventory at the end of the round.
The Lottery (toggle)
If the lottery is enabled, there will be a random drawing at the start of each
round. A random player will receive a bundle of a random weapon for free as the
lottery award. This is a great way to inject a little extra life into AIs who are
usually conservative buyers. Plus it's always great fun when you get a free
Annihilator...
Physics:
Air Viscosity (float)
N/A
Gravity (float, 0-10)
Specify the gravity, in pixels per cycle squared (one cycle is roughly 50
milliseconds).
Ground Damping (float, 0-10)
Specify the ground damping, used in tunnelling calculations.
Maximum Wind Speed (float, 0-10)
Specify the maximum wind speed, in pixels per cycle squared. The actual wind
velocity is initialised once per round, to some value in (-max, max).
Wind is Dynamic (toggle)
Normally the wind remains constant through a round. If this is enabled, the wind
will change once per turn.
Suspend Dirt (percentage)
N/A
Tanks Fall (percentage)
N/A
Borders Extend (integer, >= 0)
This specifies how far off-screen weapons should be tracked, when you are playing
with no walls. When this value is zero, weapons will disappear as soon as they
leave the screen in the horizontal direction, even if wind would have brought them
back on-screen.
Walls Are (list)
Specify how weapons behave when they hit a boundary. Note, the ground is always
``concrete'' -- this specifies how the sides and ceiling behave:
None The sides and ceiling are open.
Concrete All sides are solid. Weapons hitting any boundary will explode.
Padded Weapons hitting the sides and ceiling will bounce off, although at
a reduced velocity.
Rubber Weapons hitting the boundary will bounce off at exactly the same
velocity.
Springy Weapons hitting the boundary will bounce off with an additional
``kick'' to the velocity.
Wraparound The ceiling is open. Weapons going off one side will reappear on
the opposite side. Explosions will also wrap around the screen if
they detonate near an edge.
Random One of the above types of walls are selected at random.
Landscape:
Sky (list)
Specify the background sky.
Hostile Environment (toggle)
N/A
Land Generator (list)
Specify the generator to use to create the land.
Bumpiness (percentage)
Specify the noise on the generated landscape.
Weapons:
Arms Level (integer, 0-4)
Specify the maximum arms level for the game. Only weapons with this arms level or
lower may be purchased by any player, under normal circumstances.
Bomb Icon Size (integer, 0-4)
Specify the size of the bomb icons, while they are traversing their path in the
sky. This does not affect the size of explosions, or the size of the smoke paths
(if trace paths is on).
Tunneling (toggle)
If set, weapons are allowed to tunnel through land. If you enable this, you will
want to buy contact triggers if you want a particular weapon to always detonate on
impact (instead of tunneling through land).
Scaling (float)
Scale the size of explosions by this value. If playing on a very large or very
small playing field, you might want to adjust this value.
Trace Paths (toggle)
If enabled, all weapons leave a smoke trail to reveal their trajectory. If this
option is off, you can still use Smoke Tracers to determine the path a weapon will
take.
Useless Items (toggle)
Some weapons are not useful given the current configuration (e.g. contact triggers
are irrelevant if tunneling is disabled). If this option is enabled, then weapons
which will have no effect are not listed in the inventory screens.
Graphics:
Screen Width (integer)
Set the width of the playing field, in pixels.
Screen Height (integer)
Set the height of the playing field, in pixels.
Dithering (toggle)
If enabled, the land and sky gradients will be dithered. This option is
particularly useful on 16-bit displays, where the gradient is very noticeable
otherwise. This does slow down land generation somewhat.
Animation (toggle)
If enabled, explosions and other effects will be animated. This option can also be
controlled from the System Menu.
Graphics Are Fast (toggle)
If enabled, all graphics are always as fast as possible. This option can also be
controlled from the System Menu.
Computers Are Fast (toggle)
If enabled, graphics are fast when there only computer players are alive. This
option can also be controlled from the System Menu.
Gameplay Options:
Mode (list)
Determines if all players will fire at once (Synchronous), or whether each player
will fire independently (Sequential).
Teams (list)
N/A
Order (list)
Determines the player order.
Talk Mode (list)
Determines who is allowed to talk.
Talk Probability (percentage)
Determines the likelihood that a player will speak at the end of a turn.
Extended Status (toggle)
If set, the status bar will contain an additional row of extended information
during the game (things such as trigger and battery inventories, life, wind).
Tooltips (toggle)
If set, tooltips will be displayed where available. A restart is required to
change the value of this option.
AI Controller:
Human Target Practice (toggle)
AI's will always prefer human targets to AI targets (except for AI's that fire at
random). When playing against 9 Calculators, this can make your day pretty lousy.
Allow Offset Targetting (toggle)
Generally, when a weapon hits a shield it does less damage than an explosion
detonating right outside the shield (weapons hitting the shield do not have a
chance to detonate). This changes the AI targetting behaviour so they will
deliberately aim outside the shield, if their intended victim has raised shields.
Always Offset (toggle)
If the above option is set, this option will force the AI to always offset its
targetting as if the player had raised shields. This allows the AI to compensate
for cases where the player may simply not have had their turn yet to raise shields.
The downside is the AI will never attempt to score a direct hit with this option
enabled.
Enable Scan Refinement (toggle)
If set, harder AIs are allowed to refine their trajectories by computing
trajectories that take into account player shielding effect and various other
factors they do not normally consider. This option could slow down gameplay a bit
but makes the AIs much more difficult.
No Budget Constraints (toggle)
AI's will spend as much money as they can, disregarding their budget preferences.
Sound Setup:
Enable Sound (toggle)
When set, music and sound effects will be played.
Use HQ Mixer (toggle)
When set, mikmod's high-quality mixer will be used.
COMMAND-LINE OPTIONS
--help Display a brief synopsis of the command-line options available.
--insanity
This is insanity, Max! Or what if it's genius?
--yields
Display weapon yields, and economical yields.
--geometry=wxh
Specify an initial window geometry for xscorch, where w is the width and h is the
height of the playing field. Useful for displays less than around 800x600
resolution. Note this option overrides the settings in the config file, but you
can save the new options to your config file so you don't have to specify this
every time. You may also use -g.
--config=file
Load an alternate user config file, in file.
--sound
Enable music and sound effects. You may also use -S.
--nosound
Disable music and sound effects. You may also use -s.
--hqmixer
Enable use of the high-quality mixer, if sound is enabled. This may use a lot of
CPU power on older machines.
--nohqmixer
Disable use of the high-quality mixer, if sound is enabled.
--name Set the name of your player, if you are initiating a network game. By default,
your user name is used.
--port Set the port number to use in a network game. This option is only relevant if you
also specify --client or --server. The default is dependent on the protocol
number, but is some large port number.
--client=server
Start xscorch in client mode, and connect to server (which should already be
running). If --name and --port are not specified, reasonable defaults are used.
--server
Start xscorch in server mode, and wait for connections from the clients. --name
may be used in conjunction to specify the name of this player.
NETWORK MODE
This is very unstable right now, and therefore is not documented.
FILES
~/.xscorch/config
User's default configuration for xscorch.
tankprofiles
Profile bitmaps for the tanks, usually stored in the local share directory.
SEE ALSO
The xscorch home page at <http://www.xscorch.org/>. There is also additional
documentation in the source distribution.
AUTHORS
xscorch was written by Justin David Smith <justins(at)chaos2.org> and Jacob Luna Lundberg
<jacob(at)gnifty.net>. (Please do not list these e-mail addresses on webpages, or list
them in other packages, without contacting us first.)
This manual page written by Justin David Smith <justins(at)chaos2.org>. Copyright(c)
2001,2000 Justin David Smith.