MsgItem
This message is received by the game server as a client request to use or act on an item. Item actions can be buying, selling, equipping, repairing, dropping, upgrading, and more. A miscellaneous function of this message is as a ping response. The client sends this message once every 10 seconds to show the latency to the server in the client.
The message can also be sent to the client for specific actions such as force unequipping, force dropping, updating the durability of an item, or updating the amount of an item.
⚠️ WARNING
Ensure that the item type for item improvements matches the consumption item type when improving items. If composing two items together, ensure that the fuel item is also different than the improved item. In all cases, location should also be validated (you cannot upgrade an item from any distance or from any map, same with vending items at player booths). If showing an item, generate a new sharing identifier rather than exposing the item's unique identifier.
Requests
Requests can be of multiple sizes, not necessarily always containing an amount or additional fields past the system time. When processing these request messages, this should be taken into account so not to use fields that have been unspecified.
Responses
Most item actions are initiated by the player. Each request expects a response of either MsgItem (this message) with a filled data field, or a MsgItemInfo of the resulting item (like from a shop purchase).
Table of Contents
Patch 4267
Message Definition
☑️ Assumed (Observed) - CoFuture + Soul
| Pos | Type | Name | Description | Example |
|---|---|---|---|---|
| 0 | UInt16 | MsgSize | Size of the message | 20 |
| 2 | UInt16 | MsgType | Type of message | 1009 |
| 4 | UInt32 | ID | Unique identifier for the item or role | 1000000 |
| 8 | UInt32 | Data | Payload usually of the item type or position | 730001 |
| 12 | UInt32 | Action | How to processes the message | 2 |
| 16 | UInt32 | System Time | Milliseconds of system uptime | 1579535985 |
Item Action
☑️ Assumed (Observed) - CoFuture + Soul
🔶 Response data
| Val | Name | Description | Recipient | ID | Data |
|---|---|---|---|---|---|
| 1 | BUY | Purchase from shop | Server | NPC | Item Type |
| 2 | SELL | Sell to shop | Server | NPC | Item ID |
| 3 | DROP | Drops an item or removes it | Server | Item | LOW: X HIGH: Y 🔶 |
| 4 | EQUIP | Equip to position on body | Server | Item | Position |
| 5 | UPDATE | Updates an item | Client | Item | Position |
| 6 | UNEQUIP | Force unequip | Client | Item | Position |
| 8 | COMBINE | Combine two of same type | Server | Item | Item ID |
| 9 | QUERY_MONEY | Request warehouse money | Server | NPC | Money 🔶 |
| 10 | SAVE_MONEY | Deposit warehouse money | Server | NPC | Money |
| 11 | DRAW_MONEY | Withdraw warehouse money | Server | NPC | Money |
| 12 | DROP_MONEY | Drop money on the floor | Server | Money | LOW: X HIGH: Y |
| 14 | REPAIR | Repair durability | Server | Item | |
| 17 | DURABILITY | Update durability | Client | Position | Durability |
| 18 | DROP_EQUIPMENT | Force delete equipment | Client | Item | Position |
| 19 | IMPROVE | Quality upgrade | Server | Item | Dragonball Item ID |
| 20 | UPLEV | Level upgrade | Server | Item | Meteor Item ID |
| 21 | BOOTH_QUERY | Show booth item | Server | Item | |
| 22 | BOOTH_ADD | Add to booth | Server | Item | Money |
| 23 | BOOTH_DEL | Remove from booth | Server | Item | Shop |
| 24 | BOOTH_BUY | Buy from a booth | Server | Item | Shop |
| 27 | PING | Latency check | Server | Player |
Patch 5017
Message Definition
☑️ Assumed (Observed) - ApexConquer
| Pos | Type | Name | Description | Example |
|---|---|---|---|---|
| 0 | UInt16 | MsgSize | Size of the message | 24 |
| 2 | UInt16 | MsgType | Type of message | 1009 |
| 4 | UInt32 | ID | Unique identifier for the item or role | 1000000 |
| 8 | UInt32 | Data | Payload usually of the item type or position | 730001 |
| 12 | UInt32 | Action | How the server processes the message | 2 |
| 16 | UInt32 | System Time | Milliseconds of system uptime | 1579535985 |
| 20 | UInt32 | Amount | Amount of items being purchased or used | 0 |
Item Action
☑️ Assumed (Observed) - ApexConquer
🔶 Response data
| Val | Name | Description | Recipient | ID | Data |
|---|---|---|---|---|---|
| 1 | BUY | Purchase from shop | Server | NPC | Item Type |
| 2 | SELL | Sell to shop | Server | NPC | Item ID |
| 3 | DROP | Drops an item or removes it | Server | Item | LOW: X HIGH: Y 🔶 |
| 4 | EQUIP | Equip to position on body | Server | Item | Position |
| 5 | UPDATE | Updates an item | Client | Item | Position |
| 6 | UNEQUIP | Force unequip | Client | Item | Position |
| 8 | COMBINE | Combine two of same type | Server | Item | Item ID |
| 9 | QUERY_MONEY | Request warehouse money | Server | NPC | Money 🔶 |
| 10 | SAVE_MONEY | Deposit warehouse money | Server | NPC | Money |
| 11 | DRAW_MONEY | Withdraw warehouse money | Server | NPC | Money |
| 12 | DROP_MONEY | Drop money on the floor | Server | Money | LOW: X HIGH: Y |
| 14 | REPAIR | Repair durability | Server | Item | |
| 17 | DURABILITY | Update durability | Client | Position | Durability |
| 18 | DROP_EQUIPMENT | Force delete equipment | Client | Item | Position |
| 19 | IMPROVE | Quality upgrade | Server | Item | Dragonball Item ID |
| 20 | UPLEV | Level upgrade | Server | Item | Meteor Item ID |
| 21 | BOOTH_QUERY | Show booth item | Server | Item | |
| 22 | BOOTH_ADD | Add to booth | Server | Item | Money |
| 23 | BOOTH_DEL | Remove from booth | Server | Item | Shop |
| 24 | BOOTH_BUY | Buy from a booth | Server | Item | Shop |
| 27 | PING | Latency check | Server | Player | |
| 28 | ENCHANT | Enchant item | Server | Item | Gem Item ID |
| 29 | BOOTH_ADD_EMONEY | Add EMoney to booth | Server | Item | EMoney |
Patch 5517
Message Definition
☑️ Assumed (Observed) - ApexConquer
| Pos | Type | Name | Description | Example |
|---|---|---|---|---|
| 0 | UInt16 | MsgSize | Size of the message | 60 |
| 2 | UInt16 | MsgType | Type of message | 1009 |
| 4 | UInt32 | ID | Unique identifier for the item or role | 1000000 |
| 8 | UInt32 | Data | Payload usually of the item type or position | 730001 |
| 12 | UInt32 | Action | How the server processes the message | 2 |
| 16 | UInt32 | System Time | Milliseconds of system uptime | 1579535985 |
| 20 | UInt32 | Amount | Amount of items being purchased or used | 0 |
| 24 | UInt32[9] | Equipment | Equipment in order of slot position | 0 |
Item Action
☑️ Assumed (Observed) - ConquerServerV3
🔶 Response data
| Val | Name | Description | Recipient | ID | Data |
|---|---|---|---|---|---|
| 1 | BUY | Purchase from shop | Server | NPC | Item Type |
| 2 | SELL | Sell to shop | Server | NPC | Item ID |
| 4 | EQUIP | Equip to position on body | Server | Item | Position |
| 5 | UPDATE | Updates an item | Client | Item | Position |
| 6 | UNEQUIP | Force unequip | Client | Item | Position |
| 9 | QUERY_MONEY | Request warehouse money | Server | NPC | Money 🔶 |
| 10 | SAVE_MONEY | Deposit warehouse money | Server | NPC | Money |
| 11 | DRAW_MONEY | Withdraw warehouse money | Server | NPC | Money |
| 14 | REPAIR | Repair durability | Server | Item | |
| 17 | DURABILITY | Update durability | Client | Position | Durability |
| 18 | DROP_EQUIPMENT | Force delete equipment | Client | Item | Position |
| 19 | IMPROVE | Quality upgrade | Server | Item | Dragonball Item ID |
| 20 | UPLEV | Level upgrade | Server | Item | Meteor Item ID |
| 21 | BOOTH_QUERY | Show booth item | Server | Item | |
| 22 | BOOTH_ADD | Add to booth | Server | Item | Money |
| 23 | BOOTH_DEL | Remove from booth | Server | Item | Shop |
| 24 | BOOTH_BUY | Buy from a booth | Server | Item | Shop |
| 27 | PING | Latency check | Server | Hero | |
| 28 | ENCHANT | Enchant item | Server | Item | Gem Item ID |
| 29 | BOOTH_ADD_EMONEY | Add EMoney to booth | Server | Item | EMoney |
| 33 | DETAIN_REDEEM | Redeem a detained item | Server | Item | |
| 35 | SOCKET | Socket a talisman | Server | Item | Item ID |
| 36 | SOCKET_EMONEY | Socket talisman with EMoney | Server | Item | EMoney |
| 37 | DROP | Drops an item or removes it | Server | Item | |
| 38 | DROP_MONEY | Drop money on the floor | Server | Money | |
| 40 | UPBLESS | Upgrade bless | Server | Item | |
| 41 | SHOW_ACCESSORY | Show an accessory | Server | Item | |
| 46 | SHOW_EQUIPMENT | Response for MsgAction | Client | Hero | |
| 48 | COMBINE | Combine two of same type | Server | Item | Item ID |
| 49 | SPLIT | Split into two | Server | Item | |
| 52 | SHOW_ITEM | Item card | Client | Item |