empserver/info/Trade-ships.t
Markus Armbruster 48e656c057 autonav: Remove the feature
The autonavigation feature has issues:

* Autonavigation orders are executed at the update.  Crafty players
  can use them to get around the update window.

* Usability is poor:

  - The order command is overly complex, not least because it can do
    five different things: clear, suspend, resume, declare route, set
    cargo levels.

  - Unlike every other command involving movement, order does not let
    you specify routes, only destination sectors.

  - Setting cargo levels can silently swap start and end point of a
    circular route, because "this keeps the load_it() procedure
    happy".  Maybe it does, but it surely keeps players confused.

  - Setting "start" cargo levels actually sets the "end" levels, and
    vice versa.  Has always been broken that way.

  - Predicting what exactly autonavigation will do at the update isn't
    easy.

* The info pages documenting it amount to almost 400 non-blank lines
  formatted.  They claim only merchant ships can be given orders.
  This is wrong.  Unlikely to be the only error.

* Few players use it, and its workings at the update a fairly opaque.
  Makes it a nice hidey-hole for bugs.  Here are two:

  - Unlike the scuttle command, autonavigation happily scuttles trade
    ships while they're on the trading block.

  - Unlike the load command, autonavigation can load in friendly and
    allied sectors.

* It's more than 700 lines of rather crufty code nobody wants to
  touch.  Thanks to a big effort in Empire 2, it shares code with the
  navigation command.  It still duplicates load code.  The sharing
  complicates fixing the bugs demonstrated by navi-march-test.

Reviewing, fixing and testing this mess isn't worth the opportunity
cost.  Remove it instead.  Drop commands order, qorder and sorder.
Drop ship selectors xstart, xend, ystart, yend, cargostart, cargoend,
amtstart, amtend, autonav.

xdump ship sheds almost half its columns.  struct shpstr shrinks, on
my system from 200 to 160 bytes.

Signed-off-by: Markus Armbruster <armbru@pond.sub.org>
2015-02-28 16:10:22 +01:00

75 lines
3.2 KiB
Perl

.TH Concept "Trade ships"
.NA Trade-ships "How to use trade ships"
.LV Basic
Trade ships are special ships, with a different function than most Empire
ships. They are in the game only if the deity enabled them.
.s1
Trade ships simulate internal or external trade. In the real world, countries
make goods that they can make cheaply, ship them somewhere they're expensive,
and sell them, making a profit.
.s1
In the empire version, you make a trade ship, using lots of cm's, and costing
$2500. You then sail it to a harbor somewhere and scuttle it. You then receive
money, with a varying rate of return.
.s1
The trade ship MUST be scuttled in a friendly harbor that is at least
2% efficient to make money. (In other sectors,
it sinks quietly, like most ships) You may scuttle it in either a harbor you
own, or the harbor of an ally. Pirates who capture a trade ship may also gain
money from it, just as if they were the lawful owner (although the news knows
the difference)
.s1
The return rate is based on the straight-line map distance from the harbor
where the trade ship was built to the harbor where it is scuttled.
.s1
You have to sail it at least 8 sectors to get any money at all. At less than
8 sectors, you get nothing, not even your $1750 back. Nothing, nada, zilch,
zip, nothing. Once you make a trade-ship, you're pretty much committed to
sailing it at least 8 sectors...
Currently, the return rates are:
.NF
Distance sailed Return rate
0-7 NO MONEY
8-13 2.5% * distance
14-24 3.5% * distance
25+ 5.0% * distance
.FI
.s1
For example, if you sail the ship 10 sectors from the harbor where it was
built and scuttle it in a harbor there, you would get 125% of the money you
paid for it, or $2188. If you sailed it 15 sectors to a harbor and scuttled it,
you would get 153%, or $2678.
.s1
Use the \*Qpayoff\*U command to see how much the trade ship would pay
were it scuttled in a harbour at its present location.
.s1
If you scuttle a trade ship in the harbor you do not own, you get a 20% bonus
(applied after the value is multiplied by the return rate above), AND the
person owning the harbor gets 10% of the cash you make as a bonus (the amount
before the +20% bonus is applied)
You still get the full amount, but he makes money as well.
(Peaceful trade enriches BOTH countries more than trading only internally).
For the devious, no, being allied with yourself does not mean you get +20% when
scuttling in your own harbors.
.s1
For example, using the #'s from above, if you sailed 15 sectors, and scuttled
in an allied harbor, you'd get $2188 * 1.2 = $2.6K, and your ally would get
$2188/10 = $218.
.s1
CASH GAINED IS ALSO MULTIPLIED BY THE EFFICIENCY OF THE TRADE SHIP.
So, if you get shot down to 21%, don't expect to get the full amount...
.s1
If you capture a trade ship, you are free to scuttle it in any harbor you can
get it into, receiving full cash calculated normally.
.s1
The cash return is multiplied by the efficiency of the ship, so less efficient
ships produce less money.
.s1
Captured trade ships may be scuttled as if they were yours (although you will
get some bad publicity in the news) Payoff is still based on the distance from
the harbor where the trade ship was built, not the sector in which it was
captured.
.s1
.SA "payoff, Ship-types, scuttle, Ships"