empserver/info/Update-sequence.t
Markus Armbruster c5df505c98 update: Reorder unit building and maintenance for fairness
The update visits ships, planes and land units in increasing order of
country number.  Within a country, it visits first ships, then planes,
then land units, each in increasing order of unit number.

The order is relevant when money, materials and work don't suffice to
build everything.

Money is charged to the owner, so only the relative order for the same
owner matters there.  One order is as good as any.

Work and materials come from the sector, so only the relative order in
each sector matters.  The current order unfairly prefers countries
with lower country numbers.  Mitigating factor: the affected countries
need to be friendly (ships only) or allied.

The unfairness goes back to Chainsaw's option BUDGET.  See the commit
before previous for more detailed historical notes.

The update test demonstrates the unfair behavior: sector 14,6 builds
ships 95/97 owned by country#1, but not 96 owned by country#7.
Likewise, planes 95/96/97 and land units 95/96/97.

Go back to the the pre-BUDGET order: first ships, then planes, then
land units, all in increasing order of unit number, regardless of
owner.

The update test now builds ship, plane and land unit 96 instead of 97.

Bonus: speeds up both the update and budget by a similar absolute
amount.  For budget, this is roughly a factor of two in my testing.
For the update, which does much more, it's around 10%.

Signed-off-by: Markus Armbruster <armbru@pond.sub.org>
2017-08-06 20:08:31 +02:00

77 lines
2.9 KiB
Perl

.TH Concept Update-sequence
.NA Update-sequence "The order of events at the update"
.LV Expert
.s1
This document gives a rough order of events during the update.
.s1
.nf
1) Prepare
a) prepare all sectors
a) fallout is checked, if FALLOUT is defined
b) guerrilla warfare is checked
c) if the sector doesn't have the plague, see if it
catches it
otherwise plague the people
d) if there are no civs or mil in the sector, it
reverts to the deity
e) taxes are collected from civs & uws; mil are paid.
f) if the sector is a bank it makes $$ proportional to
its efficiency
b) prepare all ships
a) pay military on board
c) prepare all planes
a) pay crew
d) prepare all land units
a) pay military on board
e) pay for military reserves.
2) Produce
a) ship maintenance, in order of ship number
pay maintenance, then feed and plague people on board
b) plane maintenance, in order of plane number
c) land unit maintenance, in order of land unit number
pay maintenance, then feed and plague people on board
d) sectors, in order of country number
a) people in non-sanctuary sectors eat
If not enough is available, the excess people will
starve off. No more than 50% of the people
in a sector can die; the uw's die first, then
the civs, then the mil.
b) if there was starvation, the work percentage is set
to 0, otherwise the work rate rises by
8+(1-15), max of 100
c) population grows and is truncated
d) pay sector maintenance
e) sectors that are stopped are skipped (see info stop)
f) first increase eff
g) then make things
d) ship building, in order of ship number
first increase efficiency, then produce
stopped ships are started, but not built (see info stop)
e) plane building, in order of plane number
stopped planes are started, but not built (see info stop)
f) land unit building, in order of land unit number
stopped land units are started, but not built (see info stop)
3) Then, do deliveries for all sectors in the world, row by row, going from
top to bottom, left to right
4) Then, do exporting via distribution for all sectors in the world, row by
row, going from top to bottom, left to right
5) Then, do importing via distribution for all sectors in the world, row by
row, going from top to bottom, left to right
Also start sectors that are stopped
6) modify tech/res/hap/edu levels & do tech bleed
7) decrease levels due to passing of time
8) update war declarations (for slow war)
9) If MOB_ACCESS is not enabled, mobility is updated as follows:
a) Add mobility to ships
b) Add mobility to sectors
c) Add mobility to planes
d) Add mobility to land units
.fi
.s1
.SA "Innards, Updates"