Movement
A unit is moved by a path: a run of points on the ground plane, the first of which is where the unit is and the last where it is going.
Coordinates
A path names one axis of the ground plane and then the other. The height of a point is not carried, and a receiving end takes it from the ground beneath.
In 1.0.0.25–1.0.0.80
A path carries each point as two world floats (see Space), stated against no origin and no other point.
In 1.0.0.96–1.0.0.129
MovementandMovementAtSpeedare compact: a path is a run of integer points, each stated against the one before it, while positions elsewhere are world floats covering a far larger range (see Space). The two are related by an origin and a step:encoded = truncate_toward_zero((world - origin) / 2) world = origin + 2 * encodedA path resolves a position to two world units, rounded toward the origin.
Other shapes
MovementAtSpeed carries the same points as Movement with the terms of the
travel stated before them, and WaypointGroupAtSpeed is what carries it. Other
messages carry their points as world floats, and their definitions say so. The
message carrying a movement says which shape it holds.
A unit coming into sight while standing carries its place and facing in
EnterSight instead.
Resolving a path
In 1.0.0.96–1.0.0.129
A path is read into points by taking the first as it stands and then, for each point after it, taking each coordinate either as it stands or by adding the step to the coordinate of the point before. The point before means as that point resolved, not what the wire carried for it, which matters wherever a coordinate stated afresh is followed by one stated as a step.
conformance/vectors/algorithm records the resolution of the paths the
movement vectors carry. They give decoded fields and the points they resolve
to.
What a group can carry
A sending end MUST NOT send a movement with no points; a receiving end refuses it.
A client reads nothing after a refused movement in its group, and still answers the group.
In 1.0.0.96–1.0.0.129
A client does not read the points of a movement whose unit it does not hold, and so misreads every later movement in the group. A server MUST name in a group only units the client holds.
The origin
In 1.0.0.25–1.0.0.60
A server needs no origin.
In 1.0.0.96–1.0.0.129
The origin is the midpoint of the bounds a map’s navigation data covers, truncated to a whole number on each axis. Nothing on the wire carries it. Both ends hold it before a match begins, and an end holding a different one misplaces every position it reads.
A server MUST take the origin from the map it is hosting. A server MUST NOT derive the origin from anything a client sent.
Space gives the origin of each map, keyed by the map number a server sends in
VersionSync. A server hosting a map the table leaves out takes its origin from that map’s navigation data.
Relocating rather than walking
In 1.0.0.25–1.0.0.60
A path carries no flag and no token, so nothing relocates a unit: every path is walked.
In 1.0.0.79–1.0.0.129
A client answers each group with one
WaypointAck, listing every unit in it that carried a token, with an empty list where none did. A server MAY ignore it.
In 1.0.0.96–1.0.0.129
A movement whose flag says so carries a token beside the unit (see
Movement). A receiving end remembers one token for each unit, beginning at zero.A token unlike the remembered one puts the unit where the path begins rather than walking it there, but only where the unit is far enough away to warrant it: either ground axis differing by more than fifty world units, taken on its own. Fifty exactly does not, and height is not weighed.
A token the receiving end already holds changes nothing, and neither does an unfamiliar one arriving while the unit is near enough. In both the path is followed and the remembered token kept, so a token is taken up only once it has moved something.
A client leaves the flag clear in what it sends, so a token travels only from a server.
What a client asks for and what a server answers
An order from a client is a request: what a unit does is whatever the server sends back.
A client does not move its own champion on a right click by itself: the champion moves only along a path a server sends.
In 1.0.0.25–1.0.0.62
An order carries no path: only its destination, in world floats. A server works out the route itself and sends it in the path that answers the order.
A server moves the champion by answering the MoveOrder with a
WaypointGroup, and the client returns that group’s syncId in a
WaypointAck (see Ordering).
In 1.0.0.25–1.0.0.126
A client takes a
WaypointGroupor aWaypointGroupAtSpeedon channels 2, 3 and 4 alike.
In 1.0.0.25–1.0.0.60
A client sends the
WaypointAckbefore reading any movement in the group, and lists no units in it.
In 1.0.0.96–1.0.0.129
A client sends the path it would take, with its destination beside it in world floats. A
WaypointGroupcarrying that path back unchanged moves the champion along it.
Marking the ground
NavigationFlags marks the ground within circles.
In 1.0.0.126
A server MAY send
NavigationFlags. A client replaces the circles it holds with those it carries, and answers with itssyncId.
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).
WaypointGroupAtSpeed
What a server sends to move units along paths of its own choosing, stating how each one travels rather than leaving it to the receiving end. It is what carries a unit thrown, dragged, or carried along by something other than its own walking. The header names no object: it carries zero.
In 1.0.0.25–1.0.0.57
Command 122 on events, sent by the server, reliable.
A client answers each with WaypointAck, naming this sync id alone, before it reads any movement and whatever movementCount is.
| Field | Type | What it is |
|---|---|---|
| syncId | u32 | Names this statement of movement. |
| movementCount | u16 | How many units follow. A client reads it as signed, so a count above 32767 counts as none, as zero does. |
| movements | count in movementCount × MovementAtSpeed | What each unit is told to do. |
Vectors (1)
In 1.0.0.58–1.0.0.60
Command 122 on events, sent by the server, reliable.
A client answers each with WaypointAck, naming this sync id, before it reads any path.
| Field | Type | What it is |
|---|---|---|
| syncId | u32 | Names this statement of movement. |
| movementCount | u16 | How many units follow. A client reads it as signed, so a count above 32767 counts as none, as zero does. |
| movements | count in movementCount × MovementAtSpeed | What each unit is told to do. |
Vectors (1)
In 1.0.0.61–1.0.0.127
Carried on events, sent by the server, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.61–1.0.0.62 | 122 |
| 1.0.0.63–1.0.0.73 | 125 |
| 1.0.0.74–1.0.0.80 | 126 |
| 1.0.0.81 | 126 |
| 1.0.0.82 | 130 |
| 1.0.0.83–1.0.0.96 | 130 |
| 1.0.0.97–1.0.0.102 | 131 |
| 1.0.0.103–1.0.0.106 | 133 |
| 1.0.0.107–1.0.0.108 | 134 |
| 1.0.0.109 | 135 |
| 1.0.0.110–1.0.0.116 | 98 |
| 1.0.0.117–1.0.0.118 | 99 |
| 1.0.0.119–1.0.0.123 | 100 |
| 1.0.0.124–1.0.0.127 | 103 |
A client answers each with WaypointAck, naming this sync id and listing, in order, each unit whose path carried a teleport token with that token.
| Field | Type | What it is |
|---|---|---|
| syncId | u32 | Names this statement of movement. |
| movementCount | u16 | How many units follow. A client reads it as signed, so a count above 32767 counts as none, as zero does. |
| movements | count in movementCount × MovementAtSpeed | What each unit is told to do. |
Vectors (17)
one-on-1-0-0-61, one-on-1-0-0-72, one-on-1-0-0-75, one-on-1-0-0-79, one-on-1-0-0-81, one-on-1-0-0-82, one-on-1-0-0-96, one-on-1-0-0-99, one-on-1-0-0-106, one-on-1-0-0-107, one-on-1-0-0-108, one-on-1-0-0-109, one-on-1-0-0-110, one-on-1-0-0-116, one-on-1-0-0-117, one-on-1-0-0-123, a-dash-on-1-0-0-126
In 1.0.0.128–1.0.0.129
Command 103 on events, sent by the server, reliable.
| Field | Type | What it is |
|---|---|---|
| syncId | u32 | Names this statement of movement. |
| movementCount | u16 | How many units follow. A client reads it as signed, so a count above 32767 carries none. |
| movements | count in movementCount × MovementAtSpeed | What each unit is told to do. |
WaypointAck
What a client sends once it has taken in a group of movements, naming which group. The header names no object: it carries zero.
In 1.0.0.25–1.0.0.62
Command 120 on requests, sent by the client, unsequenced.
What a client sends for every WaypointGroup it takes, and for every WaypointGroupAtSpeed, Path and PathWithSpeed, as it takes it and before it moves any unit. The header names no object: it carries zero.
| Field | Type | What it is |
|---|---|---|
| syncId | u32 | The number of the group it answers, as the group named itself. |
Vectors (1)
In 1.0.0.63–1.0.0.78
Carried on requests, sent by the client, unsequenced, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.63–1.0.0.73 | 123 |
| 1.0.0.74–1.0.0.78 | 124 |
What a client sends for every WaypointGroup it takes, and for every WaypointGroupAtSpeed, as it takes it and before it moves any unit. The header names no object: it carries zero.
| Field | Type | What it is |
|---|---|---|
| syncId | u32 | The number of the group it answers, as the group named itself. |
Vectors (2)
In 1.0.0.79–1.0.0.127
Carried on requests, sent by the client, unsequenced, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.79–1.0.0.81 | 124 |
| 1.0.0.82–1.0.0.96 | 128 |
| 1.0.0.97–1.0.0.102 | 129 |
| 1.0.0.103–1.0.0.106 | 131 |
| 1.0.0.107–1.0.0.108 | 132 |
| 1.0.0.109 | 133 |
| 1.0.0.110 | 115 |
| 1.0.0.111–1.0.0.116 | 116 |
| 1.0.0.117–1.0.0.118 | 117 |
| 1.0.0.119–1.0.0.123 | 118 |
| 1.0.0.124–1.0.0.127 | 122 |
What a client sends for every WaypointGroup it takes, and for every WaypointGroupAtSpeed. The header names no object: it carries zero. It lists the units the group asked it to relocate.
| Field | Type | What it is |
|---|---|---|
| syncId | u32 | The number of the group it answers, as the group named itself. |
| relocationCount | u8 | How many relocations follow: answering a group, how many of its paths carried a teleport token. Answering a path for one unit, a client sends only syncId and this byte, unwritten, on the transient channel, and no relocations, so a server reads nothing in it there. |
| relocations | count in relocationCount × record | Each of those, in the group’s order. |
| relocations[].unit | u32 | The unit the token belonged to. |
| relocations[].token | u8 | The token that arrived with it. |
In 1.0.0.128–1.0.0.129
Command 122 on requests, sent by the client, unsequenced.
It lists the units the group asked it to relocate.
| Field | Type | What it is |
|---|---|---|
| syncId | u32 | Which group is being acknowledged, as the group named itself. |
| relocationCount | u8 | How many relocations follow. Answering WaypointGroup a client counts them; answering a path for one unit it sends only syncId and this byte, unwritten, on the transient channel, and no relocations, so a server reads nothing in it there. |
| relocations | count in relocationCount × record | |
| relocations[].unit | u32 | The unit the token belonged to. |
| relocations[].token | u8 | The token that arrived with it. |
MoveOrder
What a client sends to tell a server what it wants a unit to do. The header names the sender’s champion.
In 1.0.0.25–1.0.0.62
Command 20 on requests, sent by the client, reliable.
What a client sends as its player gives an order. It carries no path. The header names the unit ordered: the player’s champion, or a unit it controls alongside, which gets its own copy of the order.
| Field | Type | What it is |
|---|---|---|
| kind | u8 | What the order is. Values: 2 moveToPosition, 3 attack, 10 stop. |
| targetX | f32 | Where the order points, along one ground axis, in world units. |
| targetY | f32 | The height of the place ordered. |
| targetZ | f32 | Where the order points, along the other ground axis. |
| target | u32 | The network object the order is aimed at, or zero where it is aimed at open ground. |
Vectors (1)
In 1.0.0.63–1.0.0.78
Command 20 on requests, sent by the client, reliable.
What a client sends as its player gives an order. The header names the unit ordered: the player’s champion, or a unit it controls alongside, which gets its own copy of the order. The path it carries is what the client would take; where the unit actually goes is whatever the server answers with.
| Field | Type | Present when | What it is |
|---|---|---|---|
| kind | u8 | What the order is. Values: 2 moveToPosition, 3 attack, 10 stop. | |
| targetX | f32 | Where the order points, along one ground axis. Carried in world units rather than in the units a path uses. | |
| targetY | f32 | The height of the place ordered. | |
| targetZ | f32 | Where the order points, along the other ground axis. | |
| target | u32 | The network object the order is aimed at, or zero where it is aimed at open ground. | |
| movement | record | Every point after the first. | |
| movement.header | 4-byte bits | ||
| movement.header.hasTeleportToken | bit 0 | Set where a token sits beside the unit. A client sends it clear, so a token travels only from a server. | |
| movement.header.unused | bit 1 to 15 | Unused; a client reads nothing here. | |
| movement.header.pointCount | bit 16 to 30 | How many points the path holds. A client takes none, or more than 2048, as no path and reads nothing more of the movement. | |
| movement.header.unusedHigh | bit 31 | Unused; a client reads nothing here. | |
| movement.path | record | Everything the movement carries beyond its first byte. | |
| movement.path.unit | u32 | The unit the path belongs to. | |
| movement.path.teleportToken | u8 | header.hasTeleportToken set | Tells one relocation from another. Movement says what a receiving end does with it. |
| movement.path.points | count in header.pointCount × record | Every point of the path, each stated in world units. | |
| movement.path.points[].x | f32 | Along one ground axis, in world units. | |
| movement.path.points[].z | f32 | Along the other, in world units. |
Vectors (2)
In 1.0.0.79–1.0.0.82
Command 20 on requests, sent by the client, reliable.
What a client sends as its player gives an order. The header names the unit ordered: the player’s champion, or a unit it controls alongside, which gets its own copy of the order. The path it carries is what the client would take; where the unit actually goes is whatever the server answers with.
| Field | Type | Present when | What it is |
|---|---|---|---|
| kind | u8 | What the order is. Values: 2 moveToPosition, 3 attack, 10 stop. | |
| targetX | f32 | Where the order points, along one ground axis. Carried in world units rather than in the units a path uses. | |
| targetY | f32 | The height of the place ordered. | |
| targetZ | f32 | Where the order points, along the other ground axis. | |
| target | u32 | The network object the order is aimed at, or zero where it is aimed at open ground. | |
| movement | record | Every point after the first. | |
| movement.header | 4-byte bits | ||
| movement.header.hasTeleportToken | bit 0 | Set where a token sits beside the unit. A client sends it clear, so a token travels only from a server. | |
| movement.header.unused | bit 1 to 15 | Unused; a client reads nothing here. | |
| movement.header.pointCount | bit 16 to 30 | How many points the path holds. A client takes none, or more than 2048, as no path and reads nothing more of the movement. | |
| movement.header.unusedHigh | bit 31 | Unused; a client reads nothing here. | |
| movement.path | record | Everything the movement carries beyond its first byte. | |
| movement.path.unit | u32 | The unit the path belongs to. | |
| movement.path.teleportToken | u8 | header.hasTeleportToken set | Tells one relocation from another. Movement says what a receiving end does with it. |
| movement.path.points | count in header.pointCount × record | Every point of the path, each stated whole. A client reads them even for a unit it does not hold. | |
| movement.path.points[].x | i16 | Along one ground axis, in the units Movement gives. | |
| movement.path.points[].z | i16 | Along the other. |
Vectors (2)
In 1.0.0.83–1.0.0.127
Carried on requests, sent by the client, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.83–1.0.0.109 | 20 |
| 1.0.0.110 | 110 |
| 1.0.0.111–1.0.0.116 | 111 |
| 1.0.0.117–1.0.0.118 | 112 |
| 1.0.0.119–1.0.0.123 | 113 |
| 1.0.0.124–1.0.0.127 | 117 |
What a client sends as its player gives an order. The header names the unit ordered: the player’s champion, or a unit it controls alongside, which gets its own copy of the order. The path it carries is what the client would take; where the unit actually goes is whatever the server answers with.
| Field | Type | Present when | What it is |
|---|---|---|---|
| kind | u8 | What the order is. Values: 2 moveToPosition, 3 attack, 10 stop. | |
| targetX | f32 | Where the order points, along one ground axis. Carried in world units rather than in the units a path uses. | |
| targetY | f32 | The height of the place ordered. | |
| targetZ | f32 | Where the order points, along the other ground axis. | |
| target | u32 | The network object the order is aimed at, or zero where it is aimed at open ground. | |
| movement | record | Every point after the first. | |
| movement.header | 4-byte bits | ||
| movement.header.hasTeleportToken | bit 0 | Set where a token sits beside the unit. A client sends it clear, so a token travels only from a server. | |
| movement.header.unused | bit 1 to 15 | Unused; a client reads nothing here. | |
| movement.header.pointCount | bit 16 to 22 | How many points the path holds. A client sends none for an order that takes no path, and then only the unit follows it. | |
| movement.header.unusedHigh | bit 23 to 31 | Unused; a client reads nothing here. | |
| movement.path | record | Everything the movement carries beyond its first byte. | |
| movement.path.unit | u32 | The unit the path belongs to. | |
| movement.path.teleportToken | u8 | header.hasTeleportToken set | Tells one relocation from another. Movement says what a receiving end does with it. |
| movement.path.flags | bits, count in header.pointCount minus 1 | One pair for each point after the first, in the order the points follow. Pairs run on from the low bits of the first byte, and the run reaches to the byte holding the last pair. The bits past it are clear. | |
| movement.path.flags.xIsStep | bit 0 | Set where this point states its first coordinate as a step. | |
| movement.path.flags.zIsStep | bit 1 | Set where this point states its second coordinate as a step. | |
| movement.path.firstX | i16 | header.pointCount set | The first point, along one ground axis, in the units Movement gives. |
| movement.path.firstZ | i16 | header.pointCount set | The first point, along the other. |
| movement.path.steps | count in header.pointCount minus 1 × record | ||
| movement.path.steps[].xStep | i8 | flags[step].xIsStep set | Added to the first coordinate of the point before, as that point resolved. |
| movement.path.steps[].xWhole | i16 | flags[step].xIsStep = 0 | The first coordinate, stated without reference to the point before. |
| movement.path.steps[].zStep | i8 | flags[step].zIsStep set | Added to the second coordinate of the point before, as that point resolved. |
| movement.path.steps[].zWhole | i16 | flags[step].zIsStep = 0 | The second coordinate, stated without reference to the point before. |
Vectors (27)
a-path-of-3-points-on-1-0-0-103, hold-on-1-0-0-103, one-on-1-0-0-103, move-to-position-on-1-0-0-109, a-path-of-3-points-on-1-0-0-110, hold-on-1-0-0-110, move-to-position-on-1-0-0-110, one-on-1-0-0-110, a-path-of-3-points-on-1-0-0-111, hold-on-1-0-0-111, one-on-1-0-0-111, move-to-position-on-1-0-0-116, a-path-of-3-points-on-1-0-0-117, hold-on-1-0-0-117, one-on-1-0-0-117, move-to-position-on-1-0-0-117, a-path-of-3-points-on-1-0-0-119, hold-on-1-0-0-119, one-on-1-0-0-119, move-to-position-on-1-0-0-123, a-path-of-3-points-on-1-0-0-124, hold-on-1-0-0-124, one-on-1-0-0-124, a-path-of-10-points-on-1-0-0-126, a-path-of-4-points-on-1-0-0-126, a-path-of-5-points-on-1-0-0-126, one-on-1-0-0-126
In 1.0.0.128–1.0.0.129
Command 117 on requests, sent by the client, reliable.
The path it carries is what the client would take; where the unit actually goes is whatever the server answers with.
| Field | Type | Present when | What it is |
|---|---|---|---|
| kind | u8 | What is being asked for. Values: 2 moveToPosition, 3 attack, 10 stop. | |
| targetX | f32 | Where the order points, along one ground axis. Carried in world units rather than in the units a path uses. | |
| targetY | f32 | The height of the place ordered. | |
| targetZ | f32 | Where the order points, along the other. | |
| target | u32 | The network object the order is aimed at, or zero where it is aimed at open ground. | |
| movement | record | ||
| movement.header | 4-byte bits | ||
| movement.header.hasTeleportToken | bit 0 | Set where a token sits beside the unit. A client sends it clear, so a token travels only from a server. | |
| movement.header.unused | bit 1 to 15 | Unused; a client reads nothing here. | |
| movement.header.pointCount | bit 16 to 22 | How many points the path holds. A client sends none for an order that takes no path, and then only the unit follows it. | |
| movement.header.unusedHigh | bit 23 to 31 | Unused; a client reads nothing here. | |
| movement.path | record | Everything the movement carries beyond its first byte. | |
| movement.path.unit | u32 | The unit the path belongs to. | |
| movement.path.teleportToken | u8 | header.hasTeleportToken set | Tells one relocation from another. Movement says what a receiving end does with it. |
| movement.path.flags | bits, count in header.pointCount minus 1 | One pair for each point after the first, in the order the points follow. Pairs run on from the low bits of the first byte, and the run reaches to the byte holding the last pair. The bits past it are clear. | |
| movement.path.flags.xIsStep | bit 0 | Set where this point states its first coordinate as a step. | |
| movement.path.flags.zIsStep | bit 1 | Set where this point states its second coordinate as a step. | |
| movement.path.firstX | i16 | header.pointCount set | The first point, along one ground axis, in the units Movement gives. |
| movement.path.firstZ | i16 | header.pointCount set | The first point, along the other. |
| movement.path.steps | count in header.pointCount minus 1 × record | ||
| movement.path.steps[].xStep | i8 | flags[step].xIsStep set | Added to the first coordinate of the point before, as that point resolved. |
| movement.path.steps[].xWhole | i16 | flags[step].xIsStep = 0 | The first coordinate, stated without reference to the point before. |
| movement.path.steps[].zStep | i8 | flags[step].zIsStep set | Added to the second coordinate of the point before, as that point resolved. |
| movement.path.steps[].zWhole | i16 | flags[step].zIsStep = 0 | The second coordinate, stated without reference to the point before. |
Vectors (3)
a-path-of-3-points-on-1-0-0-128, hold-on-1-0-0-128, one-on-1-0-0-128
WaypointGroup
What a server sends to move units. It carries a number a client returns to say it has taken the group in. The header carries zero or names the object this is about, and a client accepts either.
In 1.0.0.25–1.0.0.127
Carried on transient, sent by the server, unreliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.25–1.0.0.57 | 121 |
| 1.0.0.58–1.0.0.60 | 121 |
| 1.0.0.61–1.0.0.62 | 121 |
| 1.0.0.63–1.0.0.73 | 124 |
| 1.0.0.74–1.0.0.80 | 125 |
| 1.0.0.81 | 125 |
| 1.0.0.82 | 129 |
| 1.0.0.83–1.0.0.96 | 129 |
| 1.0.0.97–1.0.0.102 | 130 |
| 1.0.0.103–1.0.0.106 | 132 |
| 1.0.0.107–1.0.0.108 | 133 |
| 1.0.0.109 | 134 |
| 1.0.0.110–1.0.0.116 | 95 |
| 1.0.0.117–1.0.0.118 | 96 |
| 1.0.0.119–1.0.0.123 | 97 |
| 1.0.0.124–1.0.0.127 | 100 |
What a server sends to set units walking paths, which each walks at its own speed.
| Field | Type | What it is |
|---|---|---|
| syncId | u32 | The number of this statement; a client applies a path to a unit only where it is not behind the last the unit took. A client returns it in WaypointAck to say the group arrived. |
| movementCount | u16 | How many paths follow, one for each unit. A client reads it as signed, so a count above 32767 counts as none, as zero does, and a client still answers. |
| movements | count in movementCount × Movement | One path for each unit. |
Vectors (20)
one-on-1-0-0-25, one-on-1-0-0-58, one-on-1-0-0-61, one-on-1-0-0-72, one-on-1-0-0-75, one-on-1-0-0-79, one-on-1-0-0-81, one-on-1-0-0-82, one-on-1-0-0-96, one-on-1-0-0-99, one-on-1-0-0-106, one-on-1-0-0-108, one-on-1-0-0-109, one-on-1-0-0-116, one-on-1-0-0-117, one-on-1-0-0-123, a-path-of-10-points-on-1-0-0-126, a-path-of-4-points-on-1-0-0-126, a-path-of-5-points-on-1-0-0-126, one-on-1-0-0-126
In 1.0.0.128–1.0.0.129
Command 100 on transient, sent by the server, unreliable.
| Field | Type | What it is |
|---|---|---|
| syncId | u32 | Names this group. A client returns it to say the group arrived. |
| movementCount | u16 | How many units the group moves. A client reads it as signed, so a count above 32767 carries none. |
| movements | count in movementCount × Movement |
NavigationFlags
What a server sends to mark the ground within circles, in place of the circles it marked before: each circle’s flags apply to the ground within it. The header carries zero.
In 1.0.0.108–1.0.0.110
Carried on events, sent by the server, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.108 | 204 |
| 1.0.0.109 | 205 |
| 1.0.0.110 | 67 |
A client clears every circle it holds before marking these, and answers each with a message to the server under command 32 whose body is this sync id alone.
| Field | Type | What it is |
|---|---|---|
| count | u16 | The count of circles that follow. A client reads that many whatever the payload holds. |
| syncId | i32 | A number naming this marking. |
| circles | count in count × record | The circles. |
| circles[].x | f32 | The circle’s centre, along one ground axis, in world units. |
| circles[].z | f32 | The circle’s centre, along the other ground axis, in world units. |
| circles[].radius | f32 | Its radius, in world units. A circle of radius 1000 or more marks nothing. |
| circles[].flags | u32 | The flags to add to each cell. Only the low 16 bits take effect. |
Vectors (3)
In 1.0.0.111–1.0.0.127
Carried on events, sent by the server, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.111–1.0.0.116 | 67 |
| 1.0.0.117–1.0.0.118 | 68 |
| 1.0.0.119–1.0.0.123 | 69 |
| 1.0.0.124–1.0.0.127 | 71 |
A client clears every circle it holds before marking these, and answers each with a message to the server under command 32 whose body is this sync id alone.
| Field | Type | What it is |
|---|---|---|
| count | u16 | The count of circles that follow. |
| syncId | i32 | A number naming this marking. |
| circles | count in count × record | The circles. |
| circles[].x | f32 | The circle’s centre, along one ground axis, in world units. |
| circles[].z | f32 | The circle’s centre, along the other ground axis, in world units. |
| circles[].radius | f32 | Its radius, in world units. A circle of radius 1000 or more marks nothing. |
| circles[].flags | u32 | The flags to add to each cell. Only the low 16 bits take effect. |
Vectors (4)
one-on-1-0-0-116, one-on-1-0-0-117, one-on-1-0-0-123, two-circles-on-1-0-0-126
In 1.0.0.128–1.0.0.129
Command 71 on events, sent by the server, reliable.
A client fails on the first of these in a match: it stops, marking no circle and sending no answer.
| Field | Type | What it is |
|---|---|---|
| count | u16 | The count of circles that follow. |
| syncId | i32 | A number naming this marking. |
| circles | count in count × record | The circles. |
| circles[].x | f32 | The circle’s centre, along one ground axis, in world units. |
| circles[].z | f32 | The circle’s centre, along the other ground axis, in world units. |
| circles[].radius | f32 | Its radius, in world units. A circle of radius 1000 or more marks nothing. |
| circles[].flags | u32 | The flags to add to each cell. Only the low 16 bits take effect. |
FaceDirection
What a server sends to turn a unit to face a direction. The header names the unit acting.
In 1.0.0.25–1.0.0.127
Carried on events, sent by the server, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.25–1.0.0.62 | 93 |
| 1.0.0.63–1.0.0.73 | 99 |
| 1.0.0.74–1.0.0.81 | 100 |
| 1.0.0.82–1.0.0.96 | 104 |
| 1.0.0.97–1.0.0.102 | 105 |
| 1.0.0.103–1.0.0.106 | 107 |
| 1.0.0.107–1.0.0.108 | 108 |
| 1.0.0.109 | 109 |
| 1.0.0.110–1.0.0.116 | 79 |
| 1.0.0.117–1.0.0.118 | 80 |
| 1.0.0.119–1.0.0.123 | 81 |
| 1.0.0.124–1.0.0.127 | 83 |
Where towardX and towardZ are both zero, a client does not turn the unit at once, but it still keeps the zero direction as the one the unit is to face. What follows from that is not recorded.
| Field | Type | What it is |
|---|---|---|
| towardX | f32 | The direction faced, along one ground axis. |
| towardY | f32 | The direction faced, in height. |
| towardZ | f32 | The direction faced, along the other ground axis. |
In 1.0.0.128–1.0.0.129
Command 83 on events, sent by the server, reliable.
| Field | Type | What it is |
|---|---|---|
| towardX | f32 | The direction faced, along one ground axis. |
| towardY | f32 | The direction faced, in height. |
| towardZ | f32 | The direction faced, along the other ground axis. |
FacePosition
What a client sends when a script it runs turns a unit to face a point. A server need do nothing with it. The header names the unit turned.
In every range of this book
Carried on requests, sent by the client, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.25–1.0.0.62 | 93 |
| 1.0.0.63–1.0.0.73 | 99 |
| 1.0.0.74–1.0.0.81 | 100 |
| 1.0.0.82–1.0.0.96 | 104 |
| 1.0.0.97–1.0.0.102 | 105 |
| 1.0.0.103–1.0.0.106 | 107 |
| 1.0.0.107–1.0.0.108 | 108 |
| 1.0.0.109 | 109 |
| 1.0.0.110–1.0.0.116 | 79 |
| 1.0.0.117–1.0.0.118 | 80 |
| 1.0.0.119–1.0.0.123 | 81 |
| 1.0.0.124–1.0.0.129 | 83 |
| Field | Type | What it is |
|---|---|---|
| directionX | f32 | Which way the unit now faces, as a direction of length one, along one ground axis. |
| directionY | f32 | Which way the unit now faces, as a direction of length one, in height. |
| directionZ | f32 | Which way the unit now faces, as a direction of length one, along the other ground axis. |
MovementBounds
What a server sends to set a circle that a client keeps its view or its champion’s orders within. The header carries zero.
In 1.0.0.25–1.0.0.62
Command 126 on events, sent by the server, reliable.
A client keeps its camera within the circle, and nothing else.
| Field | Type | What it is |
|---|---|---|
| x | f32 | The circle’s centre, in world units. |
| y | f32 | The centre’s height, in world units. A client does not use it. |
| z | f32 | The circle’s centre, in world units. |
| radius | f32 | The circle’s radius, in world units. Zero lifts the bounds; a negative radius counts as zero. |
Vectors (1)
In 1.0.0.63–1.0.0.109
Carried on events, sent by the server, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.63–1.0.0.73 | 129 |
| 1.0.0.74–1.0.0.81 | 130 |
| 1.0.0.82–1.0.0.96 | 134 |
| 1.0.0.97 | 135 |
| 1.0.0.98–1.0.0.102 | 136 |
| 1.0.0.103–1.0.0.106 | 138 |
| 1.0.0.107–1.0.0.108 | 139 |
| 1.0.0.109 | 140 |
A client keeps its camera within the circle, and nothing else.
| Field | Type | What it is |
|---|---|---|
| x | f32 | The circle’s centre, in world units. |
| y | f32 | The centre’s height, in world units. |
| z | f32 | The circle’s centre, in world units. |
| radius | f32 | The circle’s radius, in world units. Zero lifts the bounds; a negative radius counts as zero. |
In 1.0.0.110–1.0.0.125
Command 6 on events, sent by the server, reliable.
A client pulls an order to a point outside onto the circle’s edge before sending it, and drops an order at an object outside.
| Field | Type | What it is |
|---|---|---|
| x | f32 | The circle’s centre, in world units. |
| y | f32 | The centre’s height, in world units. |
| z | f32 | The circle’s centre, in world units. |
| radius | f32 | The circle’s radius, in world units. Zero lifts the bounds; a negative radius counts as zero. |
| camera | u8 | A client takes any bit set here as camera set; a server writes zero. |
Vectors (1)
In 1.0.0.126–1.0.0.127
Command 6 on events, sent by the server, reliable.
A client pulls an order to a point outside onto the circle’s edge before sending it, and drops an order at an object outside.
| Field | Type | What it is |
|---|---|---|
| x | f32 | The circle’s centre, in world units. |
| y | f32 | The centre’s height, in world units. |
| z | f32 | The circle’s centre, in world units. |
| radius | f32 | The circle’s radius, in world units. Zero lifts the bounds; a negative radius counts as zero. |
| camera | u8 | Nonzero also keeps the client’s camera inside the circle, a negative radius counting as zero for it. The bounds on the champion’s orders apply whatever this holds. |
Vectors (1)
In 1.0.0.128–1.0.0.129
Command 6 on events, sent by the server, reliable.
A client pulls an order to a point outside onto the circle’s edge before sending it, and drops an order at an object outside.
| Field | Type | What it is |
|---|---|---|
| x | f32 | The circle’s centre, in world units. |
| y | f32 | The centre’s height, in world units. |
| z | f32 | The circle’s centre, in world units. |
| radius | f32 | The circle’s radius, in world units. Zero lifts the bounds; a negative radius counts as zero. |
| camera | u8 | Set to keep the camera within the circle too. Clear leaves the camera as it was, bound or not. Any nonzero value sets it. |
Path
What a server sends to set a unit walking along a path, facing the way it walks. The header names the unit.
In 1.0.0.25–1.0.0.62
Command 77 on events, sent by the server, reliable.
A client answers every one at once, before applying it and whatever its sync id, unsequenced on the transient channel, with WaypointAck carrying this sync id. It applies it only where the sync id is not older than the last the unit took (as UnitStopped).
| Field | Type | What it is |
|---|---|---|
| syncId | i32 | The unit’s movement count. |
| points | to the end × record | The path’s points, to the end of the message. A client takes the ground’s height for each, and passes over a remainder shorter than a point. |
| points[].x | f32 | A point on the path, in world units. |
| points[].z | f32 | A point on the path, in world units. |
Vectors (1)
In 1.0.0.63–1.0.0.127
Carried on events, sent by the server, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.63–1.0.0.73 | 83 |
| 1.0.0.74–1.0.0.81 | 84 |
| 1.0.0.82–1.0.0.96 | 87 |
| 1.0.0.97–1.0.0.102 | 88 |
| 1.0.0.103–1.0.0.106 | 89 |
| 1.0.0.107–1.0.0.108 | 90 |
| 1.0.0.109 | 91 |
| 1.0.0.110 | 184 |
| 1.0.0.111–1.0.0.116 | 185 |
| 1.0.0.117–1.0.0.118 | 186 |
| 1.0.0.119–1.0.0.123 | 187 |
| 1.0.0.124 | 191 |
| 1.0.0.125 | 192 |
| 1.0.0.126–1.0.0.127 | 193 |
A client answers every one at once, before applying it, with WaypointAck: ten bytes holding this sync id and a last byte, where the relocation count sits, that is arbitrary and carries no meaning. A client answers every one at once, unsequenced on the transient channel, with ten bytes: WaypointAck’s command, a net id of zero, this sync id, and one byte that is arbitrary and carries no meaning. It applies it only where the sync id is not older than the last the unit took (as UnitStopped).
| Field | Type | What it is |
|---|---|---|
| syncId | i32 | The unit’s movement count. |
| points | to the end × record | The path’s points, to the end of the message. A client takes the ground’s height for each, and passes over a remainder shorter than a point. |
| points[].x | f32 | A point on the path, in world units. |
| points[].z | f32 | A point on the path, in world units. |
In 1.0.0.128–1.0.0.129
Command 193 on events, sent by the server, reliable.
A client answers every one at once, unsequenced on the transient channel, with ten bytes: WaypointAck’s command, a net id of zero, this sync id, and one byte that is arbitrary and carries no meaning. It applies it only where the sync id is not older than the last the unit took (as UnitStopped).
| Field | Type | What it is |
|---|---|---|
| syncId | i32 | The unit’s movement count. |
| points | to the end × record | The path’s points, to the end of the message. A client takes the ground’s height for each. |
| points[].x | f32 | A point on the path, in world units. |
| points[].z | f32 | A point on the path, in world units. |
PathWithSpeed
What a server sends to set a unit moving along a path at a speed of its own, perhaps in an arc. The header names the unit.
In 1.0.0.25–1.0.0.62
Command 78 on events, sent by the server, reliable.
A client answers every one at once, before applying it and whatever its sync id, as it answers Path. It applies it only where the sync id is not older than the last the unit took, and does not count it as the last itself.
| Field | Type | What it is |
|---|---|---|
| syncId | i32 | The unit’s movement count. |
| speed | f32 | The speed to move at, in world units a second. |
| gravity | f32 | The arc’s gravity, for a leap, in units of 150 world units a second squared. Zero or less moves the unit flat. |
| arcX | f32 | Where the arc begins, in world units. |
| arcZ | f32 | Where the arc begins, in world units. |
| points | to the end × record | The path’s points, to the end of the message. A client takes the ground’s height for each, and passes over a remainder shorter than a point. |
| points[].x | f32 | A point on the path, in world units. |
| points[].z | f32 | A point on the path, in world units. |
Vectors (1)
In 1.0.0.63–1.0.0.107
Carried on events, sent by the server, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.63–1.0.0.73 | 84 |
| 1.0.0.74–1.0.0.81 | 85 |
| 1.0.0.82–1.0.0.96 | 88 |
| 1.0.0.97–1.0.0.102 | 89 |
| 1.0.0.103–1.0.0.106 | 90 |
| 1.0.0.107 | 91 |
A client answers every one at once, before applying it, with WaypointAck: ten bytes holding this sync id and a last byte, where the relocation count sits, that is arbitrary and carries no meaning. A client answers every one at once, as it answers Path, whatever its sync id. It applies it only where the sync id is not older than the last the unit took (as UnitStopped). A unit can follow another unit.
| Field | Type | What it is |
|---|---|---|
| syncId | i32 | The unit’s movement count. |
| speed | f32 | The speed to move at, in world units a second. |
| gravity | f32 | The arc’s gravity, for a leap, in units of 150 world units a second squared. Zero or less moves the unit flat. |
| arcX | f32 | Where the arc begins, in world units. |
| arcZ | f32 | Where the arc begins, in world units. |
| points | to the end × record | The path’s points, to the end of the message. A client takes the ground’s height for each, and passes over a remainder shorter than a point. |
| points[].x | f32 | A point on the path, in world units. |
| points[].z | f32 | A point on the path, in world units. |
In 1.0.0.108–1.0.0.109
Carried on events, sent by the server, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.108 | 91 |
| 1.0.0.109 | 92 |
A client answers every one at once, before applying it, with WaypointAck: ten bytes holding this sync id and a last byte, where the relocation count sits, that is arbitrary and carries no meaning. A client answers every one at once, as it answers Path, whatever its sync id. It applies it only where the sync id is not older than the last the unit took (as UnitStopped). A unit can follow another unit.
| Field | Type | What it is |
|---|---|---|
| syncId | i32 | The unit’s movement count. |
| speed | f32 | The speed to move at, in world units a second. |
| gravity | f32 | The arc’s gravity, for a leap, in units of 150 world units a second squared. Zero or less moves the unit flat. |
| arcX | f32 | Where the arc begins, in world units. |
| arcZ | f32 | Where the arc begins, in world units. |
| facing | i8 | Which way the unit faces as it moves. Values: 0 along, 1 keep. |
| points | to the end × record | The path’s points, to the end of the message. A client takes the ground’s height for each, and passes over a remainder shorter than a point. |
| points[].x | f32 | A point on the path, in world units. |
| points[].z | f32 | A point on the path, in world units. |
Vectors (2)
In 1.0.0.110
Command 129 on events, sent by the server, reliable.
A client answers every one at once, before applying it, with WaypointAck: ten bytes holding this sync id and a last byte, where the relocation count sits, that is arbitrary and carries no meaning. A client answers every one at once, as it answers Path, whatever its sync id. It applies it only where the sync id is not older than the last the unit took (as UnitStopped). A unit can follow another unit.
| Field | Type | What it is |
|---|---|---|
| syncId | i32 | The unit’s movement count. |
| speed | f32 | The speed to move at, in world units a second. |
| gravity | f32 | The arc’s gravity, for a leap, in units of 150 world units a second squared. Zero or less moves the unit flat. |
| arcX | f32 | Where the arc begins, in world units. |
| arcZ | f32 | Where the arc begins, in world units. |
| follow | u32 | A unit to follow, or zero for none. |
| followDistance | f32 | How near to keep to it, in world units. It takes effect only where follow is not zero. |
| backOff | f32 | How far to fall back from it, in world units. It takes effect only where follow is not zero. |
| facing | i8 | Which way the unit faces as it moves. Values: 0 along, 1 keep. |
| points | to the end × record | The path’s points, to the end of the message. A client takes the ground’s height for each, and passes over a remainder shorter than a point. |
| points[].x | f32 | A point on the path, in world units. |
| points[].z | f32 | A point on the path, in world units. |
Vectors (1)
In 1.0.0.111–1.0.0.127
Carried on events, sent by the server, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.111–1.0.0.116 | 130 |
| 1.0.0.117–1.0.0.118 | 131 |
| 1.0.0.119–1.0.0.123 | 132 |
| 1.0.0.124–1.0.0.127 | 136 |
A client answers every one at once, before applying it, with WaypointAck: ten bytes holding this sync id and a last byte, where the relocation count sits, that is arbitrary and carries no meaning. A client answers every one at once, as it answers Path, whatever its sync id. It applies it only where the sync id is not older than the last the unit took (as UnitStopped). A unit can follow another unit.
| Field | Type | What it is |
|---|---|---|
| syncId | i32 | The unit’s movement count. |
| speed | f32 | The speed to move at, in world units a second. |
| gravity | f32 | The arc’s gravity, for a leap, in units of 150 world units a second squared. Zero or less moves the unit flat. |
| arcX | f32 | Where the arc begins, in world units. |
| arcZ | f32 | Where the arc begins, in world units. |
| facing | i8 | Which way the unit faces as it moves. Values: 0 along, 1 keep. |
| follow | u32 | A unit to follow, or zero for none. |
| followDistance | f32 | How near to keep to it, in world units. It takes effect only where follow is not zero. |
| backOff | f32 | How far to fall back from it, in world units. It takes effect only where follow is not zero. |
| travelTime | f32 | How long the move takes, in seconds. It takes effect only where follow is not zero. |
| points | to the end × record | The path’s points, to the end of the message. A client takes the ground’s height for each, and passes over a remainder shorter than a point. |
| points[].x | f32 | A point on the path, in world units. |
| points[].z | f32 | A point on the path, in world units. |
In 1.0.0.128–1.0.0.129
Command 136 on events, sent by the server, reliable.
A client answers every one at once, as it answers Path, whatever its sync id. It applies it only where the sync id is not older than the last the unit took (as UnitStopped). A unit can follow another unit.
| Field | Type | What it is |
|---|---|---|
| syncId | i32 | The unit’s movement count. |
| speed | f32 | The speed to move at, in world units a second. |
| gravity | f32 | The arc’s gravity, for a leap, in units of 150 world units a second squared. Zero or less moves the unit flat. |
| arcX | f32 | Where the arc begins, in world units. |
| arcZ | f32 | Where the arc begins, in world units. |
| facing | i8 | Which way the unit faces as it moves. Values: 0 along, 1 keep. |
| follow | u32 | A unit to follow, or zero for none. |
| followDistance | f32 | How near to keep to it, in world units. It takes effect only where follow is not zero. |
| backOff | f32 | How far to fall back from it, in world units. It takes effect only where follow is not zero. |
| travelTime | f32 | How long the move takes, in seconds. It takes effect only where follow is not zero. |
| points | to the end × record | The path’s points, to the end of the message. A client takes the ground’s height for each. |
| points[].x | f32 | A point on the path, in world units. |
| points[].z | f32 | A point on the path, in world units. |
UnitStopped
What a server sends to stop a unit where it stands. The header names the unit.
In 1.0.0.25–1.0.0.57
Command 24 on events, sent by the server, reliable.
A client applies it only where its sync id is not older than the last the unit took, counting a wrap: this message, PathWithSpeed and Path share one count per unit, starting at -1.
| Field | Type | What it is |
|---|---|---|
| x | f32 | Where the unit stands, in world units; a client keeps this height rather than the ground’s. |
| y | f32 | Its height, in world units. |
| z | f32 | Where it stands, in world units. |
| facingX | f32 | The way it faces. |
| facingY | f32 | The way it faces. |
| facingZ | f32 | The way it faces. |
| syncId | i32 | The unit’s movement count. A client drops the message where it is behind the last the unit took by less than 1073741824. |
In 1.0.0.58–1.0.0.109
Command 24 on events, sent by the server, reliable.
A client applies it only where its sync id is not older than the last the unit took, counting a wrap: this message, Path, PathWithSpeed, WaypointGroup and WaypointGroupAtSpeed share one count per unit, starting at -1.
| Field | Type | What it is |
|---|---|---|
| x | f32 | Where the unit stands, in world units; a client keeps this height rather than the ground’s. |
| y | f32 | Its height, in world units. |
| z | f32 | Where it stands, in world units. |
| facingX | f32 | The way it faces. |
| facingY | f32 | The way it faces. |
| facingZ | f32 | The way it faces. |
| syncId | i32 | The unit’s movement count. A client drops the message where it is behind the last the unit took by less than 1073741824. |
Vectors (2)
In 1.0.0.110–1.0.0.127
Carried on events, sent by the server, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.110–1.0.0.123 | 50 |
| 1.0.0.124–1.0.0.127 | 51 |
A client applies it only where its sync id is not older than the last the unit took, counting a wrap: this message, PathWithSpeed and Path share one count per unit, starting at -1.
| Field | Type | What it is |
|---|---|---|
| x | f32 | Where the unit stands, in world units; a client keeps this height rather than the ground’s. |
| y | f32 | Its height, in world units. |
| z | f32 | Where it stands, in world units. |
| facingX | f32 | The way it faces. |
| facingY | f32 | The way it faces. |
| facingZ | f32 | The way it faces. |
| syncId | i32 | The unit’s movement count. A client drops the message where it is behind the last the unit took by less than 1073741824. |
Vectors (2)
In 1.0.0.128–1.0.0.129
Command 51 on events, sent by the server, reliable.
A client applies it only where its sync id is not older than the last the unit took, counting a wrap: this message, PathWithSpeed and Path share one count per unit, starting at -1.
| Field | Type | What it is |
|---|---|---|
| x | f32 | Where the unit stands, in world units; a client keeps this height rather than the ground’s. |
| y | f32 | Its height, in world units. |
| z | f32 | Where it stands, in world units. |
| facingX | f32 | The way it faces. |
| facingY | f32 | The way it faces. |
| facingZ | f32 | The way it faces. |
| syncId | i32 | The unit’s movement count. |