Elite on the BBC Micro

# Twisting the system seeds

## How the system seeds are twisted to produce entire galaxies of stars

Data on each star system in Elite's galaxies is generated procedurally, and the core of this process is the set of three 16-bit seeds that describe each system in the universe. Each of the eight galaxies in the game is generated in the same way, by taking an initial set of seeds and "twisting" them to generate 256 systems, one after the other.

Specifically, given the initial set of seeds, we can generate the next system in the sequence by twisting that system's seeds four times. As we do these twists, we can extract the system's data from the seed values - including the system name, which is generated by the subroutine cpl, where you can read about how this aspect works.

It is therefore no exaggeration that the twisting process implemented in the TT20 and TT54 routines is the fundamental building block of Elite's "universe in a bottle" approach, which enabled the authors to squeeze eight galaxies of 256 planets out of nothing more than three initial numbers and a short twisting routine (and they could have had far larger galaxies and many more of them, if they had wanted, but they made the wise decision to limit the number). Let's look at how this twisting process works.

The three seeds that describe a system represent three consecutive numbers in a Tribonacci sequence, where each number is equal to the sum of the preceding three numbers (the name is a play on Fibonacci sequence, in which each number is equal to the sum of the preceding two numbers). Twisting is the process of moving along the sequence by one place. So, say our seeds currently point to these numbers in the sequence:

```  0   0   1   1   2   4   7   13   24   44   ...
^   ^    ^
```

so they are 4, 7 and 13, then twisting would move them all along by one place, like this:

```  0   0   1   1   2   4   7   13   24   44   ...
^    ^    ^
```

giving us 7, 13 and 24. To generalise this, if we start with seeds s0, s1 and s2 and we want to work out their new values after we perform a twist (let's call the new values s0Â´, s1Â´ and s2Â´), then:

```  s0Â´ = s1
s1Â´ = s2
s2Â´ = s0 + s1 + s2
```

So given an existing set of seeds in s0, s1 and s2, we can get the new values s0Â´, s1Â´ and s2Â´ simply by doing the above sums. And if we want to do the above in-place without creating three new wÂ´ variables, then we can do the following:

```  tmp = s0 + s1
s0 = s1
s1 = s2
s2 = tmp + s1
```

In Elite, the numbers we're dealing with are two-byte, 16-bit numbers, and because these 16-bit numbers can only hold values up to 65535, the sequence wraps around at the end. But the maths is the same, it just has to be done on 16-bit numbers, one byte at a time.

The seeds are stored as little-endian 16-bit numbers, so the low (least significant) byte is first, followed by the high (most significant) byte. Taking the case of the currently selected system, whose seeds are stored in the six bytes from QQ15, that means our seed values are stored like this:

```      low byte  high byte
s0  QQ15      QQ15+1
s1  QQ15+2    QQ15+3
s2  QQ15+4    QQ15+5
```

If we denote the low byte of s0 as s0_lo and the high byte as s0_hi, then the twist operation above can be rewritten for 16-bit values like this, assuming the additions include the C flag:

```  tmp_lo = s0_lo + s1_lo          (tmp = s0 + s1)
tmp_hi = s0_hi + s1_hi
s0_lo  = s1_lo                  (s0 = s1)
s0_hi  = s1_hi
s1_lo  = s2_lo                  (s1 = s2)
s1_hi  = s2_hi
s2_lo  = tmp_lo + s1_lo         (s2 = tmp + s1)
s2_hi  = tmp_hi + s1_hi
```

And that's exactly what the TT20 and TT54 routines do to twist our three 16-bit seeds to the next values in the sequence, using X to store tmp_lo and Y to store tmp_hi.

## Twisting the galaxy seeds -------------------------

The Ghy routine updates the galaxy seeds to point to the next galaxy. Using a galactic hyperdrive rotates each seed byte to the left, rolling each byte left within itself like this:

```  01234567 -> 12345670
```

to get the seeds for the next galaxy. So after 8 galactic jumps, the seeds roll round to those of the first galaxy again.