Requests

Casts one of the played fighter's spells on a map cell during its turn. Kind request · Area Game.Game.Action Casts a spell of the fighter you play on a map CELL. Use GameActionFightCastOnTargetRequest instead to cast on a fighter by its id. HOW TO SEND IT 1. Only during your own turn, in a fight. 2. spell_id = the spell's data-centre id (the spell template id, NOT a spell level id and NOT the action-bar slot). The official client reads it straight off the spell's data record. 3

Leaves the tutorial (guided mode) for the current character. No payload. Kind request · Area Game.Quest CARRIES NOTHING. Sending it asks the server to end the tutorial for this character. WHEN TO SEND IT Only while the character is in the tutorial. The official client sends it when the player clicks the tutorial's exit button and then picks "Quit" in the confirmation popup ("Leave the tutorial?"). Picking "Resume" sends nothing - the first click alone never sends this. The client can also s

Asks the server to perform one action of one interactive element on the current map: harvest, open a door, take a zaap, use a workshop. Kind request · Area Game.Interactive Asks the server to perform ONE action of ONE interactive element on the map you are standing on: harvest a resource, open a door, take a zaap, open a crafting workshop, the smithmagic table, the auction house, the crafter list or the guild creator, enter or manage a house. YOU ARE ASKING, NOT ACTING. Nothing has happened u

Toggles the character's listing in the crafter directory (job book) for each job id it carries. Kind request · Area Game.Exchange Lists the character in, or removes it from, the crafter directory (the "job book" other players search to find a crafter) for the given jobs. IT IS A TOGGLE, NOT A SET. The message carries only job ids; it does not say "on" or "off". The client sends exactly the jobs whose state must FLIP: - the switch of one job sends that one job id; - the switch that applies to

Asks the server to move the character to the neighbouring map after it walked onto an exit cell on that side of the current map. Kind request · Area Game.Gamemap Asks the server to move your character to the NEIGHBOURING map, the one beyond the edge of the current map you have walked to. This is how a character leaves a map by its north, east, south or west side. YOU ARE ASKING, NOT MOVING. The map changes only when the server answers with MapCurrentEvent - or its instanced form MapCurrentIns

Take back every capital point spent on the six base characteristics: they return to 0 and the points return to the capital. Sent empty. Kind request · Area Game.Character Undoes the characteristic points the character has spent: the six base characteristics go back to 0 and every point spent on them returns to the capital (StatsPoints). It is the opposite of CharacterCharacteristicUpgradeRequest. HOW TO SEND IT 1. SEND IT EMPTY. It has no member to fill. 2. NO CONFIRMATION, NO CHECK ON SEN

Asks to teleport to one destination of the open zaap, zaapi or prism list. Costs the destination's kamas. Kind request · Area Game.Teleportation Takes you to one destination of the list the server sent in TeleportDestinationsEvent. Send it while that picker is open. HOW TO BUILD IT 1. map_id = the chosen TeleportDestination.map_id. 2. destination_type = that destination's own TeleportDestination.type. 3. source_type = the list's kind, TeleportDestinationsEvent.type, unchanged -

Asks what travelling to the zaap on one map costs. Answered by WaypointPriceResponse. Kind request · Area Game.Teleportation This name is not Ankama's. It was chosen for this documentation from proven client behaviour, and is a label rather than protocol documentation. Asks the price of the zaap on map_id, from where the character stands. WHEN TO SEND IT Whenever you need a zaap's travel price before choosing it. The official client sends it from the world map: when the tooltip of a map wit

Saves the zaap you are using as your respawn point. No payload - the server knows which zaap you are at. Kind request · Area Game.Teleportation CARRIES NOTHING, AND DOES NOT NEED TO. You are at one zaap, in its picker; the server knows which one you mean. WHEN TO SEND IT While the zaap picker is open (after TeleportDestinationsEvent), when you want THIS zaap to become your respawn point. The official client asks first - "change your saved zaap from A to B?" - and sends it only when the playe

Buy a number of one item from the NPC shop you have open. Kind request · Area Game.Exchange Buys ExchangeBuyRequest.quantity units of one item from the NPC shop that ExchangeNpcShopStartedEvent opened. HOW TO SEND IT 1. PICK AN ITEM FROM THE SHOP'S STOCK. Copy its ItemMinimalInformation.object_gid into ExchangeBuyRequest.object_uid. Despite its name the field carries the item's TEMPLATE id, not the unique id of an object you own. 2. CHECK THAT YOU MAY BUY IT: its ItemToSellI

Ask for the market price history of one item. Kind request · Area Game.Inventory Asks the server for what one item has been selling for. The answer is ObjectAveragePricesHistoryEvent. HOW TO SEND IT 1. Put the item's template id in ObjectAveragePricesHistoryRequest.object_gid. 2. Send it, and wait for ObjectAveragePricesHistoryEvent. THE NAME IS OURS. The client's type-name table does not list this request (it has no nested type) and no reference build has the feature; the name pairs

Acknowledges a forced character selection. Empty payload. Kind request · Area Game.Character.Management Carries nothing - it only says "ready". 1. Wait for CharacterForceSelectionEvent. 2. Send this request, empty, as soon as the event arrives. 3. Send it once. The client guards it with a one-shot flag: a repeated event does not produce a second request. Any field a later build declares here is unused by the client and is left unresolved; send it empty. When you may send it Requires a

Buys one lot of one auction-house listing at the price you were shown. Kind request · Area Game.Exchange HOW TO BUY 1. Open the auction house in buy mode (ExchangeBidBuyerStartedEvent). 2. Get the item's listings: ExchangeBidHouseSearchRequest -> ExchangeTypesItemsExchangerDescriptionForUserEvent. Each BidExchangerObject carries an object_uid and one price per lot size. 3. Send this request: - object_uid = the listing you buy; - quantity = the lot size you buy (the client se

Asks the auction house for the current prices of one item before you put it on sale. Kind request · Area Game.Exchange HOW TO PRICE AN ITEM BEFORE SELLING IT 1. Open the auction house in sell mode (ExchangeBidSellerStartedEvent). 2. Send this request with object_gid = the item's TEMPLATE id (the gid, not the uid of your stack). 3. Wait for ExchangeBidPriceEvent: it gives the average price and the cheapest price currently listed for each lot size. 4. Choose your price, then sell with Exc

Asks the open auction house for every listing of one item, and starts or stops following that item. Kind request · Area Game.Exchange TO SEE THE OFFERS OF AN ITEM 1. Open the auction house (ExchangeBidBuyerStartedEvent) and pick an item id (GID), for example from ExchangeTypesExchangerDescriptionForUserEvent. 2. Send object_gid = that item, follow = true. 3. The answer is ExchangeTypesItemsExchangerDescriptionForUserEvent: one entry per listing, with its uid and prices. 4. While you

Asks the open auction house for the items of one item type, optionally following it for updates. Kind request · Area Game.Exchange 1. Open the auction house first (ExchangeBidBuyerStartedEvent). 2. Pick a type_id from that event's selling_conditions.types. 3. Send one request per type you want to see. Set follow to keep receiving changes for that type; the client's type filter sends one request per type it adds. 4. Read the answer: ExchangeTypesExchangerDescriptionForUserEvent lists t

Puts one lot of an inventory item on sale in the auction house at the price you choose. Kind request · Area Game.Exchange HOW TO SELL AN ITEM 1. Open the auction house in sell mode (ExchangeBidSellerStartedEvent). Its SellingConditions say which item types, lot sizes and level this house accepts, and the tax you will pay. 2. Optional: get the market prices with ExchangeBidHousePriceRequest. 3. Send this request: - object_uid = the uid of the stack in YOUR INVENTORY (not the gid);

Sets who besides the owner may enter the haven bag: the complete two-bit mask, friends and guild members. Kind request · Area Game.Haven.Bag Build permissions as a bit mask: bit 0 (value 1) shared with friends bit 1 (value 2) shared with guild members 1. Start from the mask the last HavenBagPermissionsUpdateEvent gave you. 2. Flip the bit you want to change. 3. Send the COMPLETE mask. The client never sends a delta: it recomputes friends + 2 * guild from both toggles every time. Send

Sets which extra storages (bank, haven bag) a crafting or auction-house window merges into its item list. Kind request · Area Game.Inventory 1. Set merged_inventory_type to the window you configure: auction house or crafting (craft and smith magic share one value). 2. Put in included_storages every storage to merge, from ObjectStorageKind: bank, haven bag, both, or none. The client always sends the complete set from both toggles, never a change. 3. An empty list means your inventory o

Asks to enter the haven bag of the character `owner` (the 'visit' entry of the friends and guild member lists). Kind request · Area Game.Haven.Bag Set owner to the character id of the player whose haven bag you want to enter: a friend or a guild member, as their contact entry gives it. Leave every other member at its default; the client never sets one. The client sends nothing else with it and waits for no direct answer: if the owner lets you in, you change map like any other map change. W

Saves the furniture layout of your haven bag: the whole layout, in slices of at most 40 Elements. Kind request · Area Game.Haven.Bag Send the COMPLETE furniture layout, never only what changed. One Element per piece. 1. Send HavenBagFurnitureOpenRequest (empty). 2. Cut the list into slices of at most 40 Elements, in order. Send one HavenBagFurnitureRequest per slice, with the slice in furniture. 3. Send HavenBagFurnitureCloseRequest (empty). The client sends all three steps in one go, wit

Plays an emote (sit, wave, an aura...) on your character. Kind request · Area Game.Emote Plays one of your emotes. HOW TO SEND IT 1. emote_id: an emote your character knows (the list comes with EmotesEvent). In the capture, 1 is sit (animation AnimEmoteSit). 2. auto_aura: leave it false. The client sets it to true only when it replays the aura of your current outfit by itself. 3. Respect the emote's cooldown: the client does not send an emote while its cooldown (from the e

Presses the exchange's go button: craft in a workshop, recycle, smith, or validate a trade. Kind request · Area Game.Exchange Says you are ready: in a workshop it launches the craft. HOW TO SEND IT 1. An exchange must be open (workshop, smithing, recycling, trade). 2. ready: true to launch / validate. A trade window also sends false to take its validation back. 3. step: the exchange's change counter. It is 0 when the exchange opens; the client adds 1 each time the multi-craft p

Selects the recipe to craft in the open workshop. Kind request · Area Game.Exchange Picks the recipe to craft in the workshop you have open. HOW TO SEND IT 1. A craft exchange must be open (the workshop window). 2. object_uid: the item id of the recipe's RESULT (the item the recipe makes, as in the game data's recipe list). It is NOT an inventory uid, whatever Ankama's member name says. 3. If you own every ingredient, send only this request. 4. If some are missing, the client

Moves an inventory item to a position: an equipment slot to equip it, or back to the bag to unequip it. Kind request · Area Game.Inventory Moves one of your items to a new position. HOW TO SEND IT 1. object_uid: the item's ObjectItem.uid from your inventory (not its template id, ObjectItem.gid). 2. position: where it goes, a client inventory position: - equipment slots: 0 amulet, 1 weapon, 2 left ring, 3 belt, 4 right ring, 5 boots, 6 hat, 7 cape, 8 pet, 9-14 the six Dofus