Events

Someone was invited into your party and has not answered yet. Kind event · Area Game.Party A player was invited into a party and has not answered yet. WHAT TO DO WHEN YOU RECEIVE IT 1. Ignore it unless PartyNewGuestEvent.party_id is your party's id (PartyJoinEvent.party_id). 2. Add PartyNewGuestEvent.guest (PartyGuest) to the party's pending guests. 3. SEND NOTHING BACK. The declared string list is never read by the client: ignore it. When you may send it Requires context_ready

A player joined your party. Kind event · Area Game.Party A player joined your party. WHAT TO DO WHEN YOU RECEIVE IT 1. Ignore it unless PartyNewMemberEvent.party_id is your party's id (PartyJoinEvent.party_id). 2. Add PartyNewMemberEvent.member (Character) to the members (update it if already listed), and drop them from the pending guests. 3. SEND NOTHING BACK. The declared string-to-int32 map is never read by the client. When you may send it Requires context_ready inferre

Whether your party is restricted changed. Kind event · Area Game.Party The party's restricted flag changed. WHAT TO DO WHEN YOU RECEIVE IT 1. Store PartyRestrictedEvent.restricted as your party's restricted flag (PartyJoinEvent.restricted). 2. SEND NOTHING BACK. The client reads nothing else: neither declared int32 is read, so the party id is not checked here. When you may send it Requires context_ready inferred Related messages Unsolicited - nothing you send causes this infe

An NPC of your map plays a named animation. Kind event · Area Game.Npc Make an NPC of the map play an animation given by name, without going through an emote. WHAT TO DO WHEN YOU RECEIVE IT 1. Find the NPC PlayAnimationOnNpcEvent.npc_id on the map. The official client waits until that NPC is on the map before going on. 2. Play PlayAnimationOnNpcEvent.animation on it. 3. SEND NOTHING BACK. When you may send it Requires context_ready inferred Related messages Unsolicited - not

An NPC of your map plays an emote. Kind event · Area Game.Npc Make an NPC of the map play an emote, as EmotePlayEvent does for players. WHAT TO DO WHEN YOU RECEIVE IT 1. Find the NPC PlayEmoteOnNpcEvent.npc_id on the map. The official client waits until that NPC is on the map before going on, so the message may arrive before the NPC. 2. If PlayEmoteOnNpcEvent.emote_id is 0, return the NPC to its normal animation. 3. Otherwise look the emote up in the emoticons game data and play its

A fight shown on the current map is gone: forget it. Kind event · Area Game.Roleplay A fight that was shown on the current map is gone: it ended, or it can no longer be joined or watched. WHAT TO DO WHEN YOU RECEIVE IT 1. Remove the fight RemoveChallengeEvent.fight_id from the fights you track on the map (the ones ShowChallengeEvent announced and FightTeamUpdateEvent kept up to date): its swords marker disappears. 2. Stop offering to join or spectate it. The official client also

The answer to your mood change: the result and the smiley. Kind event · Area Game.Social The server's answer to SetMoodRequest. WHAT TO DO WHEN YOU RECEIVE IT 1. Read SetMoodEvent.result. In the capture it was absent (0) on a successful change. Its values are not named yet (beta: OK, ERROR_UNKNOWN, ERROR_FLOOD). 2. Store SetMoodEvent.smiley_id as your mood smiley. 3. SEND NOTHING BACK. The declared int64 is never read by the client. When you may send it Requires context_ready i

A character on your map played a smiley: show it above them. Kind event · Area Game.Social A character played a smiley: show it in a bubble above them. It arrives for your own smileys (after SmileyRequest) and for other characters on the map. WHAT TO DO WHEN YOU RECEIVE IT 1. Find the character SmileyEvent.entity_id among the map's actors; ignore the message if it is not shown. 2. Look SmileyEvent.smiley_id up in the smileys game data and show it above that character. The officia

The player you looked up with /whois does not exist or is not connected. Kind event · Area Game.Basic The negative answer to a /whois lookup: nobody matches the name or account tag you searched for. TO SHOW IT 1. Read WhoIsNoMatchEvent.target: the search you sent, echoed back. 2. Print the name (or account tag) it holds in the "player not found" line. The client writes the character name or the account name and tag, whichever branch of PlayerSearch is set. Ignore every other mem

Your whole block list: every account you have blocked. Kind event · Area Game.Social The full block list. It replaces the one you hold. Blocking lasts: the server keeps the list and sends it again. Ignoring does not: an ignored account is never in this list. The ignore list lives only for the session; the official client starts it empty and only IgnoreEvent adds to it. No message sends an ignore list. TO HANDLE IT 1. Replace your block list with BlockListEvent.blocked: one ContactInfor

One page of the houses for sale that match your current estate-agency search. Kind event · Area Game.House Answers HousesToSellRequest. The search is the last HousesToSellFiltersRequest you sent. TO READ IT 1. HousesToSellEvent.houses holds this page's houses, one entry each. 2. HousesToSellEvent.page_index is the page this is. HousesToSellEvent.total_page is how many pages the search has. The official client shows its page bar only when there is more than one page, and its

The outcome of an ignore request: the account now ignored, or why it was refused. Kind event · Area Game.Social Answers IgnoreRequest with one of two outcomes, carried in a oneof. TO HANDLE IT 1. Check which branch of IgnoreEvent.result is set. 2. IgnoreEvent.success: the account is now on your ignore list. Its payload is an IgnoreEvent.Success: add IgnoreEvent.Success.ignored, a ContactInformation, to your list, keyed by its account id. The client also prints a chat line na

Your whole acquaintance list (players you met). Kind event · Area Game.Contact The answer to AcquaintanceListRequest: the whole list, every time. READ IT LIKE THIS 1. Replace your list with AcquaintanceListEvent.acquaintance (one AcquaintanceInformation per account). 2. Each entry carries the account and, when a character of it is online, that character. 3. Ignore the other members. When you may send it Requires character_loaded inferred Related messages Arrives after Acquaintanc

The current Almanax day, as an id of the Almanax calendar game data. Kind event · Area Game.Basic Tells the client which day of the Almanax calendar it is. READ IT LIKE THIS 1. Look AlmanachCalendarDateEvent.date_id up in the Almanax calendar game data (AlmanaxCalendars): that entry is today's Almanax (its offering, bonus and NPC). 2. Ignore the other members. 3. SEND NOTHING BACK. When you may send it Requires character_loaded inferred Related messages Unsolicited - nothing

Your account is already connected elsewhere; this session is refused. Kind event · Area Game.Connection The account already has a live session. The server will close this connection. WHAT TO DO Stop: do not retry immediately. Wait for the other session to end (or end it) and log in again. The message carries no data you need; its members are padding the client never reads. Not sent on its own — the server sends it during authentication when the account already has a session. inferred Rela

The list of things a character may not do right now (attack, exchange, move...). Kind event · Area Game.Character Replaces the restrictions of one character. WHAT TO DO 1. Read character_id. If it is your own character, these are YOUR restrictions; otherwise they belong to that character on your map. 2. Replace that character's restriction set with restrictions (Restriction values; an empty list lifts every restriction). Use it to know what you may do before sending a request (f

In a fight with waves of monsters, the wave counter of one team changed. Kind event · Area Game.Fight Fights against monsters that arrive in waves (some dungeons) show, per team, the current wave and how many turns remain before the next one. READ IT LIKE THIS 1. FightNewWaveEvent.team says which side the counters belong to - see Team. 2. The two int32 members are the counters. They are identified but not yet named (see below): the client shows field 2 as the current wave, and field 1

During placement, a fighter of your team asked another to swap their starting cells. Kind event · Area Game.Fight.Preparation A swap request between two fighters of one team, during placement. Both the requester and the target receive it. READ IT LIKE THIS 1. Keep FightPlacementSwapPositionsOfferEvent.request_id: the answer requests name the offer by it. 2. If you are the target, accept with FightPlacementSwapPositionsAcceptRequest or refuse with FightPlacementSwapPositionsCancelReque

Your whole friend list. Kind event · Area Game.Contact The answer to FriendListRequest: the whole list, every time. READ IT LIKE THIS 1. Replace your list with FriendListEvent.friend (one FriendInformation per account). 2. Each entry carries the account and, when a character of it is online, that character. 3. Ignore the other members. When you may send it Requires character_loaded inferred Related messages Arrives after FriendListRequest Fields #FieldTypeMeaningYou set it 1fr

Your character died for good (a hardcore character's final death). Kind event · Area Game.Character Your character's death is final: the official client sets its life state to the game-over state and announces the change. WHAT TO DO Stop playing this character; nothing else can be done with it. The message is empty. When you may send it Requires context_ready inferred Related messages Unsolicited - nothing you send causes this inferred — the server sends it when your character's deat

Some obstacles of the current map opened or closed (doors, bridges, moving blocks). Kind event · Area Game.Gamemap Some obstacles of the current map changed state. Sent while you are on the map, for example when a door opens or a bridge appears. WHAT TO DO 1. For each MapObstacle in obstacles, look up its cell_id and update the cell's walkability: the official client makes the cell walkable when state is 0 (beta: OBSTACLE_OPENED) and blocks it otherwise. 2. Recompute any path tha

Every alliance prism of the server, at login. Kind event · Area Game.Prism The full list of prisms. Later changes arrive one by one as PrismAddOrUpdateEvent and PrismRemoveEvent. READ IT LIKE THIS 1. Replace your prism table with PrismListEvent.prism_localized_information, keyed by PrismLocalizedInformation.sub_area_id. 2. Ignore the other list: the client never reads it. 3. SEND NOTHING BACK. When you may send it Requires character_loaded inferred Related messages Unsolicit

The server asks you to reconnect to a (possibly other) game server with a token. Kind event · Area Game.Connection The server ends this game session and tells you where to continue. WHAT TO DO 1. Read valid_token, token and server_id. 2. Close this connection. If valid_token is true, connect to game server server_id and authenticate there with token; otherwise go back through the normal login. The official 3.7 client does not read the members: its handler only drives its own connecti

The server's answer to a treasure hunt start: OK or why it was refused. Kind event · Area Game.Treasure.Hunt Tells you whether a treasure hunt could start. WHAT TO DO 1. Read result (TreasureHuntAnswerEvent.Result). OK means the hunt started: expect TreasureHuntEvent with its first steps. Any other value is the reason it did not (no hunt found, you already have one, not available, daily limit reached). 2. quest_type (TreasureHuntType) says which kind of hunt this answers. When

The result of digging for the treasure (or checking the current step). Kind event · Area Game.Treasure.Hunt Tells you what your dig did. WHAT TO DO 1. Read result (TreasureHuntDigAnswerEvent.DigResult): - NEW_HINT: the step is validated; expect TreasureHuntEvent with the next hints; - FINISHED: the hunt is complete (fight the chest guardian or collect the reward); - WRONG / WRONG_AND_YOU_KNOW_IT: one or more flags are wrong; check wrong_flag_count, move or remove flags