Units

How a server puts objects on the field and takes them away: champions, minions, neutral monsters, turrets, pets, markers and props. What a unit then does is in Movement, Combat and Spells, and what it is worth in Replication.

Every object is named by a net id, and Objects and identifiers says what removes each kind of object.

Creating

Each kind of object has its own message:

a champion, CreateChampion, which, carrying the client’s own client id, also makes that champion the client’s own; a bot’s champion, the same CreateChampion naming no client, or SpawnBot;
a minion sent out from a side’s barracks, SpawnFromBarracks, and a unit like one, such as a ward, SpawnUnit;
a monster of no side, CreateNeutral; a pet, SpawnPet;
a turret, CreateTurret (The client’s data says how it names one), and a turret of the server’s choosing, SpawnTurret;
an object that follows a unit, CreateFollower, and a change to what it follows, FollowerMaster;
an unseen marker, SpawnMarker, which other messages can name and MarkerMoved moves;
a prop, a thing that stands on the map and is looked at, MapProp, and a change to one, MapPropChanged.

Several of these arrive on their own or inside the EnterSight that brings the unit into view (see Vision): a client takes either.

CharacterPreload has a client load a character’s art ahead of need.

In 4.1–4.19

A client drops a CreateChampion or a CreateNeutral that arrives before it sends CharacterSelected, reconnecting included. A server MUST send them after it receives CharacterSelected.

Changing and removing

TeamChanged moves a unit to another side, and ChampionRemoved takes a champion out of the world. A unit’s death is in Combat.

Bots

A server can tell a client what a bot is thinking (BotDebug), weighing (BotTargets) or doing (BotState). None of them changes what a player sees.

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).

`CreateChampion`

What a server sends to put a champion on the field. The header carries zero or names the object this is about; a client accepts either.

Builds	Command
4.1–4.10	75
4.11–4.17	76

Field	Type	What it is
champion	u32	The name the champion answers to, so later messages can name it.
clientId	u32	The client id of the player the champion belongs to, or 4294967295 where it belongs to none, as a bot’s does. A client takes the champion carrying its own client id as its own.
node	u8	Which network node the object belongs to, in a field of its own.
skillLevel	u8	It has no effect.
side	u8	Nonzero for side 100, zero for side 200.
bot	u8	Nonzero where a bot plays the seat; its shown name is then the client’s own bot name for asset, and name has no effect.
rank	u8	It has no effect.
spawnIndex	u8	Where the champion first stands and faces. From 0 to 5, its side’s base position plus the offset the map sets for the side’s head count (players and bots) and this index plus one, facing as the map sets for them. A client works out the head count itself, counting SpawnStart’s bots in it. From 6 up, the base position itself, facing along +X. Movement or sight data replaces it.
skin	i32	Which look it wears.
name	text, 128 bytes	What the seat holding it is called. Written out in full and padded with zero bytes to the width above.
asset	text, 40 bytes	The name the client loads its art and sound under, written and padded as above.
stayDown	f32	How long it stays down, in seconds, where it is already down.
downFor	f32	How long it has already been down, in seconds.
how	1-byte bits
how.down	bit 0 to 2	0 alive; 1 dead but acting on (the state a champion that keeps acting after death is in), where stayDown and downFor have no effect; 2 down, having been down for downFor with stayDown left. A client takes 3 to 7 as 0.
how.swap	bit 3	Set where the champion replaces another. Of no effect otherwise.
how.unused	bit 4 to 7	Unused; a server writes zero.

Field	Type	What it is
champion	u32	The name the champion answers to, so later messages can name it.
clientId	u32	The client id of the player the champion belongs to, or 4294967295 where it belongs to none, as a bot’s does. A client takes the champion carrying its own client id as its own.
node	u8	Which network node the object belongs to, in a field of its own.
skillLevel	u8	What level the champion’s own spells stand at.
who	1-byte bits
who.side	bit 0	Which of the two sides the champion is on. A server sets it.
who.bot	bit 1	Set where nobody holds it.
who.unused	bit 2 to 7	Unused; a server writes zero.
rank	u8	How well it plays where nobody holds it.
spawnIndex	u8	Which of its side’s starting places the champion begins at, counted from zero. Where a champion first stands travels in EnterSight. A server can send 0 for every champion; where a champion stands is settled by the movement or sight data that follows.
skin	i32	Which look it wears.
name	text, 128 bytes	What the seat holding it is called. Written out in full and padded with zero bytes to the width above.
asset	text, 40 bytes	The name the client loads its art and sound under, written and padded as above.
stayDown	f32	How long it stays down, in seconds, where it is already down.
downFor	f32	How long it has already been down, in seconds.
deathKind	u32	What sort of death it is already in, where it is already down.
how	1-byte bits
how.swap	bit 0	Set where the champion replaces another; a client whose champion it is resets every script’s state.
how.hidden	bit 1	Set to fade the champion’s model out at once.
how.unused	bit 2 to 7	Unused; a server writes zero.

Builds	Command
4.1–4.10	206
4.11–4.19	207

Keyboard shortcuts

Trueshot Season 4