Replication

With Replication a server states what has changed about the units a client can see: for each unit, the groups of values it carries and which values of each follow. What the values are follows from the unit.

In 3.10–3.15

The groups follow in the order 0, 1, 2, 3, 5 and then 4: group 4 comes last, each behind the length of its run. A sending end MUST write each group’s length as the number of bytes its run takes.

Each value takes one of two shapes, and the table row naming it says which. Nothing on the wire carries a table, a field name, a width or a shape, so an end that does not already hold the table cannot read a run.

A value that counts is a thirty two bit unsigned integer, and a value with a sign travels as the same thirty two bits. It takes seven bits from each byte, lowest seven first, and the top bit of a byte is set while another byte follows. Five bytes therefore carry anything it holds.

A value that measures takes one of three forms: a single byte of 255 meaning zero; a byte of 254 followed by four bytes; or four bytes on their own. The four bytes are the measure itself, a thirty two bit float, lowest byte first. A sending end MUST write the byte of 254 before a measure whose lowest byte is 254 or 255, and MUST NOT write it before any other. A measure written plain therefore never begins with either, so its first byte says which form it takes.

What settles a reading

A run is a sequence of values with nothing between them, in the order the set bits name them, lowest first.

The bit that names a value means different things for different units. Champions, turrets, minions and units belonging to no side, and buildings each answer to a table of their own, so the same bit in the same group is one value on one unit and another on the next. A sending end MUST write the table the unit it names answers to.

Props answer to a table of their own as well.

Which table a unit answers to follows from the message that put it on the field (see Units). A building, which no message creates, answers to the building table.

In 3.01–3.10

The building table is the same on every map.

Which batches a client takes

A client answers a batch with TransientAck where it holds every unit the batch names, whether or not it took the values. Ordering says which batches a client takes, and what that requires of a server.

Reading the tables

Each row gives the group and bits that name a value and what the value is.

In 3.10–3.15

Each row also gives the shape a sending end writes the value in.

In 3.10

A champion

Group Bits Value Shape

0 0 Gold in hand measured

0 1 Gold earned in all measured

0 2 to 3 Which of the champion’s slots can be cast from, as a set of bits over two words counted

0 4 Points held for evolving a spell counted

0 5 Which spells have evolved, as a set of bits counted

0 6 to 25 What the spell in one slot costs, slots 0 to 3 first measured

1 0 to 3 What the champion is doing, and whether it is proof against spells, all harm and strikes counted

1 4 Damage it deals by striking measured

1 5 Damage its spells deal before modifiers measured

1 6 How often it turns a blow aside measured

1 7 How often it strikes critically measured

1 8 Armour measured

1 9 Spell resistance measured

1 10 to 11 How fast health and resource return measured

1 12 How far it strikes from measured

1 13 to 16 Flat and percent modifiers on the damage it strikes with, then on its spells’ damage measured

1 17 to 18 Flat and percent reduction of the spell damage it takes measured

1 19 A multiplier on how fast it strikes measured

1 20 A flat addition to how far from the champion an aimed spell’s point is allowed to land measured

1 21 A modifier on its cooldowns measured

1 22 When its passive’s cooldown ends, as a moment on the match clock measured

1 23 How long its passive’s cooldown lasts in all measured

1 24 to 25 How much armour it cuts through, flat then as the share left standing measured

1 26 to 27 How much spell resistance it cuts through, flat then as the share left standing measured

1 28 Life steal measured

1 29 Spell vamp measured

1 30 Crowd-control reduction measured

3 0 to 1 Health and resource as they stand measured

3 2 to 3 Health and resource at their greatest measured

3 4 Experience measured

3 5 to 9 Lifetime, and how far the champion sees measured

3 10 How fast it moves measured

3 11 to 12 Its size, and how wide a path it needs measured

3 13 Level counted

3 14 to 16 Kills taken from no side, and whether anything is allowed to aim at it counted

A turret

Group Bits Value Shape

1 0 to 1 Health as it stands, then at its greatest measured

1 2 to 5 What the turret is doing, and whether it is proof against spells, all harm and strikes counted

1 6 Damage it deals by striking measured

1 7 to 8 Armour and spell resistance measured

1 9 A multiplier on how fast it strikes measured

1 10 to 13 Flat and percent modifiers on the damage it strikes with, then on its spells’ damage measured

1 14 How fast health returns measured

3 0 to 1 How far it sees measured

3 2 How fast it moves measured

3 3 Its size measured

5 0 to 1 Whether anything is allowed to aim at it, and which side is counted

A minion, and a unit belonging to no side

Both answer to one table.

Group Bits Value Shape

1 0 to 1 Health as it stands, then at its greatest measured

1 2 to 4 How long it lives, as it stands and at its greatest, and the count of that measured

1 5 to 6 Resource at its greatest, then as it stands measured

1 7 to 10 What the unit is doing, and whether it is proof against spells, all harm and strikes counted

1 11 Damage it deals by striking measured

1 12 to 13 Armour and spell resistance measured

1 14 A multiplier on how fast it strikes measured

1 15 to 18 Flat and percent modifiers on the damage it strikes with, then on its spells’ damage measured

1 19 to 20 How fast health and resource return measured

1 21 A value whose meaning is not recorded measured

1 22 to 23 Flat and percent reduction of the spell damage it takes measured

3 0 to 1 How far it sees measured

3 2 How fast it moves measured

3 3 Its size measured

3 4 to 5 Whether anything is allowed to aim at it, and which side is counted

For some units the two resource values travel as group 3 bits 0 and 1 instead: the rest of group 1 moves down two bits and the rest of group 3 up two. Which units do is not recorded.

A building

Group Bits Value Shape

1 0 Health as it stands measured

1 1 Whether the building is proof against harm counted

5 0 to 1 Whether anything is allowed to aim at it, and which side is counted

A prop

A server need not replicate a prop’s values. Where it does, they follow the table below.

Group Bits Value Shape

1 0 to 1 Health as it stands, then at its greatest measured

1 2 Whether the prop is proof against harm counted

3 0 to 1 How far it sees measured

3 2 How fast it moves measured

3 3 Its size measured

3 4 to 5 Whether anything is allowed to aim at it, and which side is counted

Group	Bits	Value	Shape
0	0	Gold in hand	measured
0	1	Gold earned in all	measured
0	2 to 3	Which of the champion’s slots can be cast from, as a set of bits over two words	counted
0	4	Points held for evolving a spell	counted
0	5	Which spells have evolved, as a set of bits	counted
0	6 to 25	What the spell in one slot costs, slots 0 to 3 first	measured
1	0 to 3	What the champion is doing, and whether it is proof against spells, all harm and strikes	counted
1	4	Damage it deals by striking	measured
1	5	Damage its spells deal before modifiers	measured
1	6	How often it turns a blow aside	measured
1	7	How often it strikes critically	measured
1	8	Armour	measured
1	9	Spell resistance	measured
1	10 to 11	How fast health and resource return	measured
1	12	How far it strikes from	measured
1	13 to 16	Flat and percent modifiers on the damage it strikes with, then on its spells’ damage	measured
1	17 to 18	Flat and percent reduction of the spell damage it takes	measured
1	19	A multiplier on how fast it strikes	measured
1	20	A flat addition to how far from the champion an aimed spell’s point is allowed to land	measured
1	21	A modifier on its cooldowns	measured
1	22	When its passive’s cooldown ends, as a moment on the match clock	measured
1	23	How long its passive’s cooldown lasts in all	measured
1	24 to 25	How much armour it cuts through, flat then as the share left standing	measured
1	26 to 27	How much spell resistance it cuts through, flat then as the share left standing	measured
1	28	Life steal	measured
1	29	Spell vamp	measured
1	30	Crowd-control reduction	measured
3	0 to 1	Health and resource as they stand	measured
3	2 to 3	Health and resource at their greatest	measured
3	4	Experience	measured
3	5 to 9	Lifetime, and how far the champion sees	measured
3	10	How fast it moves	measured
3	11 to 12	Its size, and how wide a path it needs	measured
3	13	Level	counted
3	14 to 16	Kills taken from no side, and whether anything is allowed to aim at it	counted

Group	Bits	Value	Shape
1	0 to 1	Health as it stands, then at its greatest	measured
1	2 to 5	What the turret is doing, and whether it is proof against spells, all harm and strikes	counted
1	6	Damage it deals by striking	measured
1	7 to 8	Armour and spell resistance	measured
1	9	A multiplier on how fast it strikes	measured
1	10 to 13	Flat and percent modifiers on the damage it strikes with, then on its spells’ damage	measured
1	14	How fast health returns	measured
3	0 to 1	How far it sees	measured
3	2	How fast it moves	measured
3	3	Its size	measured
5	0 to 1	Whether anything is allowed to aim at it, and which side is	counted

Group	Bits	Value	Shape
1	0 to 1	Health as it stands, then at its greatest	measured
1	2 to 4	How long it lives, as it stands and at its greatest, and the count of that	measured
1	5 to 6	Resource at its greatest, then as it stands	measured
1	7 to 10	What the unit is doing, and whether it is proof against spells, all harm and strikes	counted
1	11	Damage it deals by striking	measured
1	12 to 13	Armour and spell resistance	measured
1	14	A multiplier on how fast it strikes	measured
1	15 to 18	Flat and percent modifiers on the damage it strikes with, then on its spells’ damage	measured
1	19 to 20	How fast health and resource return	measured
1	21	A value whose meaning is not recorded	measured
1	22 to 23	Flat and percent reduction of the spell damage it takes	measured
3	0 to 1	How far it sees	measured
3	2	How fast it moves	measured
3	3	Its size	measured
3	4 to 5	Whether anything is allowed to aim at it, and which side is	counted

Group	Bits	Value	Shape
1	0	Health as it stands	measured
1	1	Whether the building is proof against harm	counted
5	0 to 1	Whether anything is allowed to aim at it, and which side is	counted

Group	Bits	Value	Shape
1	0 to 1	Health as it stands, then at its greatest	measured
1	2	Whether the prop is proof against harm	counted
3	0 to 1	How far it sees	measured
3	2	How fast it moves	measured
3	3	Its size	measured
3	4 to 5	Whether anything is allowed to aim at it, and which side is	counted

Values stated outside a batch

Besides its batches, a server states some values with messages of their own.

In 3.10–3.15

A server grants experience with ExperienceGained and gold with GoldGained.

A server can send the gold a unit earns to another with GoldRedirect. A level gained is LevelUp, which on its own is enough for a client to show the new level on its champion’s portrait. A server sets a champion’s tallies for the scoreboard with ChampionStats. A server can also add to a unit’s shield (ShieldAdded), change how its health bar or resource bar is shown (HealthBar, ResourceDisplay), change the sort of resource it has (ResourceKindChanged), set the highest level a champion reaches (LevelCap), and count minions killed, scores and deeds (MinionKillCount, ScoreAdded, StatisticIncremented).

Messages

Each message of this system in this book, with each layout it has across the book’s patches and every note its definition carries. A layout is the message’s body, after the header its channel’s family puts in front (see Messages).

`Replication`

What a server sends to say what has changed about units a client can see. It is the most frequent thing a server sends. The header names no object: a server writes zero.

Field	Type	What it is
unit	u32	The unit granted it.
source	u32	What it came from, or zero where nothing did.
amount	f32	How much.

Field	Type	What it is
unit	u32	The unit granted it.
amount	f32	How much.

Field	Type	What it is
unit	u32	The unit granted it.
amount	f32	How much.

Field	Type	What it is
level	u8	The level now reached.
pointsToSpend	u8	How many spell points are left unspent.

Keyboard shortcuts

Trueshot Season 3