Events

You just harvested this many of an item; the client shows the amount with the item's icon. Kind event Area Game.Inventory Named by beta, gamemapping A harvest finished and produced items. object_gid is the item (an id from the items table) and quantity is how many this harvest gave. IT IS A NOTIFICATION, NOT AN INVENTORY UPDATE. The client only displays it: it looks the item up for its icon and shows the gained amount over your character. The stack itself changes through the inventory message

The new quantity of one stack you already hold, and where the change came from. Kind event Area Game.Inventory Named by beta, gamemapping The singular form of ObjectsQuantityEvent: one stack, its new quantity, and an origin. THE QUANTITY IS THE NEW TOTAL, NOT A DELTA. The client looks the stack up by ObjectUidWithQuantity.object_uid and SETS its size to ObjectUidWithQuantity.quantity. If you want "how many did I just get", subtract what you held before - which is exactly what the client does

New absolute quantities for stacks the character already holds, several at once. Kind event Area Game.Inventory Named by beta, gamemapping Quantity updates for stacks that are ALREADY in your inventory, batched. EACH ENTRY IS AN ABSOLUTE TOTAL, NOT A DELTA. The client looks the stack up by ObjectUidWithQuantity.object_uid and SETS its size to ObjectUidWithQuantity.quantity; it never adds. Treating it as a delta double-counts every update. THIS MESSAGE NEVER INTRODUCES A STACK. If the uid is

The set of optional features the server has enabled, replacing any held set. Kind event Area Game.Connection Named by beta, gamemapping Pushed in the burst after a successful IdentificationRequest. THIS REPLACES, IT DOES NOT MERGE. The client swaps its whole enabled-feature set for this list and re-evaluates what is available; keeping stale ids from an earlier connection would enable features the server has since turned off. When you may send it Requires authenticated observed Related m

Somebody's availability changed - a contact's, or your own echoed back. Kind event Area Game.Social Named by beta, gamemapping Broadcast for any player whose status you can see - friends, guild and alliance members, party members - and for your own character, as the echo of PlayerStatusUpdateRequest. TWO IDS, AND THEY ARE DIFFERENT WIDTHS. player_id is the CHARACTER (int64); account_id is the ACCOUNT behind it (int32). Use the account id to track a person across their characters and the playe

Server reply to a ping; the client turns it into a round-trip latency sample. Kind event Area Game.Connection Named by beta, gamemapping Answers PingRequest. On receipt the real client takes the clock again, enqueues the round-trip delta into a bounded sample queue, and exposes average, maximum and sample count from it. THOSE SAMPLES ARE NOT SELF-CONTAINED. They are the source of the value reported when the server polls with BasicLatencyStatsEvent, so skipping the ping exchange leaves you wit

A moderator's warning: who sent it and what it says, shown to the player. Kind event Area Game.Moderation Named by gamemapping, beta A MODERATOR IS TALKING TO YOU. The server pushes this unprompted and the client renders the moderator's name and their message. If you are running anything automated, this arriving means a human has looked at your account and acted. Treat it as a stop signal, not as chat. WHAT IT CARRIES author the moderator's displayed name content the warn

The current step of one quest and its objectives. Kind event Area Game.Quest Named by beta, gamemapping The answer to QuestStepInformationRequest. The real content is information - a QuestActive carrying the quest and the step it is on. player_id is USUALLY ABSENT, because the answer goes to the character who asked. Do not require it to be present, and do not use it as the key to match the reply against your request - use the quest id inside information. When you may send it Requires char

Your position in the login queue while the server is full. Kind event Area Game.Character.Management Named by beta, gamemapping Arrives repeatedly while the account waits in the login queue, and stops once you are through. In a capture of an uncongested sign-in it still appears a few times in quick succession with a shrinking payload. WAIT, DO NOT RETRY. Receiving this means the server has your connection and is holding it; re-sending CharacterListRequest or reconnecting only puts you back at

Grants or refuses the token that skips full authentication on the next connection. Check the flag before the token. Kind event Area Game.Connection Named by beta, gamemapping Answers ReloginRequest, and it is the only thing worth waiting for in that exchange. CHECK THE FLAG BEFORE YOU READ THE TOKEN A REFUSAL IS NOT AN ERROR MESSAGE, and it is not silence - the server answers, the flag is simply clear. Read the flag first. If you read the token unconditionally you will carry an empty string

Empty server poll asking the client how many events it has received. Kind event Area Game.Basic Named by beta, gamemapping Carries no payload - the message IS the question. Answer it with SequenceNumberRequest carrying how many of these polls have reached you on this connection, the one you are answering included. COUNT THE POLLS, NOT YOUR INBOUND TRAFFIC. The real client keeps one counter per connection that nothing but this poll touches: zeroed when the socket becomes active, incremented on

The server's challenge in the proof-of-identity handshake. The one message in that chain whose contents you must read. Kind event Area Game.Client.Verification Named by beta, gamemapping Arrives because you sent ClientChallengeInitRequest, and must be answered with ClientChallengeProofRequest. THE HANDSHAKE DOES NOT COMPLETE UNTIL YOU DO. WHEN IT ARRIVES Shortly after your init request, and only then - the server does not send it on its own schedule. But it is delivered as an ordinary event:

The server's experience multipliers, sent once and kept for the session. Kind event Area Game.Server Named by beta, gamemapping THE SERVER'S EXPERIENCE MULTIPLIERS, sent once and kept for the session. There is no request for it and no refresh - it arrives unprompted early on. THE NUMBERS ARE OFFSET BY 100 - MOSTLY Two of the values are percentages expressed as a multiplier over normal, and the client subtracts 100 from each before storing them. A wire value of 200 becomes a stored 100, i.e.

The game session is ready to complete its cryptographic handshake. Kind event Area Game.Connection Named by beta, gamemapping Carries no payload. Arrival means the server is ready for the session handshake, and the client answers with ClientChallengeInitRequest. In a capture it closes the burst that follows acceptance of IdentificationRequest, and the answer goes out a few milliseconds later - notably as one of the rare CORRELATED requests, meaning the client allocates an envelope id for it a

The server's environment: language, community, ruleset and account limits. Kind event Area Game.Connection Named by beta, gamemapping Pushed once, in the burst that follows a successful IdentificationRequest. Nothing requests it. Worth storing rather than ignoring: it tells you which ruleset the server runs and whether the account is restricted to one character at a time, both of which change what later requests are legal. When you may send it Requires authenticated observed Related mes

Server-initiated challenge that obliges the client to identify itself. Kind event Area Game.Client.Verification Named by beta, gamemapping YOU MUST ANSWER THIS. The client's own handler ignores the event's contents entirely and replies with ClientIdRequest; nothing in the payload is needed to build the answer. The answer is not a constant. The real client generates fresh random handshake state, computes a modular exponentiation from it, and sends the result as a decimal string. A replayed or

The current state of one equipment set: which of its pieces are worn and which bonuses that grants. Kind event Area Game.Inventory Named by beta, gamemapping Sent when the character's equipment changes in a way that affects a set bonus. IT IS THE WHOLE STATE OF ONE SET, NOT A DELTA - REPLACE, DO NOT MERGE. The message names a set and lists every piece currently worn from it together with every bonus currently active. Removing a piece produces a new message with a SHORTER list, not a removal i

The full contents of one of the player's shortcut bars: spells, items, presets, emotes and cosmetics. Kind event Area Game.Inventory Named by beta, gamemapping One bar's worth of slots. It arrives once PER BAR during the connection burst, so expect several of these, distinguished by bar_type. IT IS ONE WHOLE BAR, NOT A SLOT UPDATE - REPLACE THAT BAR, DO NOT MERGE. A slot missing from the list is an empty slot. KEY YOUR MODEL BY bar_type, NOT BY ARRIVAL ORDER. Nothing guarantees the bars arri

One stated element changing state: a door opening, a lever thrown, a resource going from full to harvested. Kind event Area Game.Interactive Named by beta The delta counterpart of StatedMapUpdateEvent. THIS IS THE MESSAGE THAT TELLS YOU A RESOURCE WAS TAKEN. Combined with InteractiveElementUpdatedEvent it is how a harvesting script learns that a node it was heading for is no longer worth walking to - including when somebody else took it. Match by StatedElement.element_id and replace the elem

The state of every stated element on the map, sent when the character arrives. Kind event Area Game.Interactive Named by beta The map's stated-element snapshot, and the baseline that StatedElementUpdatedEvent deltas apply on top of. IT IS A SNAPSHOT - REPLACE, DO NOT MERGE. It arrives once per map arrival. Read it together with InteractiveMapUpdateEvent: the two lists describe the same objects from different angles and join on StatedElement.element_id. Neither alone tells you both what a nod

A system notification, sent as a message id plus arguments, optionally forcing a blocking display. Kind event Area Game.Chat Named by beta, gamemapping Like TextInformationEvent, this carries an id and arguments rather than text - but it is the SYSTEM notification path, and one flag on it matters a great deal. hang_up TRUE IS THE DISCONNECT WARNING. The client takes a different branch for it: before rendering anything it invokes an action on its connection service, and only then displays the

A system line pushed into the chat log, sent as a message id plus substitution arguments rather than as text. Kind event Area Game.Chat Named by beta, gamemapping ONE OF THE HIGHEST-VALUE INBOUND MESSAGES THERE IS. Almost everything the server tells you in words - fight results, PvP notices, item and object notifications, entity speech, event announcements - arrives here. THE SERVER DOES NOT SEND YOU TEXT. It sends message_id, an identifier into the client's own information-message table, plu

The server's wall-clock time and timezone offset, used to correct the client's own clock. Kind event Area Game.Basic Named by beta, gamemapping The server's clock. The client compares timestamp against its own UTC epoch milliseconds and stores two corrections: the raw skew, and the skew adjusted for timezone_offset. USE IT INSTEAD OF YOUR OWN CLOCK FOR ANYTHING THE SERVER TIMES. Cooldowns, regrowth timers and scheduled events are all reckoned against the server's clock, and a script running o

Whether the server considers this client session certified. Kind event Area Game.Connection Named by beta, gamemapping Pushed in the burst after a successful IdentificationRequest, carrying the server's own verdict on the client's integrity. A false value is not an error you can answer - there is no reply. It is the server telling you it has not certified this session, and it is worth logging if you ever see it, because a real client normally reports certified. When you may send it Requir

Life regeneration has ended; the message also carries life values the current client ignores. Kind event Area Game.Character Named by beta, gamemapping Ends the life regeneration that LifePointsRegenBeginEvent started. When it arrives the client stops its regeneration timer. THE CURRENT CLIENT DOES NOT READ ITS VALUES. The message declares two plain int32 and one int32 with explicit presence, which matches the reference build's life_points, max_life_points and optional life_points_gained. No