Smooth

One fighter's action point or movement point statistics (the same record serves both). Kind struct · Area Game.Fight One block of DetailedStatistics: what the official end-of-fight statistics screen shows for one fighter. Read the members you need; every value is already final (per-turn and per-AP values are averages, sent as floats). The client shows each member under its own localization key: - dodged: ui.fightResult.dodged - not_dodged: ui.fightResult.notDodged - removed: ui.fightResult.removed - removed_by_tackle: ui.fightResult.removedByTackle - dodged_per_turn: ui.fightResult.dodgedByTurn - not_dodged_per_turn: ui.fightResult.notDodgedByTurn - removed_per_turn: ui.fightResult.removedByTurn - spent_per_turn: ui.fightResult.spentByTurn Not sent on its own — a record carried by DetailedStatistics, never sent on its own. inferred Used by DetailedStatistics Fields #FieldTypeMeaningYou set it 1removedint32Points the fighter lost to removals. The official client shows it under ui.fightResult.removed.never 2spent_per_turnfloatAverage points spent per turn. The official client shows it under ui.fightResult.spentByTurn.never 3removed_per_turnfloatAverage points lost per turn. The official client shows it under ui.fightResult.removedByTurn.never 4not_dodgedint32Point removals the fighter did not dodge. The official client shows it under ui.fightResult.notDodged.never 5not_dodged_per_turnfloatAverage undodged removals per turn. The official client shows it under ui.fightResult.notDodgedByTurn.never 6dodgedint32Point removals the fighter dodged. The official client shows it under ui.fightResult.dodged.never 7removed_by_tackleint32Points the fighter lost to tackle. The official client shows it under ui.fightResult.removedByTackle.never 8dodged_per_turnfloatAverage dodged removals per turn. The official client shows it under ui.fightResult.dodgedByTurn.never

A player fighter. The record is empty: the fighter's id is the character id. Kind struct · Area Game.Fight The player branch of FighterIdentity.kind: a player fighter. The record is empty: the fighter's id is the character id. Not sent on its own — a branch of FighterIdentity.kind, never sent on its own. inferred Used by FighterIdentity

A paddock gauge effect on an item: the gauge's value and its cap. Kind struct · Area Game.Common An item effect branch of ObjectEffect; the official client turns it into its EffectInstancePaddockGauge effect. Not sent on its own — a branch of ObjectEffect, never sent on its own. inferred Used by ObjectEffect Fields #FieldTypeMeaningYou set it 1gauge_valueint32The gauge's current value. Stored into EffectInstancePaddockGauge.gaugeValue.never 3capint32The gauge's maximum. Stored into EffectInstancePaddockGauge.cap.never

An acquaintance's character that is online now. Kind struct · Area Game.Contact The AcquaintanceInformation.online of an acquaintance whose character is online. READ IT LIKE THIS 1. AcquaintanceInformation.OnlineInformation.character_id and AcquaintanceInformation.OnlineInformation.character_name identify the character. 2. AcquaintanceInformation.OnlineInformation.status is its availability, and AcquaintanceInformation.OnlineInformation.mood_smiley_id its mood smiley. 3. Ignore the nested record: it is the obfuscator's decoy. Not sent on its own — it travels inside AcquaintanceInformation.online. proven Used by AcquaintanceInformation Fields #FieldTypeMeaningYou set it 1character_idint64The online character's id.never 2character_namestringThe online character's name.never 3statusCharacterStatusThe character's availability status - see CharacterStatus.never 5mood_smiley_idint32The character's mood smiley.never

Whether a map obstacle lets you walk through its cell. Kind enum · Area Game.Gamemap Carried by MapObstacle.state. Two values (beta: OBSTACLE_OPENED = 0, OBSTACLE_CLOSED = 1); they keep their obfuscated names here. What the official client does: for each obstacle of a MapObstacleUpdateEvent it sets the cell's walkable flag (ClientCellData.mov) to (state == 0), so 0 opens the cell and the other value closes it. A bot should treat the cell as walkable only for value 0. Not sent on its own — an enum carried by MapObstacle.state, never sent on its own. inferred Used by MapObstacle No fields you may set.

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 that crosses those cells. Send nothing back. An unnamed map member is never read by the client; ignore it. When you may send it Requires context_ready inferred Related messages Unsolicited - nothing you send causes this the server sends it whenever an obstacle of your map changes state Fields #FieldTypeMeaningYou set it 2obstaclesrepeated MapObstacleThe obstacles whose state changed. Element type MapObstacle.never

A cell obstacle on the map (a door, a gate) and whether it is open or closed. Kind struct · Area Game.Gamemap One obstacle of the map: MapObstacle.cell_id is the cell it occupies, MapObstacle.state whether it is open or closed (beta: 0 opened, 1 closed). Treat a closed obstacle's cell as blocked when you compute a path. Not sent on its own — a record carried by MapComplementaryInformationEvent.obstacles, never sent on its own. inferred Used by MapComplementaryInformationEvent MapObstacleUpdateEvent Fields #FieldTypeMeaningYou set it 1stateObstacleStateWhether the obstacle is open or closed. Beta: 0 = OBSTACLE_OPENED, 1 = OBSTACLE_CLOSED; the values are not named here.never 2cell_idint32The cell the obstacle occupies.never

Where something is: world coordinates, subarea and map id. Kind struct · Area Game.Common A location: MapExtendedCoordinates.map_id is the map to travel to, MapExtendedCoordinates.world_x / MapExtendedCoordinates.world_y its world-map coordinates and MapExtendedCoordinates.sub_area_id its subarea. A party member's record carries one, so a bot can follow it. Other declared members are never read by the client: ignore them. Not sent on its own — a record carried by other messages (party members, houses), never sent on its own. inferred Used by PartyInvitationMemberInformation PartyMemberInformation Fields #FieldTypeMeaningYou set it 2sub_area_idint32The subarea: an id of the subareas game data.never 3world_yint32World-map Y coordinate.never 4world_xint32World-map X coordinate.never 6map_idint64The map id.never

The healing one fighter received during the fight. Kind struct · Area Game.Fight One block of DetailedStatistics: what the official end-of-fight statistics screen shows for one fighter. Read the members you need; every value is already final (per-turn and per-AP values are averages, sent as floats). The client shows each member under its own localization key: - total: ui.fightResult.healReceived - summon: ui.fightResult.bySummon - per_turn: ui.fightResult.byTurn The fourth member (a record the table flags decoy_3Type) is never shown. Ignore unnamed members. Not sent on its own — a record carried by DetailedStatistics, never sent on its own. inferred Used by DetailedStatistics Fields #FieldTypeMeaningYou set it 2summonint32Healing received from summons. The official client shows it under ui.fightResult.bySummon.never 3per_turnfloatAverage healing received per turn. The official client shows it under ui.fightResult.byTurn.never 4totalint32All healing received. The official client shows it under ui.fightResult.healReceived.never

The healing one fighter gave during the fight. Kind struct · Area Game.Fight One block of DetailedStatistics: what the official end-of-fight statistics screen shows for one fighter. Read the members you need; every value is already final (per-turn and per-AP values are averages, sent as floats). The client shows each member under its own localization key: - total: ui.fightResult.healDealt - summon: ui.fightResult.bySummon - action_point: ui.fightResult.byActionPoint - per_turn: ui.fightResult.byTurn The fifth member (a string) is never shown. Ignore unnamed members. Not sent on its own — a record carried by DetailedStatistics, never sent on its own. inferred Used by DetailedStatistics Fields #FieldTypeMeaningYou set it 1summonint32Healing given by the fighter's summons. The official client shows it under ui.fightResult.bySummon.never 2per_turnfloatAverage healing given per turn. The official client shows it under ui.fightResult.byTurn.never 3totalint32All healing given. The official client shows it under ui.fightResult.healDealt.never 4action_pointfloatHealing per action point spent. The official client shows it under ui.fightResult.byActionPoint.never

One gift of the gift panel: its title and items, plus the unique ids of the items given. Kind struct · Area Game.Game.Action One gift shown in the gift panel. GroupedGameActionItems.action is the GameActionItem (title and items); GroupedGameActionItems.item_uids the unique ids of the inventory objects given. The official client builds one gift entry from each group. Not sent on its own — a record carried by GameActionItemListEvent.groups, never sent on its own. inferred Used by GameActionItemListEvent Fields #FieldTypeMeaningYou set it 1item_uidsrepeated int64Unique ids of the inventory objects this gift gives. The client passes them as GameActionObject's giftItemUid.never 2actionGameActionItemThe gift: its title and the items it contains. A GameActionItem. Named after beta's actions list, which held these records directly.never

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 the server sends it when your character's death becomes final

A fighter is killed by the fighter that performs the action. Kind struct · Area Game.Action The kill branch of GameActionFightEvent: the action's source killed a fighter. WHAT TO DO WHEN YOU RECEIVE IT 1. The killer is the enclosing event's source_id, not a member of this record. 2. Kill.target_id is the fighter that was killed. 3. Only the fight log changes: the fighter's actual death comes in its own Death action. 4. SEND NOTHING BACK. WHAT THE CLIENT DOES. Writes "<killer> killed <target>" in the fight log (ui.fight.killed). Not sent on its own — it travels inside GameActionFightEvent (kill). proven Used by GameActionFightEvent Fields #FieldTypeMeaningYou set it 1target_idint64The fighter that was killed. (fighter (entity) id) The killer is the enclosing event's source_id.never

A friend's character that is online now. Kind struct · Area Game.Contact The FriendInformation.online_information of a friend whose character is online. READ IT LIKE THIS 1. FriendInformation.FriendOnlineInformation.character_id and FriendInformation.FriendOnlineInformation.character_name identify the character. 2. FriendInformation.FriendOnlineInformation.status, FriendInformation.FriendOnlineInformation.guild, FriendInformation.FriendOnlineInformation.gender and FriendInformation.FriendOnlineInformation.alignment describe it; FriendInformation.FriendOnlineInformation.haven_bag_shared says whether its haven bag is open to you. 3. The int32 members (level, breed, mood smiley in beta) and the alliance record are not named yet. Not sent on its own — it travels inside FriendInformation.online_information. proven Used by FriendInformation Fields #FieldTypeMeaningYou set it 1guildGuildInformationThe character's guild - see GuildInformation.never 3haven_bag_sharedboolWhether the character's haven bag is open to you.never 4statusCharacterStatusThe character's availability status - see CharacterStatus.never 5character_idint64The online character's id.never 7alignmentAlignmentThe character's alignment - see Alignment.never 8genderGenderThe character's gender - see Gender.never 12character_namestringThe online character's name.never

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 1friendrepeated FriendInformationEvery friend - see FriendInformation.never

One friend: the account, its state, and its online character. Kind struct · Area Game.Contact One entry of FriendListEvent.friend. READ IT LIKE THIS 1. FriendInformation.account_tag names the account (see AccountTag). 2. FriendInformation.state says whether one of its characters is online (values not named yet; 0 is offline in beta). 3. When it is online, FriendInformation.online_information gives that character - see FriendInformation.FriendOnlineInformation. 4. The two int64 (account id and hours since the last connection, in beta) and the int32 are not named yet. Not sent on its own — it travels inside FriendListEvent.friend. proven Used by FriendListEvent Fields #FieldTypeMeaningYou set it 3online_informationFriendOnlineInformationThe online character, when there is one - see FriendInformation.FriendOnlineInformation.never 6statetype not documented yetWhether one of the account's characters is online, and where; values not named yet.never 7account_tagAccountTagThe friend's account name and tag - see AccountTag.never

Release your dead character's soul: from a tombstone, become a ghost. Kind request · Area Game.Character After your character died (it lies as a tombstone), release its soul to become a ghost and walk to a phoenix. WHAT TO DO Send it with no content. Expect CharacterLifeStatusEvent with your new state and CharacterRestrictionsEvent with the ghost's restrictions. Any member the message declares is padding: leave it unset. When you may send it Requires context_ready inferred Related messages Nothing answers it - send it and move on the server answers with your new life status, not with a reply to this request No fields you may set.

Whether a treasure hunt flag request worked. Kind enum · Area Game.Treasure.Hunt Carried by TreasureHuntFlagAnswerEvent.result. Only SAME_MAP is named: the official client shows one generic failure for five of the other values (beta: ERROR_UNDEFINED, WRONG, TOO_MANY, ERROR_IMPOSSIBLE, WRONG_INDEX) and nothing for the sixth (beta: OK). Not sent on its own — an enum carried by TreasureHuntFlagAnswerEvent.result, never sent on its own. inferred Used by TreasureHuntFlagAnswerEvent Values ValueNumberMeaning SAME_MAP6You already have a flag on this map. ui.treasureHunt.flagFailSameMap.

A monster fighter. Kind struct · Area Game.Fight The monster branch of FighterIdentity.kind: a monster fighter. The record carries one int32 the client stores but never uses; it is not named. Not sent on its own — a branch of FighterIdentity.kind, never sent on its own. inferred Used by FighterIdentity No fields you may set.

A player's companion fighter, with the player it belongs to. Kind struct · Area Game.Fight The companion branch of FighterIdentity.kind: a player's companion fighter, with the player it belongs to. Read master to find the companion's owner; ignore the unnamed int32. Not sent on its own — a branch of FighterIdentity.kind, never sent on its own. inferred Used by FighterIdentity Fields #FieldTypeMeaningYou set it 1masterFighterIdentityThe player the companion belongs to. A FighterIdentity. fa.muk rebuilds it as a PLAYER identity (ey) and stores it in the companion class; FightResultStatsTab matches a fighter against it to find the companion of the shown player.never

Who a fighter is: its id, its team, and whether it is a player, a monster, a companion or a summon. Kind struct · Area Game.Fight Identifies one fighter in DetailedStatistics (the end-of-fight statistics). WHAT TO READ 1. id: the fighter's id (your character id for you; negative ids for monsters and summons). 2. team: the fighter's side (Team). 3. kind: exactly one branch is set: - player: a player character; - monster: a monster; - companion: a player's companion; its master is the owning player; - summon: a summon; its summoner is the fighter that summoned it. To attach a summon's or companion's statistics to its owner, follow summoner / master (they are FighterIdentity records too). An unnamed enum member is never used; ignore it. Not sent on its own — a record carried by DetailedStatistics.fighter, never sent on its own. inferred Used by DetailedStatistics FighterIdentity.Companion Summon Fields #FieldTypeMeaningYou set it 1idint64The fighter's id: the character id for a player, a negative id for a monster or summon. (entity id)never 7teamTeamThe fighter's side. A Team.never 2monsterFighterIdentity.MonsterSet when the fighter is a monster. A FighterIdentity.Monster. Branch of kind. Named after its branch type, which the type-name table spells.never 3summonSummonSet when the fighter is a summon. A FighterIdentity.Summon. Branch of kind. Named after its branch type, which the type-name table spells.never 4companionFighterIdentity.CompanionSet when the fighter is a player's companion. A FighterIdentity.Companion. Branch of kind. Named after its branch type, which the type-name table spells.never 5playerPlayerSet when the fighter is a player character. A FighterIdentity.Player. Branch of kind. Named after its branch type, which the type-name table spells.never

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 FightPlacementSwapPositionsCancelRequest, both carrying the request id. 3. If you made the request, wait for FightPlacementSwapPositionsEvent (done) or FightPlacementSwapPositionsCancelledEvent (refused or cancelled). WHICH SIDE YOU ARE ON. The message carries two fighter ids. The client compares each with your own character id: one match makes you the requester (it shows ui.fight.swapPositionRequest with a cancel link), the other makes you the target. Those two ids are not named yet; until they are, compare both with your character id. When you may send it Requires context_ready inferred Related messages Unsolicited - nothing you send causes this the server sends it to both fighters when one of them asks to swap places Fields #FieldTypeMeaningYou set it 1request_idint32The offer's id; the accept and cancel requests carry it back. The client passes it to HyperlinkSwapPositionRequest.CreateLink's requestId.never

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 minus one as the turns left before the next wave (a negative result means the last wave has come). 3. Expect the new monsters as ordinary fighters (they are announced like any summon). When you may send it Requires context_ready inferred Related messages Unsolicited - nothing you send causes this the server sends it when a wave of monsters arrives in your fight Fields #FieldTypeMeaningYou set it 3teamTeamThe team whose wave counters these are - see Team. The only member of the Team enum type.never

Sell one of your items to the NPC shop you have open. Kind request · Area Game.Exchange Sells quantity units of the inventory item object_uid to the open NPC shop. WHAT TO DO 1. Set object_uid to the item's unique id in your inventory (not its template id). 2. Set quantity. Leave every other member unset: the official client never fills them. When you may send it Requires exchange_open inferred Related messages Nothing answers it - send it and move on the server answers with the inventory and kamas updates of the sale Fields #FieldTypeMeaningYou set it 1quantityint32How many units to sell. (count)always 4object_uidint32The inventory item to sell, by its unique id. (object uid)always

Move the listed storage items into your inventory. Kind request · Area Game.Exchange Moves items from the storage into your inventory while a storage (bank) is open. WHAT TO DO Fill objects_uid with the uids of the items to move (at most 800 per request: the official client splits a longer selection into several requests). Expect the storage and inventory update events in return. When you may send it Requires exchange_open inferred Related messages Nothing answers it - send it and move on the server reports the moved items through the storage and inventory update events, not with a reply Fields #FieldTypeMeaningYou set it 1objects_uidrepeated int32The items to move, by object uid. (object uid) The official client sends at most 800 uids per request and splits a longer selection.always