
                             =============
                             A N A R C H Y
                             =============

                              RELEASE 1.4

          A Space Combat and Trading Game for the TI83 and TI83+

                   Written by Paul Robson    (Coding/Design)
                   and Konstantin Beliakov   (Graphics)

                   TI Calculator Program Alliance (TCPA)

        To see what's new see the improvements/changes list at the
          bottom of the text. The main changes are concerned with
         the difficulty level now ; the original was too hard,
              so this is easier and has a settable level.

Introduction
------------
Anarchy is a space trading game, loosely modelled along the same lines as
the classic "Elite". It's not half as complex though (well, it is only
about 6.5k in size)

The aim of the game is to trade goods amongst the sectors of the galaxy,
raising money to buy better equipment for your ship.

..... no, the aim of the game is to blow up as many bad guys as you can,
whilst trading to get $$$ so you can blow up more bad guys. Then blow up
the good guys !

Note: this text refers to A,B and C keys. These are actually the top
row, 2nd, Mode and Del.

Installation
------------
Anarchy runs under JoeWing's ION shell, for the 83 and 83+. Any other
shell which runs ION programs should cope with it, as it does not use
any OS calls at all.

The Anarchy World
-----------------
The Anarchy world is a galaxy consisting of 64 sectors, arranged as an 8x8
grid. Each of these sectors contains a single planet. The galaxies of
"Anarchy" have dissolved into Chaos ; there is no real effective government,
just a loose collection of worlds held together by the need for trade. (A bit
like the USA). And it's getting rapidly worse as the galaxy descends into
chaos.... (fill in)

The only difference between the worlds is the degree of madness the local
ruling faction is willing to tolerate. Some sectors are (relatively)
peaceful, and have trading craft that trundle around harmlessly
(unless you shoot at them !), and some..... aren't, shall we say ? These
are generally to be avoided until you have upgraded your ship somewhat.

Like a lot. A visit to a very anarchic world will last about 10 seconds.
Seven of those are waiting for you to get in range :)

Beginning
---------
The game runs under ION. Load it, start it, you'll see the title screen.
Underneath is displayed the TCPA logo, the game difficulty level
(1 = Easy,5 = Normal,9 = Hard) and the version number.

You can press A to continue your old game, or C to start a new game.
To change the difficulty level press B. You can change the difficulty
level of games in progress.

If it's the first run it doesn't matter what you press, of course.

Docking
-------
You start your game coming out of warp, and arrive in the vicinity of
a peaceful (relatively !) local star. From here, you will head (hopefully)
towards the local docking point. Docking is automatic. When you dock, you
can trade, and upgrade your ship, and get your breath back.

Display
-------
Unless you have the map or the trading screen up, you can see the front
view. There are sights, for aiming with, an energy bar, a display of your
weaponry, and a scanner. If you score a hit, the whole information bar
line on the screen (the bottom 8 pixel lines) reverses.

Warping
-------
Warping is how you transfer between sectors. Pressing the C key (see later)
brings up the local galactic map, with your current sector highlighted. You
can warp to another sector by holding down the direction(s) you want to go
in, and press the A key, or you can use the C key to return to the front
view. The darker sectors on the map are the nastier ones. The number on the
right is the Anarchy level of the target sector.

This information is updated periodically via the Galactic Net. However,
there is no guarantee of it being up to date, due to the collapse of
government in the galaxy.

This (conveniently) can also be used as a "Pause" function. The game
stops stops when you are displaying the map. If you need to make a cup
of tea. Or do some work. Bear in mind that because this game doesn't use
the TIOS (spit!) it won't go into power down mode.

There's a catch however. If you "warp" (i.e. you use the A key), this will
cost you, in energy, about half the maximum energy of your ship. This is to
make a "warp rod". If you get it wrong, warping will start, but your ship
will explode on coming out of warp.

To make life easier, by agreement (about the only thing the local dons agree
on), all ships leaving dock are given one ready made warp rod. This doesn't
cost them much, because they have solar plants driven by the local rotating
black hole (why you can't see it). This doesn't explain why you have to pay
to get your energy back when you dock. Well, they have to make *some* money
don't they ?

Fighting
--------
Well, it happens, a fair bit, in fact. You have two forms of self defence
(three if you count an emergency warp i.e. running away). Lasers and
Missiles. Lasers have to be fired and aimed manually (and can be upgraded).
Missiles have to be fired manually, but home in on the nearest passing
ship. (You can't blow yourself up). The catch is (there always is one)
that missiles are rather expensive. And you can only have four of them.
Lasers are fired with A, and Missiles with B

You do get $$$ for blowing up the ships. Well $ anyway. Unless they're
the really hard ones.

Blowing up ships with missiles is vaguely satisfying. This is probably
down to me..... so I wouldn't come round my house on a dark night, put
it like that. The missiles are VERY effective. Like 100% effective.

One piece of luck ..... your new ship is equipped with 4 missiles. Don't
waste them !

Trading
-------
To get money you can trade in one of 8 items. You can buy and sell them
from the trading screen that appears when you dock. A buys the item
and B sells it (buying is subject to that item being available).

It is worthwhile noting that it is a good idea to sell things for more
than you paid for them. You get more money if you go somewhere nastier.
If you dare.

At the top of the trading screen is the sector ID and your $$$. At the bottom
is the equipment you can buy. This is, in increasing order of profit and/or
illegality. (Though because anarchy reigns, no-one cares except the guys
trying to get it off you)

This is what you can buy :-

        Food                    (looks like a chicken)
        Alcohol                 (bottle)
        Medical Supplies        (Box with red (black) cross)
        Electronics             (DIL IC Chip)
        Precious Stones         (Diamond)
        Prisoner Transport      (Bars)
        Weapons                 (Gun)
        Alien Spies             (Insect)

Each symbol is followed by two numbers. The first, right next to it is the
amount you hold of that item. The second is the cost of that item. If no
cost is displayed, that item cannot be traded here.

You have a limited cargo hold. Items come packed in Galactic Standard
Container sizes, so it doesn't matter what you have, you can still only
have so much cargo (currently 32 GSC spaces)

When you've finished trading press C to enter space. This places you a short
distance outside the space station, you can then warp, or you can, of course,
re-dock with the space station, though you might have to fight your way in.

Equipping
---------
You can buy four things ;  you can recharge your ships batteries
(fixed cost), missiles (fixed cost), buy upgraded lasers (depends
how much they are upgraded already) and buy upgraded shields (ditto).
You do this by selecting them using the arrow keys, and buying them,
like trading. These aren't cheap, but are requirements if you
want to go some place tough. Note, not advisable, they are requirements.

Other Stuff that I'm thinking about
-----------------------------------
Alternate galaxies.
Missions to complete.
Going to bed.

Being Blown Up
--------------
You can't lose in this game. The bad news is that if you are blown
up, you get half your gold nicked when you are picked up in your
escape capsule. The good news is that the insurance gets you a new
ship. Of course, insurance being what it is it won't be as good
as the old one, it'll be downgraded slightly.

Getting Out
-----------
To get out, (in space), press the A key then the C key. You will return
to ION. Your game is automatically saved.

Keys
----
Can't find A,B and C ? They are actually 2nd, Mode and Delete
respectively. Not only do I write comments in my code, I abstract
a fair bit of the I/O as well, and I don't use the ruddy TIOS.
One of the routines abstracts the keyboard I/O to three keys
and the arrow keys. That's why all my games use 2nd/Mode/Del.

Bugs
----
If you find something, or you have any suggestions, mail me, or
Konstantin if you prefer.

Paul Robson             (autismuk@aol.com)
Konstantin Beliakov     (zkostik@hotmail.com)
May/June/July 2001

v1.1 Released 12-Jun-01
=======================
- First version released to ticalc.org

v1.2 Released 13-Jun-01
=======================
- Trading screen keys operate quicker                           (Dock.Z80)
- Rearranged files so all data at the end                       (Boot.Z80)
- Reduced Energy Loss when firing slightly                      (Data.Z80)
- Spent a lot of time trying to track the TI83+ Crashing bug.
  It seems to have disappeared. I don't know why :(

v1.3 Released 14-Jun-01
=======================
- Hadn't fixed TI83+ bug. Was due to enemy lasers being drawn   (Draw.Z80)
  off ship space when at the bottom of the display. A very
  dumb programming error. Fixed now.

v1.4 Released 11-Jul-01
=======================
- Changed title screen and added version number, TCPA logo      (Main.Z80)
- Increased range of lasers ; DanE reported that you could      (Ship.Z80)
  be fired on by ships but not fire back... a bit hard, that.
- Changed tile missile graphic                                  (Tiles.Org)
- As a response to Dan E's comment that it is too hard, and
  he's right, did the following changes....

        - Changed Anarchy Increases per warp from 6 to 4        (Warp.Z80)
        - Changed no of ship groups, reduced by one             (Player.Z80)
        - Reduced number of ships in each group by 33%          (Ship.Z80)
        - Reduced the energy of all ships by about 25%          (Registry.Z80)
        - Made aggressive ship groups slightly less likely      (Ship.Z80)
        - Made Lasers and Shields less expensive                (Data.Z80)
        - Increased Hold size                                   (Data.Z80)
        - Decreased energy loss when firing                     (Data.Z80)

- Added difficulty display and changing to main screen          (Main.Z80)
  It scales the following (higher = harder)
        - The number of groups that you will encounter          (Player.Z80)
        - The number of ships in a group                        (Ship.Z80)
        - The damage done when you are fired on                 (Ship.Z80)
        - The initial energy of a bad guy ship                  (Registry.Z80)
- Function MAINScale added to MAIN.Z80 for this purpose.        (Main.Z80)
  this scales everything by ((Diff-5)*16+128)/128 i.e.
  from half to double difficulty.

