Events

The server telling the client which chat channels to switch on and which to switch off. Kind event Area Game.Chat Named by beta, gamemapping The server-side counterpart of SubscribeMultipleChannelRequest: two lists applied to your channel mask. ORDER MATTERS AND IT IS NOT OBVIOUS. The client ORs active_channels in FIRST, then AND-NOTs disabled_channels out. So A CHANNEL PRESENT IN BOTH LISTS ENDS UP OFF. Apply them in that order or you will disagree with the client about what you are subscrib

The community channel the server has actually placed this character on. Kind event Area Game.Social Named by beta, gamemapping The server's acknowledgement of SetCommunityChannelRequest, carrying the community it accepted. TAKE THIS VALUE, NOT THE ONE YOU SENT. The two can differ, and everything about which community channel you can read depends on this one. The ChannelUpdateEvent volley that actually re-states your subscriptions follows immediately after this message. When you may send it

One element has left the current context. This is the despawn message. Kind event Area Game.Context Named by beta, gamemapping THE DESPAWN. Process this or your world model only ever grows. element_id is the same id space as ActorPositionInformation.actor_id and InteractiveElement.element_id - a player, a monster, an NPC or an interactive object. Remove whatever you are holding under that id. A script that skips this will keep attacking monsters that are dead, walking to resources someone el

Announces that a dialog has closed, and which kind it was. Broadcast, not an acknowledgement. Kind event Area Game.Dialog Named by beta, gamemapping IT IS A BROADCAST, NOT AN ACKNOWLEDGEMENT. It says "a dialog of this kind has closed" - and the server sends it whether YOU closed the dialog or something else did: you walked away, the NPC ended it, it timed out. Do not treat it as the receipt for your DialogLeaveRequest. READ THE TYPE AND DECIDE IF IT IS YOURS. One member, a DialogType. The rea

The complete list of emotes you know. A replacement, not an addition. Kind event Area Game.Emote Named by beta, gamemapping THE WHOLE LIST, EVERY TIME. This is not "you learned an emote" - it is the complete set of emotes you know, sent as a replacement. Overwrite your state with it rather than merging into it. WHEN IT ARRIVES Once, unprompted, when your character loads. There is no request for it. Its siblings handle the deltas afterwards: one message adds a single emote and another removes

The ceiling on how much money you may move in one exchange. Sent once, kept for the session. Kind event Area Game.Exchange Named by beta, gamemapping A CEILING, NOT A BALANCE. It tells you the most money a single exchange may move. It says nothing about what you have. WHEN IT ARRIVES Once, early, unprompted. There is no request for it - the server volunteers it and the client stores it for the session. If you never see it, you have no limit information, not an unlimited one. WHAT TO DO WITH

An integrity challenge: the server names a game file and asks the client to measure it. Kind event Area Game.Client.Verification Named by beta, gamemapping AN INTEGRITY CHECK. The server names a file and an algorithm; the client measures that file and answers with FileCheckRequest. What the client actually does, in order: it sanitises file_name with a regular expression, resolves it BENEATH THE APPLICATION DATA DIRECTORY, checks the file exists, reads its bytes, and then either reports the by

Items the server hands the character as the result of an action - a reward, a gift, a craft outcome. Kind event Area Game.Inventory Named by beta, gamemapping Announces items the character has just been given, with a caption describing why. The client renders it as the "you received" panel. IT IS AN ANNOUNCEMENT, NOT AN INVENTORY UPDATE. The items listed here are minimal descriptions meant for display - see ItemMinimalInformation, whose quantity and template id are NOT recovered and must not

One or more actors have become visible on the current map. Kind event Area Game.Roleplay Named by beta, gamemapping The spawn message. Each entry is an ActorPositionInformation: who the actor is, where it stands, and what it looks like. IT IS ADDITIVE, NOT A SNAPSHOT. Unlike the map element events, this one adds to what you already know rather than replacing it - it is sent again whenever somebody walks into view. Add or update by ActorPositionInformation.actor_id and leave everything else al

Authentication against Ankama's web platform failed. The message carries no payload. Kind event Area Game.Haapi Named by stringtable THE FACT THAT IT ARRIVED IS THE WHOLE MESSAGE. It carries nothing: no code, no reason, no text. It is the failure counterpart of the shop-key family - the client logs it as an error during the API-key request - so it arrives on the path that would otherwise have produced BakApiKeyEvent or HaapiSessionEvent. TREAT IT AS A FAILURE OF THE WEB-PLATFORM INTEGRATIONS

The session identifier for Ankama's account and authentication web platform. Kind event Area Game.Haapi Named by stringtable Pushed during session bring-up, on the same service that handles the shop API key. It is never requested and cannot be replied to. The client's handler does exactly one thing: it forwards the string into its API-key service. NOTHING IN GAMEPLAY IS GATED ON IT, and a script that ignores it entirely loses nothing on the game protocol. The identifier is opaque - it identi

The rooms of the player's haven bag and the theme on each, sent either as a full list or as an amendment. Kind event Area Game.Haven.Bag Named by beta, gamemapping The player's haven bag is a private instanced house whose rooms each carry a theme. This event tells you what those rooms are, and it arrives in two quite different forms distinguished by one field. READ action FIRST - IT CHANGES WHAT THE LIST MEANS action = 0 the list is the COMPLETE set of rooms; replace what you hold action =

One interactive element re-published because its state changed - harvested, unlocked, become usable. Kind event Area Game.Interactive Named by beta The delta counterpart of InteractiveMapUpdateEvent: the server re-sending ONE element because something about it changed. RE-READ BOTH SKILL LISTS AND REPLACE THE ELEMENT WHOLESALE. The change is usually a skill MOVING between the enabled and disabled lists - a resource harvested, a door unlocking - so a script that only looks at InteractiveElemen

Every interactive element on the map, sent when the character arrives. The snapshot a harvest plan is built from. Kind event Area Game.Interactive Named by beta The map's interactive snapshot. Build your model of what is harvestable here, then keep it current by applying InteractiveElementUpdatedEvent on top. IT IS A SNAPSHOT, NOT A DELTA - REPLACE THE MAP'S ELEMENTS, DO NOT MERGE. It arrives once per map arrival, so treat each arrival as a fresh world. Drop any element whose InteractiveElem

An entity has started using an interactive element: the element, the skill, how long it takes, and whether it can still move. Kind event Area Game.Interactive Named by beta, gamemapping Announces the BEGINNING of an interaction - chopping a tree, mining an ore, opening a door, taking a zaap - not its result. Nothing here says whether the harvest succeeded or what it yielded. THE INTERACTION IS NOT INSTANT AND THIS IS WHERE YOU LEARN HOW LONG IT TAKES. duration is the run time the client scale

The character's entire inventory and kamas balance, pushed by the server as a full snapshot. Kind event Area Game.Inventory Named by beta The whole inventory in one message: every item the character holds, plus the kamas balance. IT IS A SNAPSHOT, NOT A DELTA - REPLACE YOUR MODEL, DO NOT MERGE. An item that is absent from this message is an item the character no longer has. A script that merges keeps phantom stacks forever, most visibly after a trade, a bank withdrawal, or any server-side res

How full your inventory is, and how full it can get. Both numbers, every time. Kind event Area Game.Inventory Named by beta, gamemapping BOTH NUMBERS, EVERY TIME. The server does not send "you gained 12 weight"; it sends the current weight and the ceiling together, so you can overwrite your state rather than accumulate into it. If you are tracking pods, this message IS your state - do not try to keep a running total from item pickups and drops. WHEN IT ARRIVES Whenever what you are carrying

How many kamas you are carrying. Kind event Area Game.Inventory Named by beta, gamemapping Your carried kamas. The inventory snapshot in InventoryContentEvent brings the first value; this message keeps it current afterwards. TREAT IT AS THE AMOUNT, NOT A CHANGE. The client hands the number unchanged to every open storage window as the kamas figure to display. Overwrite what you track rather than adding to it. ONLY THE WALLET YOU CARRY. Storage windows such as the bank listen to a different m

Your character started regenerating life, at the given rate. Kind event Area Game.Character Named by beta, gamemapping Regeneration has started. The client starts a local timer from the moment this arrives and keeps the rate, so the life shown between server updates is its own estimate. IT ENDS WITH UpdateLifePointsEvent. That message stops the same timer. IF YOU TRACK LIFE YOURSELF, do what the client does: remember when regeneration started and at what rate, and stop when the update arrive

An actor on the current map has turned to face a new direction. Kind event Area Game.Gamemap Named by beta, gamemapping Broadcast whenever any actor in your current roleplay context changes orientation - including your own character, echoing back your MapChangeOrientationRequest. IT IS A FIRE-AND-FORGET STATE PATCH. No timestamp, no throttling, no correlation. Apply it straight to your entity table: set that actor's facing and move on. There is nothing to acknowledge. Track other actors' fac

Everything on the map the character just loaded: actors, interactive and stated elements, running fights and the map's complement. Kind event Area Game.Gamemap Named by beta, gamemapping The contents of the map the character is on: who stands on it, its interactive and stated elements, the fights running on it, and one complement saying what kind of place it is. IT ARRIVES AFTER EVERY MAP LOAD. The client asks for it with MapInformationRequest each time a map finishes loading - teleport, zaap

The path an actor will actually walk, broadcast to everyone on the map. Kind event Area Game.Gamemap Named by beta, gamemapping The server granting a movement. THIS IS THE AUTHORITATIVE PATH - walk cells, not what you requested. It may be shorter. CHECK character_id AGAINST YOUR OWN BEFORE ACTING ON IT. The event is broadcast for every actor that moves on the map, so most of the ones you receive are other players and monsters. A script that treats every arrival as its own move will walk phant

The player's complete set of notification flags - the markers behind the interface's "new" badges. Kind event Area Game.Notification Named by beta, gamemapping The persisted markers behind the little "new" badges on menus, tabs and features. IT IS THE COMPLETE SET, NOT AN ADDITION - REPLACE, DO NOT MERGE. A flag missing from this message is a flag the player no longer has. There is a separate canonical sibling that REMOVES notifications and it carries an identical payload shape, so if you are

Your NPC action was refused. It carries no reason. Kind event Area Game.Npc Named by gamemapping THE NEGATIVE ANSWER TO NpcGenericActionRequest, AND IT IS EMPTY. It tells you THAT the action was refused and never why. There is no code, no reason string and no echo of what you asked for - so if you have more than one NPC action outstanding you cannot tell which one this refers to. SEND THEM ONE AT A TIME and treat this as the answer to the outstanding request. WHY IT MATTERS THAT IT IS EMPTY

The market average price of every tradeable item, as one list of item-and-price pairs. Kind event Area Game.Exchange Named by beta, gamemapping The answer to ObjectAveragePricesRequest: one entry per tradeable item, carrying the item's template gid and its average market price. It is what the client shows in item tooltips and in the auction house. IT ARRIVES AS AN EVENT, NOT A RESPONSE. There is no correlation id to match on - match it by arrival after your request. THE LIST IS HUGE. The obs