Votes
Surrender votes, and a vote on evening out a match.
Surrender
A server tells a side a surrender vote has been called with
SurrenderVoteCalled. A client answers with SurrenderVote, and a server tells
the side where the vote stands with SurrenderStatus. SurrenderAllowed says
whether a champion’s player can call a vote, turning the choice in the client’s
menu on or off.
SurrenderVoteCalled shows the caller’s vote to that side and, where it says
the vote opens, opens the vote’s panel for that side.
In 1.0.0.58–1.0.0.129
A client ignores
SurrenderVoteCalledthat arrives before its own champion is on the field.
In 1.0.0.126
A client opens no panel for a vote called while the match is paused.
Evening out a match
A server can hold a vote on giving the side behind gold, experience and
turrets. BalanceVote opens the vote’s panel for the voting side and adds one
voter with each message; a client answers with
BalanceVoteAnswer from the panel or as its player types /equalize, once per
vote. BalanceResult says how the vote ended, or why it could not be held.
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).
SurrenderVoteCalled
What a server sends to open a surrender vote, or to report one already open. The header names no object: it carries zero.
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.73 | 158 |
| 1.0.0.74–1.0.0.81 | 159 |
| 1.0.0.82–1.0.0.96 | 163 |
| 1.0.0.97 | 164 |
| 1.0.0.98–1.0.0.102 | 165 |
| 1.0.0.103 | 167 |
| 1.0.0.104–1.0.0.106 | 173 |
| 1.0.0.107–1.0.0.108 | 174 |
| 1.0.0.109 | 175 |
| 1.0.0.110 | 199 |
| 1.0.0.111–1.0.0.116 | 200 |
| 1.0.0.117–1.0.0.118 | 201 |
| 1.0.0.119–1.0.0.122 | 202 |
| 1.0.0.123 | 203 |
| 1.0.0.124 | 208 |
| 1.0.0.125 | 209 |
| 1.0.0.126–1.0.0.127 | 210 |
A client ignores it unless its menu and its own champion both exist.
| Field | Type | What it is |
|---|---|---|
| how | 1-byte bits | |
| how.countAsYes | bit 0 | Applies only where side is the client’s own: set shows caller voting yes, clear voting no, opening the menu or not. |
| how.openTheMenu | bit 1 | Set where the vote opens: a client of side opens the vote’s panel from seats and closesIn, which have no other effect; every client with a player of its own announces that a vote began, with caller, inFavour, against and side. |
| how.unused | bit 2 to 7 | Unused; a server writes zero. |
| caller | u32 | The unit that called the vote. |
| inFavour | u8 | How many have voted for. |
| against | u8 | How many have voted against. |
| seats | u8 | How many seats can vote. |
| side | u32 | Which side is voting. |
| closesIn | f32 | How long the vote stays open, in seconds. |
Vectors (18)
one-on-1-0-0-72, one-on-1-0-0-75, one-on-1-0-0-81, one-on-1-0-0-96, one-on-1-0-0-97, one-on-1-0-0-99, one-on-1-0-0-103, one-on-1-0-0-106, 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-122, one-on-1-0-0-123, one-on-1-0-0-124, one-on-1-0-0-125, opening-on-1-0-0-126
In 1.0.0.128–1.0.0.129
Command 210 on events, sent by the server, reliable.
A client ignores it unless its menu and its own champion both exist.
| Field | Type | What it is |
|---|---|---|
| how | 1-byte bits | |
| how.countAsYes | bit 0 | Applies only where side is the client’s own: set shows caller voting yes, clear voting no, opening the menu or not. |
| how.openTheMenu | bit 1 | Set where the vote opens: a client of side opens the vote’s panel from seats and closesIn, which have no other effect; every client is told a vote began, with caller, inFavour, against and side. |
| how.unused | bit 2 to 7 | Unused; a server writes zero. |
| caller | u32 | The unit that called the vote. |
| inFavour | u8 | How many have voted for. |
| against | u8 | How many have voted against. |
| seats | u8 | How many seats can vote. |
| side | u32 | Which side is voting. |
| closesIn | f32 | How long the vote stays open, in seconds. |
SurrenderVote
What a client sends to vote on surrendering. The header names no object: it carries zero.
In 1.0.0.25–1.0.0.73
Command 157 on requests, sent by the client, reliable.
It answers a call to surrender.
| Field | Type | What it is |
|---|---|---|
| how | 1-byte bits | |
| how.inFavour | bit 0 | Set where the answer is yes, clear where it is no. |
| how.unused | bit 1 to 7 | A client leaves these bits as they happen to be; a server ignores them. |
Vectors (1)
In 1.0.0.74–1.0.0.81
Command 158 on requests, sent by the client, reliable.
It answers a call to surrender.
| Field | Type | What it is |
|---|---|---|
| how | 1-byte bits | |
| how.inFavour | bit 0 | Set where the answer is yes. A client sends it clear. |
| how.unused | bit 1 to 7 | Always clear. |
Vectors (2)
In 1.0.0.82–1.0.0.96
Command 162 on requests, sent by the client, reliable.
It answers a call to surrender.
| Field | Type | What it is |
|---|---|---|
| how | 1-byte bits | |
| how.inFavour | bit 0 | Set where the answer is yes. |
| how.unused | bit 1 to 7 | Unused; a client leaves them as they happen to be, and a server ignores them. |
Vectors (1)
In 1.0.0.97–1.0.0.125
Carried on requests, sent by the client, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.97 | 163 |
| 1.0.0.98–1.0.0.102 | 164 |
| 1.0.0.103 | 166 |
| 1.0.0.104–1.0.0.106 | 172 |
| 1.0.0.107–1.0.0.108 | 173 |
| 1.0.0.109 | 174 |
| 1.0.0.110 | 163 |
| 1.0.0.111–1.0.0.116 | 164 |
| 1.0.0.117–1.0.0.118 | 165 |
| 1.0.0.119–1.0.0.123 | 166 |
| 1.0.0.124 | 170 |
| 1.0.0.125 | 171 |
It answers a call to surrender.
| Field | Type | What it is |
|---|---|---|
| how | 1-byte bits | |
| how.inFavour | bit 0 | Set where the answer is yes. A client sends it clear. |
| how.unused | bit 1 to 7 | Always clear. |
In 1.0.0.126–1.0.0.129
Command 172 on requests, sent by the client, reliable.
It answers a call to surrender.
| Field | Type | What it is |
|---|---|---|
| how | 1-byte bits | |
| how.inFavour | bit 0 | Set where the answer is yes, clear where it is no. |
| how.unused | bit 1 to 7 | A client leaves these bits unwritten; they carry no meaning. |
Vectors (1)
SurrenderStatus
What a server sends to tell a side where its surrender vote stands. The header names no object: it carries zero.
In 1.0.0.25–1.0.0.73
Command 160 on events, sent by the server, reliable.
A client ignores the message unless its interface and its own champion both exist.
| Field | Type | What it is |
|---|---|---|
| reason | u32 | Why the vote stands where it does. A client acts on 0 to 4 and ignores the message for any other value; 0 resets the vote whatever side holds, and 1 resets it only where side is the client’s own. |
| inFavour | u8 | How many voted for. |
| against | u8 | How many voted against. |
| side | u32 | Which side. |
Vectors (1)
In 1.0.0.74–1.0.0.81
Command 161 on events, sent by the server, reliable.
| Field | Type | What it is |
|---|---|---|
| reason | u32 | Why the vote stands where it does. A client acts on 0 to 4 and ignores the message for any other value; 1 resets the vote only where side is the client’s own. A client with no player of its own, as while spectating, shows only 0 and 4. |
| inFavour | u8 | How many voted for. |
| against | u8 | How many voted against. |
| side | u32 | Which side. |
Vectors (2)
In 1.0.0.82–1.0.0.96
Command 165 on events, sent by the server, reliable.
| Field | Type | What it is |
|---|---|---|
| reason | u32 | Why the vote stands where it does. A client acts on 0 to 4 and ignores the message for any other value; 1 resets the vote only where side is the client’s own. A client with no champion of its own, as while spectating, ignores the whole message. |
| inFavour | u8 | How many voted for. |
| against | u8 | How many voted against. |
| side | u32 | Which side. |
Vectors (1)
In 1.0.0.97–1.0.0.127
Carried on events, sent by the server, reliable, under these commands:
| Builds | Command |
|---|---|
| 1.0.0.97 | 166 |
| 1.0.0.98–1.0.0.102 | 167 |
| 1.0.0.103 | 169 |
| 1.0.0.104–1.0.0.106 | 175 |
| 1.0.0.107–1.0.0.108 | 176 |
| 1.0.0.109 | 177 |
| 1.0.0.110 | 164 |
| 1.0.0.111–1.0.0.116 | 165 |
| 1.0.0.117–1.0.0.118 | 166 |
| 1.0.0.119–1.0.0.123 | 167 |
| 1.0.0.124 | 171 |
| 1.0.0.125 | 172 |
| 1.0.0.126–1.0.0.127 | 173 |
| Field | Type | What it is |
|---|---|---|
| reason | u32 | Why the vote stands where it does. A client acts on 0 to 4 and ignores the message for any other value; 1 resets the vote only where side is the client’s own. A client with no player of its own, as while spectating, shows only 0 and 4. |
| inFavour | u8 | How many voted for. |
| against | u8 | How many voted against. |
| side | u32 | Which side. |
In 1.0.0.128–1.0.0.129
Command 173 on events, sent by the server, reliable.
| Field | Type | What it is |
|---|---|---|
| reason | u32 | Why the vote stands where it does. |
| inFavour | u8 | How many voted for. |
| against | u8 | How many voted against. |
| side | u32 | Which side. |