From 403c22bc4b4da0893b04a3b02d823bc5c0febd9a Mon Sep 17 00:00:00 2001 From: Euphy Date: Sun, 31 Aug 2014 12:09:38 -0400 Subject: [PATCH] Documentation cleaning. - Formatting and grammar edits on recently added docs. - Added missing NPC header and script conf include from ea8ccfc. - Moved ER model files to a separate folder ('doc/model/'). Fixed a typo in Wolfchev instance. (bugreport:9263) http://rathena.org/board/tracker/issue-9263-wolfchevlaboratory-script-error/ Signed-off-by: Euphy --- doc/{ => model}/Model_Relation.mwb | Bin doc/{ => model}/Model_Relation.png | Bin doc/{ => model}/rathena.vpp | Bin doc/packet_client.txt | 6 +- doc/packet_interserv.txt | 2511 ++++++++++++++++++++++- doc/skill_require_db.txt | 68 +- npc/re/instances/WolfchevLaboratory.txt | 2 +- npc/scripts_test.conf | 1 + npc/test/infinite_warp.txt | 10 + 9 files changed, 2568 insertions(+), 30 deletions(-) rename doc/{ => model}/Model_Relation.mwb (100%) rename doc/{ => model}/Model_Relation.png (100%) rename doc/{ => model}/rathena.vpp (100%) diff --git a/doc/Model_Relation.mwb b/doc/model/Model_Relation.mwb similarity index 100% rename from doc/Model_Relation.mwb rename to doc/model/Model_Relation.mwb diff --git a/doc/Model_Relation.png b/doc/model/Model_Relation.png similarity index 100% rename from doc/Model_Relation.png rename to doc/model/Model_Relation.png diff --git a/doc/rathena.vpp b/doc/model/rathena.vpp similarity index 100% rename from doc/rathena.vpp rename to doc/model/rathena.vpp diff --git a/doc/packet_client.txt b/doc/packet_client.txt index cecc17c8ef..8e85f11f90 100644 --- a/doc/packet_client.txt +++ b/doc/packet_client.txt @@ -5,7 +5,7 @@ //===== Last Updated: ======================================== //= 20140718 //===== Description: ========================================= -//= List of all packet used by login-serv (A), char-serv (H), map-serv (Z) -//= to communicate to client. -//= See packet_interserv.txt for communication between servers +//= List of all packets used by login-serv (A), char-serv (H), +//= and map-serv (Z) to communicate to the client. +//= See packet_interserv.txt for communication between servers. //============================================================ diff --git a/doc/packet_interserv.txt b/doc/packet_interserv.txt index c3fcd50072..c1e83acdf6 100644 --- a/doc/packet_interserv.txt +++ b/doc/packet_interserv.txt @@ -1 +1,2510 @@ -//===== rAthena Documentation ================================ //= Source Documentation //===== By: ================================================== //= rAthena Dev Team //===== Last Updated: ======================================== //= 20140728 //===== Description: ========================================= //= List of all packet used by login-serv (A), char-serv (H), map-serv (Z) //= to communicate to each other. //= See packet_client.txt for communication to client (C) //============================================================ This file provides information about rAthena's packets, (packet are ordered by number). This file assume you familiar with packet notation, if note please see packet_struct_notation.txt before The format of this file is as follows: 1 Notes 2. Login-Char Packet 3. Char/Inter Packet - 3.1 Inter-Map Packet - 3.2 Char-Map Packet ================= | 1. Notes | ================= Currently the packet max size if 0xFFFF see WFIFOSET in src/common/socket.c This could be removed if you wish but be carefull if so =================== | 2. Login-Char Packet | =================== 0x2712: Type : HA Structure : .W .L .L .L .B .L .L index : 0,2,6,10,14,15,19 len : 23 parameter : - cmd : packet identification (0x2712) - aid : account identification - login_id1: unknown @FIXME - login_id2: unknown @FIXME - sex: the sex of the account - ip: the ip of the connection (obsolete) - request_id: unknown @FIXME desc : - Request from char-server to authenticate an account. 0x2713: Type: AH Structure: .W .L .L .L .B .B .L .L .B index: 0,2,6,10,14,15,16,20,24 len: 25 parameter: - cmd : packet identification (0x2713) - aid : account identification - login_id1: unknown @FIXME - login_id2: unknown @FIXME - sex: the sex of the account - ok : 1=auth failed, 1=ok - request_id: unknown @FIXME - version: client version, (clientinfo version) - clienttype: unknown @FIXME desc: - Acknowledge the authentification request from char-serv 0x2714: Type: HA Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x2714) - user_count: number of user present on the char-serv desc: - Retrieve the number of user present on a char-serv 0x2715: Type: HA Structure: .W .L 40B index: 0,2,6 len: 46 parameter: - cmd : packet identification (0x2715) - aid: account identification - email: new email for account id desc: - Request to update the email linked to this aid 0x2716: Type: HA Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x2716) - aid: account identification desc: - Request the account information of aid (see 0x2717) 0x2717 Type: AH Structure: .W .L .40B .L .B .B .11B .5B .L .L .B .B .B index: 0,2,6,46,50,51,52,63,68,72,76,77,78 len: 79 parameter: - cmd: packet identification (0x2717) - aid: account identification - email: email of aid - expiration_time: unknow @FIXME - group_id: the group the aid belong too - char_slots: number of slot available the account have (will be displayed on client) - birthdate: birthdate of aid - pincode: current pincode of aid - pincode_change: new pincode of aid - bank_vault: value in bank for this aid - isvip: if this aid is currently vip or not - char_vip: number of charslot that are vip (could only do creation on if you are vip) - MAX_CHAR_BILLING: number of charslort that are for billing desc: - Request account data 0x2718 Type: AH Structure: .W index: 0 len: 2 parameter: - cmd : packet identification (0x2718) desc: - Keep alive packet, (confirm we are still connected) 0x2719: Type: HA Structure: .W index: 0,2 len: 2 parameter: - cmd : packet identification (0x2719) desc: - Ping request from char-server 0x2720: 0x2721: free 0x2722: Type: HA Structure: .W .L .40B .40B index: 0,2,6,46 len: 86 parameter: - cmd : packet identification (0x2722) - aid: account identification - actual_email: current email address - new_email: new email address desc: - Map server sends information to change an email of an account via char-server 0x2723: Type: AH Structure: .W L B index: 0,2,6 len: 7 parameter: - cmd : packet identification (0x2723) - aid: account identification - sex: sex of account 0 = SEX_FEMALE 1= SEX_MALE 2=SEX_SERVER desc: - Acknowledge sex update 0x2724: Type: HA Structure: .W .L L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x2724) - t_aid: account identification of target - state: state of account - 0 : unblock - 5 : block (Connection refused) desc: - Receiving an account state update request from a map-server (relayed via char-server) 0x2725: Type: HA Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x2725) - t_aid: account identification of target - timediff: tick to add or remove to a timestamp desc: - Receiving of map-server via char-server a ban request (alter the ban time) 0x2726: free 0x2727: Type: HA Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x2727) - aid: account identification desc: - Receive a request to change sex (sex is reversed) 0x2728: Type: HA Structure: .W .W L .L { .?B .?B } index: 0,2,4,8,13 len: variable (reg size+4) parameter: - cmd : packet identification (0x2728) - len: pakcet size - aid: account identification - cid : char identification - str : name of variable in registry - value : value of varaible in registry desc: - Receive an request to fetch account_reg2 from a char-server, see packet 0x3004 (mapif_parse_Registry) 0x2729: Type: AH Structure: .W .L .L .L .B { ?B ?B } index: 0,2,4,8,12,13 len: variable (reg2 size+13) parameter: - cmd : packet identification (0x2729) - len: pakcet size - aid: account identification - cid : char identification -type: -type: 1: account2 registry (only one used atm) 2: account registry 3: char registry - str : name of variable in registry - value : value of varaible in registry desc: - Receive account_reg2 registry, forward to map servers. 0x272a: Type: HA Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x272a) - t_aid: account identification desc: - request unban account 0x272b: Type: HA Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x272b) - t_aid: account identification desc: - Add aid to list of online user on loginserv. (setacconline) 0x272c: Type: HA Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x272c) - t_aid: account identification desc: - Remove aid to the list of online user (setaccoffline). 0x272d: Type: HA Structure: .W W L {.L}* index: 0,2,4,8 len: 8+users*4 parameter: - cmd : packet identification (0x272d) - len : size of packet - users: number of users connected to char-serv - aid: account identification desc: - receive account list from char-server 0x272e: Type: HA Structure: .W .L .L index: 0,2,4,6 len: 10 parameter: - cmd : packet identification (0x272e) - aid: account identification - cid: char identification desc: - request accreg2 to login 0x272f: 0x2730: free 0x2731: Type: AH Structure: .W L B .L index: 0,2,6,7 len: 11 parameter: - cmd : packet identification (0x2731) - aid: account identification - state: 0=change of status, 1=ban - status|date: status or final date of a banishment desc: - Notify char-serv of a state change or ban (accbannotification). 0x2732: 0x2733: free 0x2734: Type: AH Structure: .W L index: 0,2, len: 6 parameter: - cmd : packet identification (0x2734) - aid: account identification desc: - Account is already marked as online. (Login server request to kick a character out). 0x2735: Type: AH Structure: .W index: 0 len: 2 parameter: - cmd : packet identification (0x2735 desc: - ip address update signal from login server 0x2736: Type: HA Structure: .W L index: 0,2 len: 6 parameter: - cmd : packet identification (0x2736) - ip: ip of char server desc: - IP update for char-server 0x2737: Type: HA Structure: .W index: 0 len: 2 parameter: - cmd : packet identification (0x2737) desc: - Request to set all account as offline from char-server 0x2738: Type: HA Structure: .W L ?B index: 0,2,6 len: 11 @FIXME should be 6+PINCODE_LENGTH+1 parameter: - cmd : packet identification (0x2738) - aid : account identification - pincode : new pincode code desc: - Change PIN Code of an account 0x2739: Type: HA Structure: .W L index: 0,2 len: 6 parameter: - cmd : packet identification (0x2739) - aid : account identification desc: - Login notify char that too many wrong PIN code entered. (fail auth) 0x273a 0x273b 0x273c 0x273d 0x273e 0x273f free 0x2740: Type: HA Structure: .W .L .B .L index: 0,2,6,7 len: 11 parameter: - cmd : packet identification (0x2740) - aid: account identification - type: - data: desc: - Request to update bank_vault 0x2741: Type: AH Structure: .W .L .B .L index: 0,2,6,7 len: 11 parameter: - cmd : packet identification (0x2741) - aid : account identification - type : 1=select, 2=upd and save - data : new bank vault desc: - Request the bank info of login 0x2742: Type: HA Structure: .W .L .B .L .L index: 0,2,6,7,11 len: 15 parameter: - cmd : packet identification (0x2742) - aid: account identification - type: &1 ack vip data to char-serv, &2 add duration - timediff: tick to add to viptime - mapfd: map-serv link to ack if type&1 desc: - Received a VIP data request from char 0x2743: Type: AH Structure: .W .L .L .B .L .L .B index: 0,2,6,10,11,15,16 len: 20 parameter: - cmd : packet identification (0x2743) - aid: account identification - vip_time: timestamp of vip_time if he is vip - isvip: is this account in vip mode atm - groupid: group id of account - isgm: is he a gm - mapfd: map-serv link to ack desc: - Transmit vip specific data to char-serv (will be transfered to mapserv) =================== | 2.1 Inter-Map Packet | =================== 0x3000 Type: ZI Structure: .W W L W W W W ?B index: 0,2,4,8,10,12,14,16 len: 16+msglen parameter: - cmd : packet identification (0x3000) - len : packet size - fontColor: (standard broadcast color=0xFF000000) - fontType: - fontSize: - fontAlign: - fontY: - mes: message to send desc: - Broadcasts a message to all map-servs connected to this char-serv - NB carefull (also using cmd=3000 rAthena_report but encapsulate it into cmd 3008 for map-char) 0x3001 Type: ZI Structure: .W W (NAME_LENGTH)B (NAME_LENGTH)B ?B index: 0,2,4,4+NAME_LENGTH,4+2*NAME_LENGTH len: 52+mes_len parameter: - cmd : packet identification (0x3001) - len: packet size - name : sender name of msg - nick : receiver name of msg - mes : message to send desc: - Send a whisper to another player 0x3002 Type: ZI Structure: .W < index: 0,2,6 len: 7 parameter: - cmd : packet identification (0x3002) - id: cid (@FIXME of who ?) - flag: 0=success, 1=target not found, 2=ignored by target desc: - Inform the char-serv of the result of the whisper 0x3003 Type: ZI Structure: .W .w .24B .l .?B index: len: 32+mes_len parameter: - cmd : packet identification (0x3003) - len: 32+mes_len - wisp_name+permission - mes_len desc: - Transmission of GM only Wisp/Page from server to inter-server 0x3004 Type: ZI Structure: .W .L .L .B { ?B ?B }? index: 0,4,8,12,13 len: variable : 13+regnum*(len variable name+len value) (max=288 * MAX_REG_NUM+13) parameter: - cmd : packet identification (0x3004) - aid: account identification - cid: char identification -type: 1: account2 registry 2: account registry 3: char registry -str: registre variable identifiant, (variable name) -value: variable value desc: - Map-serv is requesting Char-serv to save registry values. (type=1 will forward data to login-serv) 0x3005 Type: ZI Structure: .W .L .L .B .B .B index: 0,2,6,10,11,12 len: 13 parameter: - cmd : packet identification (0x3005) - aid: - cid: -acc_reg2 : request account registry (permanent variable of account, save on login-serv) -acc_reg : request account registry (permanent variable of account , save on char-serv) -ch_reg : request char registry (permanent variable of char) desc: - Request the registries for this player. 0x3006 Type: ZI Structure: .W .L .L .B .? index: 0,2,6,10,11 len: 12+NAME_LENGTH parameter: - cmd : packet identification (0x3006) - aid - cid - type - NAME_LENGTH desc 0x3007 Type: ZI Structure: .W .L .L .L index: 0,2,6,10,14 len: 14+NAME_LENGTH parameter: - cmd : packet identification (0x3007) - u_fd - aid - group_lv - query desc: - Request acc info 0x3018 Type: ZI Structure: .W .L .L index 0,2,6 len: 10 parameter: - cmd : packet identification (0x3018) - aid - gid desc: - Request guild storage 0x3019 Type: ZI Structure: .W .W .L .L index: 0,2,4,8,12 len: 12+guild_storage parameter: - cmd : packet identification (0x3019) - guild_storage - aid - gid desc: - Send guild storage 0x3020 Type: ZI Structure: .W .W .24B .B .B .?B index: 0,2,4,28,29,30 len: variable: 28+party_member (max=64) parameter: - cmd : packet identification (0x3020) - party_member - name - item - item2 - member desc: - Party creation request 0x3021 Type: ZI Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x3021) - party_id - cid desc: - Party information request 0x3022 Type: ZI Structure: .W .W .L .?B index: 0,2,4,8 len: variable: 8+party_member (Max=42) parameter: - cmd : packet identification (0x3022) - party_member - party_id - member desc: - Request to add a member to party 0x3023 Type: ZI Structure: .W .L .L .W .W index: 0,2,6,10,12,14 len: 14 parameter: - cmd : packet identification (0x3023) - party_id - aid - exp - item desc: - Request to change party configuration (exp,item share) 0x3024 Type: ZI Structure: .W .L .L .L index: 0,2,6,10 len: 14 parameter: - cmd : packet identification (0x3024) - party_id - aid - cid desc: - Request to leave party 0x3025 Type: ZI Structure: .W .L .L .L .W .B .W index: 0,2,6,10,14,16,17 len: 19 parameter: - cmd : packet identification (0x3025) - party_id - aid - cid - mapindex - online - base_level desc: - Party change map 0x3026 Type: ZI Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x3026) - party_id desc: - Request breaking party 0x3027 Type: ZI Structure: .W .W .L .L .?B index: 0,2,4,8,12 len: variable: 12+len parameter: - cmd : packet identification (0x3027) - len - party_id - aid - mes desc: - Sending party chat 0x3029 Type: ZI Structure: .W .L .L .L index: 0,2,6,10 len: 14 parameter: - cmd : packet identification (0x3029) - party_id - aid - cid desc: - Request a new leader for party 0x302A Type: ZI Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x302a) - share_lvl desc: - Request to update party share level 0x3030 Type: ZI Structure: .W .W .L .?B .?B index: 0,2,4,8,8+NAME_LENGTH len: parameter: - cmd : packet identification (0x3030) - guild_member - aid - name - master desc: - Request a Guild creation 0x3031 Type: ZI Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x3031) - guild_id desc: - Request Guild information 0x3032 Type: ZI Structure: .W .W .L .?B index: 0,2,4,8 len: variable: 8+guild_member parameter: - cmd : packet identification (0x3032) desc: - Request to add member to the guild 0x3033 Type: ZI Structure: .W .W .L .?B index: 0,2,4,8 len: variable: 8+len parameter: - cmd : packet identification (0x3033) - len - guild_id - name desc: - Request a new leader for guild 0x3034 Type: ZI Structure: .W .L .L .L .B .40B index: 0,2,6,10,14,15 len: 55 parameter: - cmd : packet identification (0x3034) - guild_id - aid - cid - flag - mes desc: - Request to leave guild 0x3035 Type: ZI Structure: .W .L .L .L .B .W .W index: 0,2,6,10,14,15,17 len: 19 parameter: - cmd : packet identification (0x3035) - guild_id - aid - cid - online - lv - class_ desc: - Update request / Lv online status of the guild members 0x3036 Type: ZI Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x3036) - guild_id desc: - Guild disbanded notification 0x3037 Type: ZI Structure: .W .W .L .L .?B index: 0,2,4,8,12 len: variable: 12+len parameter: - cmd : packet identification (0x3037) - len - guild_id - aid - mes desc: - Send a guild message 0x3039 Type: ZI Structure: .W .W .L .W .?B index: 0,2,4,8,10 len: variable: 10+len parameter: - cmd : packet identification (0x3039) - len - guild_id - type - data desc: - Request a change of Guild basic information 0x303a Type: ZI Structure: .W .W .L .L .L .W .?B index: 0,2,4,8,12,16,18 len: variable: 18+len parameter: - cmd : packet identification (0x303a) - len - guild_id - aid - cid - type - data desc: - Request a change of Guild member information 0x303b Type: ZI Structure: .W .W .L .L

.?B index: 0,2,4,8,12 len: variable: 12+guild_position parameter: - cmd : packet identification (0x303b) - guild_position - guild_id - idx - p desc: - Request a change of Guild title 0x303c Type: ZI Structure: .W .L .L .L .L index: 0,2,6,10,14 len: 18 parameter: - cmd : packet identification (0x303c) - guild_id - skill_id - aid - max desc: - Request an update of Guildskill skill_id 0x303d Type: ZI Structure: .W .L .L .L .L .B index: 0,2,6,10,14,18 len: 19 parameter: - cmd : packet identification (0x303d) - guild_id1 - guild_id2 - account_id1 - account_id2 - flag desc: - Request a new guild alliance 0x303e Type: ZI Structure: .W .L .60B .120B index: 0,2,6,66 len: 186 parameter: - cmd : packet identification (0x303e) - guild_id - mes1 - mes2 desc: - Request to change guild notice 0x303f Type: ZI Structure: .W .W .L <0>.L .?B index: 0,2,4,8,12 len: variable: 12+len (Max=2012) parameter: - cmd : packet identification (0x303f) desc: - Request to change guild emblem 0x3040 Type: ZI Structure: .W .W .?B index: 0,2,4 len: variable: 4 + num * 2,147,483,647 parameter: - cmd : packet identification (0x3040) - num - castle_ids desc: - Requests guild castles data from char-server 0x3041 Type: ZI Structure: .W .W .B .L index: 0,2,4,5 len: 9 parameter: - cmd : packet identification (0x3041) - castle_ids - index - value desc: - Request change castle guild owner and save data 0x3048 Type: ZI Structure: .W .L .B index: 0,2,6 len: 7 parameter: - cmd : packet identification (0x3048) - cid - flag desc: - Inbox request 0x3049 Type: ZI Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x3049) - mail_id desc: - Mail read 0x304a Type: ZI Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x3093) - cid - mail_id desc: - Mail get attachment 0x304b Type: ZI Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x3093) - cid - mail_id desc: - Mail delete 0x304c Type: ZI Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x3093) - cid - mail_id desc: - Mail return 0x304d Type: ZI Structure: .W .W .L .?B index: 0,2,4,8 len: variable: 8+mail_message parameter: - cmd : packet identification (0x3093) - len - aid - msg desc: - Mail send 0x3050 Type: ZI Structure: .W .W .L .W .L .W .?B index: 0,2,4,8,10,14,16 len: variable: 16+NAME_LENGTH parameter: - cmd : packet identification (0x3093) - len - cid - type - price - page - searchtext desc: - Auction request list 0x3051 Type: ZI Structure: .W .W .?B @FIXME index: 0,2,4 len: variable: 4+auction parameter: - cmd : packet identification (0x3093) - len - auction desc: - Auction register 0x3052 Type: ZI Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x3093) - cid - auction_id desc: - Auction cancel 0x3053 Type: ZI Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x3093) - cid - auction_id desc: - Auction close 0x3055 Type: ZI Structure: .W .W .L .L .L .?B index: 0,2,4,8,12,16 len: variable: 16+NAME_LENGTH parameter: - cmd : packet identification (0x3093) - len - cid - auction_id - bid desc: - Auction bid 0x3056 Type: ZI Structure: .W .L .L .W index: 0,2,6,10 len: 12 parameter: - cmd : packet identification (0x3093) - cid - aid - guild_id desc: - Itembound request 0x3060 Type: ZI Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x3093) - cid desc: - Requests a character's quest log entries to the inter server. 0x3061 Type: ZI Structure: .W .W .L .?B index: 0,2,4,8 len: variable: 8+num_quests parameter: - cmd : packet identification (0x3093) desc: - Requests to the inter server to save a character's quest log entries. 0x3070 Type: ZI Structure: .W .W .?B index: 0,2,4 len: variable: 4+s_mercenary parameter: - cmd : packet identification (0x3093) - size - merc desc: - Mercenary create 0x3071 Type: ZI Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x3071) - merc_id - cid desc: - Mercenary request 0x3072 Type: ZI Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x3072) - merc_id desc: - Mercenary delete 0x3073 Type: ZI Structure: .W .W .?B index: 0,2,4 len: variable: 4+s_mercenary parameter: - cmd : packet identification (0x3073) - size - merc desc: - Mercenary save 0x307c Type: ZI Structure: .W .W .?B index: 0,2,4 len: variable: 4+s_elemental parameter: - cmd : packet identification (0x307c) - size - ele desc: - Elemental create 0x307d Type: ZI Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x307d) - ele_id - cid desc: - Elemental request 0x307e Type: ZI Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x307e) - ele_id desc: - Elemental delete 0x307f Type: ZI Structure: .W .W .?B index: 0,2,4 len: variable: 4+s_elemental parameter: - cmd : packet identification (0x307f) - size - ele desc: - Elemental save 0x3080 Type: ZI Structure: .W .L .L .W .W .W .W .W .W .B .B index: 0,2,6,10,12,14,16,18,20,22,23,24 len: variable: 24+NAME_LENGTH parameter: - cmd : packet identification (0x3080) - aid - cid - pet_class - pet_lv - pet_egg_id -pet_equip - intimate - hungry - rename_flag - incubate desc: - Pet create 0x3081 Type: ZI Structure: .W .L .L .L index: 0,2,6,10 len: 14 parameter: - cmd : packet identification (0x3081) - aid - cid - pet_id desc: - Request pet data 0x3082 Type: ZI Structure: .W .W .L

.?B @FIXME index: 0,2,4,8 len: variable: 8+s_pet parameter: - cmd : packet identification (0x3082) - ? - aid - p desc: - Save pet data 0x3083 Type: ZI Structure: .W .L index: 0,2 len 6: parameter: - cmd : packet identification (0x3083) - pet_id desc: - Delete pet data 0x3090: Type: ZI Structure: .W .W .L .?B index: 0,2,4,8 len: variable: 8+s_homunculus parameter: - cmd : packet identification (0x3090) - s_homunculus - aid - sh desc: - Homunculus create 0x3091: Type: ZI Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x3091) - aid - homun_id desc: - Homunculus request load 0x3092: Type: ZI Structure: .W .W .L .?B index: 0,2,4,8 len: variable: 8+s_homunculus parameter: - cmd : packet identification (0x3092) - s_homunculus - aid - sh desc: - Homunculus request save 0x3093: Type: ZI Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x3093) - homun_id desc: - Homunculus request delete 0x3094: Type: ZI Structure: .W .L .L .?B index: 0,2,6,10 len: variable: 10+name parameter: - cmd : packet identification (0x3094) - aid - cid - name desc: - Homunculus rename 0x3800: Type: IZ Structure: .W .W .L .W .W .W .W .?B index: 0,2,4,8,10,12,14,16 len: variable: 16+len parameter: - cmd : packet identification (0x3800) - len - fontColor - fontType - fontSize - fontAlign - fontY - mes desc: - Send broadcast message 0x3801 Type: IZ Structure: .W .W .L .24B .24B .?B index: 0,2,4,8,32,56 len: variable: 56+len (Max=1991) parameter: - cmd : packet identification (0x3801) - len - id - src - dst - msg desc: - Send whisper message 0x3802 Type: IZ Structure: .W .24B .B index: 0,2,26 len: 27 parameter: - cmd : packet identification (0x3802) - src - flag desc: - Whisper sending result 0x3803 Type: IZ Structure: .W .W .24B .W .?B @FIXME index: 0,2 len: variable: 30+message parameter: - cmd : packet identification (0x3803) - desc: - Parse whisper to GM 0x3804 Type: IZ Structure: .W .W .L .L .B index: 0,2,4,8,12 len: variable: 13 or p (Max=5013) parameter: - cmd : packet identification (0x3804) - ? - aid - cid - type desc: - Account registry transfer to map-server 0x3806 Type: IZ Structure: .W .L .L .B .B .B index: 0,2,6,10,11,12 len: 13 parameter: - cmd : packet identification (0x3806) - aid - cid - type - flag - name desc: - mapif_namechange_ack 0x3807 Type: IZ Structure: .W .W .L .L .?B index: 0,2,4,8,12 len: variable: 12+len parameter: - cmd : packet identification (0x3807) - len - u_fd - aid - msg_out desc: - sends a mesasge to map server (fd) to a user (u_fd) although we use fd we keep aid for safe-check 0x3818 Type: IZ Structure: .W .W .L .L .B .?B index: 0,2,4,8,12,13 len: variable: 13+guild_storage parameter: - cmd : packet identification (0x3818) - len - aid - guild_id - flag - guild_storage desc: - mapif_load_guild_storage 0x3819 Type: IZ Structure: .W .L .L .B index: 0,2,6,10 len: 11 parameter: - cmd : packet identification (0x3819) - aid - guild_id - fail desc: - mapif_save_guild_storage_ack 0x3820 Type: IZ Structure: .W .L .L .B .L .?B index: 0,2,6,10,11,15 len: 39 parameter: - cmd : packet identification (0x3820) - aid - char_id - ? - party_id - name desc: - ACK party creation 0x3821 Type: IZ Structure: .W .W .L .L index: 0,2,4,8 len: 12 parameter: - cmd : packet identification (0x3821) - ? - char_id - party_id desc: - Party information not found 0x3822 Type: IZ Structure: .W .L .L .L .B index: 0,2,6,10,14 len: 15 parameter: - cmd : packet identification (0x3822) - party_id - account_id - char_id - flag desc: - mapif_party_memberadded 0x3823 Type: IZ Structure: .W .L .L .W .W .B index: 0,2,6,10,12,14,15? len: 16? parameter: - cmd : packet identification (0x3823) - party_id - account_id - exp - item - flag - ? desc: - Party setting change notification 0x3824 Type: IZ Structure: .W .L .L .L .?B index: 0,2,6,10,14 len: 16? parameter: - cmd : packet identification (0x3824) - party_ud - account_id - char_id - ? desc: - Withdrawal notification party 0x3825 Type: IZ Structure: .W .L .L .L .W .B .W .?B index: 0,2,6,10,14,16,17,19 len: 20? parameter: - cmd : packet identification (0x3825) - party_id - account_id - char_id - map - online - lv - ? desc: - Party map update notification 0x3826 Type: IZ Structure: .W .L .B .?B index: 0,2,6,7 len: 16 parameter: - cmd : packet identification (0x3826) - party_id - flag - ? desc: - Dissolution party notification 0x3827 Type: IZ Structure: .W .W .L .L .?B index: 0,2,4,8,12 len: variable: 12+len (max=512) parameter: - cmd : packet identification (0x3827) - len - party_id - account_id - mes desc: - mapif_party_message 0x3830 Type: IZ Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x3830) - account_id - guild_id desc: - mapif_guild_created 0x3831 Type: IZ Structure: .W .W .L .?B index: 0,2,4,8 len: 12 parameter: - cmd : packet identification (0x3831) - ? - guild_id - ? desc: - mapif_guild_noinfo 0x3832 Type: IZ Structure: .W .L .L .L .B index: 0,2,6,10,14 len: 15 parameter: - cmd : packet identification (0x3832) - guild_id - account_id - char_id - flag desc: - ACK member add 0x3834 Type: IZ Structure: .W .L .L .L .B .40B .?B index: 0,2,6,10,14,15,55 len: variable: 55+NAME_LENGTH parameter: - cmd : packet identification (0x3834) - guild_id - account_id - char_id - flag - mes - name desc: - mapif_guild_withdraw 0x3835 Type: IZ Structure: .W .L .L .L .B .W .W index: 0,2,6,10,14,15,17 len: 19 parameter: - cmd : packet identification (0x3835) - guild_id - account_id - char_id - online - lv - class_ desc: - Send short guild member's info 0x3836 Type: IZ Structure: .W .L .B index: 0,2,6 len: 7 parameter: - cmd : packet identification (0x3836) - guild_id - flag desc: - mapif_guild_broken 0x3837 Type: IZ Structure: .W .W .L .L .?B index: 0,2,4,8,12 len: variable: 12+len (max=512) parameter: - cmd : packet identification (0x3837) - len - guild_id - account_id - mes desc: - Send guild message 0x3839 Type: IZ Structure: .W .W .L .W .?B index: 0,2,4,8,10 len: variable: 10+len (Max=2048) parameter: - cmd : packet identification (0x3839) - len - guild_id - type - data desc: - mapif_guild_basicinfochanged 0x383a Type: IZ Structure: .W .W .L .L .L .W .?B index: 0,2,4,8,12,16,18 len: variable: 18+len (Max=2048) parameter: - cmd : packet identification (0x383a) - len - guild_id - account_id - char_id - type - data desc: - mapif_guild_memberinfochanged 0x383b Type: IZ Structure: .W .W .L .L .?B index: 0,2,4,8,12 len: variable: 12+guild_position parameter: - cmd : packet identification (0x383b) - len - guild_id - idx - position desc: - mapif_guild_position 0x383c Type: IZ Structure: .W .L .L .L index: 0,2,6,10 len: 14 parameter: - cmd : packet identification (0x383c) - guild_id - skill_id - account_id desc: - ACK guild skill up 0x383d Type: IZ Structure: .W .L .L .L .L .B .?B .?B index: 0,2,6,10,14,18,19 len: variable: 19+2*NAME_LENGTH parameter: - cmd : packet identification (0x383d) - guild_id1 - guild_id2 - account_id1 - account_id2 desc: - ACK guild alliance 0x383e Type: IZ Structure: .W .L .60B .120B .?B index: 0,2,6,66,186 len: 256 parameter: - cmd : packet identification (0x383e) - guild_id - mes1 - mes2 - ? desc: - Send the guild notice 0x383f Type: IZ Structure: .W .W .L .L .?B index: 0,2,4,8,12 len: variable: 12+emblem_data parameter: - cmd : packet identification (0x383f) - len - guild_id - emblem_id - emblem_data desc: - Send emblem data 0x3840 Type: IZ Structure: .W .W .?B index: 0,2,4 len: variable: 4+num*gc parameter: - cmd : packet identification (0x3840) - len - gc desc: - mapif_guild_castle_dataload 0x3843 Type: IZ Structure: .W .L .L .L index: 0,2,6,10 len: 14 parameter: - cmd : packet identification (0x3843) - guild_id - aid - cid desc: - mapif_guild_master_changed =================== | 2.2 Char-Map Packet | =================== 0x2af9 Type: AZ Structure: .W .B index: 0,2 len: 3 parameter: - cmd : packet identification (0x2af9) - ? desc: - chrif_connectack 0x2afb Type: AZ Structure: .W .B index: 0,2 len: variable: 3+NAME_LENGTH parameter: - cmd : packet identification (0x2afb) - ? desc: - send name for wisp to player 0x2afd Type: AZ Structure: .W .W .L .L .L .L .L .B .?B index: 0,2,4,8,12,16,20,24,25 len: variable: mmo_charstatus_len parameter: - cmd : packet identification (0x2afd) - mmo_charstatus_len - account_id - ? - ? - ? - ? - ? - cd desc: - auth request from map-server 0x2b00 Type: AZ Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x2b00) desc: - Send to map-servers the users count on this char-serv, (meaning the total of all mapserv) 0x2b03 Type: AZ Structure: .W .L .B index: 0,2,6 len: 7 parameter: - cmd : packet identification (0x2b03) - account_id - ? desc: - Player Requesting char-select from map_serv 0x2b04 Type: AZ Structure: .W .W .L .W index: 0,2,4,8 len: ? parameter: - cmd : packet identification (0x2b04) - ? - ip - port desc: - Receive maps from some other map-server (relayed via char-server) 0x2b06 Type: AZ Structure: .W .L .L .L .L .W .W .W .L .W index: 0,2,6,10,14,16,18,20,24,28 len: 30 parameter: - cmd : packet identification (0x2b06) - account_id - login_id1 - login_id2 - char_id - map_index - x - y - ip - port desc: - Map-server change request acknowledgement (positive or negative) 0x2b09 Type: AZ Structure: .W .L ? index: 0,2,6 len: 30 parameter: - cmd : packet identification (0x2b09) - ? - ? desc: - Lookup to search if that char_id correspond to a name. 0x2b0b Type: AZ Structure: .W .W .L .L .W .?B index: 0,2,4,8,12,14 len: variable: 14+MAX_SKILLCOOLDOWN*skill_cooldown_data parameter: - cmd : packet identification (0x2b0b) - len - aid - cid - count - skill_cooldown_data desc: - Retrieve and load skillcooldown for a player 0x2b0d Type: AZ Structure: .W .L .L index:0,2,6 len: 10 parameter: - cmd : packet identification (0x2b0d) - acc - sex desc: - Request char server to change sex of char 0x2b0f Type: AZ Structure: .W .L .24B .W .W index: 0,2,6,30,32 len: 34 parameter: - cmd : packet identification (0x2b0f) - aid - name - operation - result desc: - Processing a reply to chrif_req_login_operation() (request to modify an account). 0x2b12 Type: AZ Structure: .W .L .L .B index: 0,2,6,10 len: 11 parameter: - cmd : packet identification (0x2b12) - partner_id1 - partner_id2 - ? desc: - Divorce players (only used if 'partner_id' is offline) 0x2b14 Type: AZ Structure: .W .L .B .L index: 0,2,6,7 len: 11 parameter: - cmd : packet identification (0x2b14) - id - res - ret_status desc: - Disconnection of a player (account has been banned of has a status, from login/char-server) 0x2b1b Type: AZ Structure: .W .W .W .W ?B ?B ?B index: 0,2,4,6,?,?,? len: ? (Max=32000) parameter: - cmd : packet identification (0x2b1b) - size: total packet length - size: Alchemist block size - size: Blacksmith block size - - - desc: - Send map-servers fames ranking lists 0x2b1d Type: AZ Structure: .W .W .L .L index: 0,2,4,8 len: variable: 14+50*status_change_data parameter: - cmd : packet identification (0x2b1d) - len - aid - cid desc: - Map-serv requesting to send the list of sc_data the player has saved 0x2b1e Type: AZ Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x2b1e) - new_ip desc: - Request forwarded from char-server for interserver IP sync 0x2b1f Type: AZ Structure: .W .L .B index: 0,2,6 len: 7 parameter: - cmd : packet identification (0x2b1f) - account_id - reason desc: - Request to kick char from a certain map server 0x2b20 Type: AZ Structure: .W .W .L .W index: 0,2,4,8 len: 10 parameter: - cmd : packet identification (0x2b20) - len - ip - port desc: - Remove specified maps (used when some other map-server disconnects) 0x2b21 Type: AZ Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x2b21) desc: - chrif_save_ack (Received after a character has been "final saved" on the char-server) 0x2b22 Type: AZ Structure: .W .B .B .L index: 0,2,3,4 len: 8 parameter: - cmd : packet identification (0x2b22) - type - index - fame desc: - Send to map-servers the updated fame ranking lists 0x2b24 Type: AZ Structure: .W index: 0 len: 2 parameter: - cmd : packet identification (0x2b24) desc: - Map-server keep alive packet, awnser back map that we alive as well 0x2b25 Type: AZ Structure: .W .L .L .L index: 0,2,6 len: ? (Max=64) parameter: - cmd : packet identification (0x2b25) - father_id - mother_id - char_id desc: - Removes baby from Father ID and Mother ID 0x2b27 Type: AZ Structure: .W .L .L .L .B index: 0,2,6,10,14 len: 15 parameter: - cmd : packet identification (0x2b27) - account_id - char_id - login_id1 - sex desc: - Client authentication failed 0x2b29 Type: AZ Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x2b29) - aid - bank_vault desc: - Received bank data for player to be loaded 0x2b2b Type: AZ Structure: .W .L .L .B .B .L index: 0,2,6,10,11,12 len: 16 parameter: - cmd : packet identification (0x2b2b) - aid - vip_time - isvip - isgm - groupid desc: - Received vip-data from char-serv, fill map-serv data 0x2b2f Type: AZ Structure: .W .W .L .W index: 0,2,4,8 len: variable: 10+50*bonus_script_data parameter: - cmd : packet identification (0x2b2f) desc: - Get bonus_script data(s) from table to load 0x2736 Type: ZA Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x2736) desc: - ip address update 0x2afa Type: ZA Structure: .W .W .W index: 0,2,4+1*4 @FIXME len: variable 4+instance_start*4 parameter: - cmd : packet identification (0x2afa) - ? - ? desc: - chrif_sendmap 0x2afc Type: ZA Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x2afc) - account_id - char_id desc: - Request sc_data from charserver 0x2afe Type: ZA Structure: .W .W index: 0,2 len: 4 parameter: - cmd : packet identification (0x2afe) desc: - send_usercount_tochar (unused) 0x2aff Type: ZA Structure: .W .W .W .L .L index: 0,2,4,6+8*i,6+8+i+4 len: variable: 6+8*users parameter: - cmd : packet identification (0x2aff) - len - users - account_id - char_id desc: - Map-serv sent us all his users info, (aid and cid) so we can update online_char_db 0x2b01 Type: ZA Structure: .W .W .L .L .B index: 0,2,4,8,12 len: variable: mmo_charstatus_len parameter: - cmd : packet identification (0x2b01) desc: - charsave of char XY account XY 0x2b02 Type: ZA Structure: .W .L .L .L .L .B index: 0,2,6,10,14,18 len: 19 parameter: - cmd : packet identification (0x2b02) - id - login_id1 - login_id2 - s_ip - packet_ver desc: - chrif_charselectreq 0x2b05 Type: ZA Structure: .W .L .L .L .L .W .W .W .L .W .B .L .L index: 0,2,6,10,14,18,20,22,24,28,30,31,35 len: 39 parameter: - cmd : packet identification (0x2b05) - id - login_id1 - login_id2 - char_id - mapindex - x - y - ip - port - sex - client_addr - group_id desc: - Tell the charserver the mapchange / quest for ok 0x2b07 Type: ZA Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x2b07) - char_id - friend_id desc: - Asks char server to remove friend_id from the friend list of char_id 0x2b08 Type: ZA Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x2b08) desc: - Search char through id on char serv 0x2b0a Type: ZA Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x2b0a) - account_id - char_id desc: - Request skillcooldown from charserver 0x2b0c Type: ZA Structure: .W .W .40B .40B index: 0,2,6,46 len: 86 parameter: - cmd : packet identification (0x2b0c) - id - actual_email - new_email desc: - Change Email 0x2b0e Type: ZA Structure: .W .L .24B .W .L .L .L index: 0,2,30,36,40 len: 44 parameter: - cmd : packet identification (0x2b0e) - aid - name - operation_type - timediff - val1 - val2 desc: - Send an account modification request to the login server (via char server). 0x2b10 Type: ZA Structure: .W .L .L .B index: 0,2,6,10 len: 11 parameter: - cmd : packet identification (0x2b10) - char_id - fame - type desc: - Request/Receive top 10 Fame character list 0x2b11 Type: ZA Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x2b11) - partner_id1 - partner_id2 desc: - Request Char Server to Divorce Players 0x2b15 Type: ZA Structure: .W .W .L .L .W index: 0,2,4,8,12 len: variable: 14+MAX_SKILLCOOLDOWN*skill_cooldown_data parameter: - cmd : packet identification (0x2b15) - len - account_id - char_id - count desc: - Request to save skill cooldown data 0x2b16 Type: ZA Structure: .W .L .L .L index: 0,2,6,10 len: 14 parameter: - cmd : packet identification (0x2b16) - base_rate - job_rate - drop_rate desc: - Send rates and motd to char server 0x2b17 Type: ZA Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x2b17) - char_id - account_id desc: - Tell char-server character disconnected 0x2b18 Type: ZA Structure: .W index: 0 len: 2 parameter: - cmd : packet identification (0x2b18) desc: - Tell char-server to reset all chars offline 0x2b19 Type: ZA Structure: .W .L .L index: 0,2,6 len: 10 parameter: - cmd : packet identification (0x2b19) - char_id - account_id desc: - Tell char-server character is online 0x2b1a Type: ZA Structure: .W index: 0 len: 2 parameter: - cmd : packet identification (0x2b1a) desc: - Build the fame ranking lists and send them 0x2b1c Type: ZA Structure: .W .W .L .L .W index: 0,2,4,8,12 len: variable: 14+SC_MAX*status_change_data parameter: - cmd : packet identification (0x2b1c) - len - account_id - char_id - count desc: - parses the sc_data of the player and sends it to the char-server for saving 0x2b23 Type: ZA Structure: .W index: 0 len: 2 parameter: - cmd : packet identification (0x2b23) desc: - pings the charserver (chrif_keepalive) 0x2b26 Type: ZA Structure: .W .L .L .L .B .L .B index: 0,2,6,10,14,15,19 len: 20 parameter: - cmd : packet identification (0x2b26) - account_id - char_id - login_id1 - sex - client_addr - autotrade desc: - client authentication request 0x2b28 Type: ZA Structure: .W .L .L .?B index: 0,2,6,10 len: variable: 10+NAME_LENGTH parameter: - cmd : packet identification (0x2b28) - aid - timediff - character_name desc: - chrif_req_charban 0x2b2a Type: ZA Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x2b2a) desc: - chrif_req_charunban 0x2b2d Type: ZA Structure: .W .L index: 0,2 len: 6 parameter: - cmd : packet identification (0x2b2d) desc: - Requests bonus_script data 0x2b2e Type: ZA Structure: .W .W .L .W index: 0,2,4,8 len: variable: 10+MAX_PC_BONUS_SCRIPT*bonus_script_data parameter: - cmd : packet identification (0x2b2e) - len - char_id - count desc: - Stores bonus_script data(s) to the table 0x3008 Type: ZA Structure: .W .?B index: 0,2 len: variable: 2+len parameter: - cmd : packet identification (0x3008) - buf desc: - chrif_send_report \ No newline at end of file +//===== rAthena Documentation ================================ +//= Source Documentation +//===== By: ================================================== +//= rAthena Dev Team +//===== Last Updated: ======================================== +//= 20140831 +//===== Description: ========================================= +//= List of all packets used by login-serv (A), char-serv (H), +//= and map-serv (Z) to communicate with each other. +//= See packet_client.txt for communication to client (C). +//============================================================ + +This file provides information about rAthena's packets, ordered by number. +This assumes knowledge of packet notation, which is detailed in +'doc/packet_struct_notation.txt'. + +The format of this file is as follows: + 1. Notes + 2. Login-Char Packets + 3. Char/Inter Packets + - 3.1 Inter-Map Packets + - 3.2 Char-Map Packets + +============ +| 1. Notes | +============ +Currently the max packet size is 0xFFFF (see 'WFIFOSET()' in 'src/common/socket.c'). + +========================= +| 2. Login-Char Packets | +========================= +0x2712: + Type: HA + Structure: .W .L .L .L .B .L .L + index: 0,2,6,10,14,15,19 + len: 23 + parameter: + - cmd : packet identification (0x2712) + - aid : account identification + - login_id1: unknown @FIXME + - login_id2: unknown @FIXME + - sex: the sex of the account + - ip: the ip of the connection (obsolete) + - request_id: unknown @FIXME + desc: + - Request from char-server to authenticate an account. + +0x2713: + Type: AH + Structure: .W .L .L .L .B .B .L .L .B + index: 0,2,6,10,14,15,16,20,24 + len: 25 + parameter: + - cmd : packet identification (0x2713) + - aid : account identification + - login_id1: unknown @FIXME + - login_id2: unknown @FIXME + - sex: the sex of the account + - ok : 1=auth failed, 1=ok + - request_id: unknown @FIXME + - version: client version, (clientinfo version) + - clienttype: unknown @FIXME + desc: + - Acknowledge the authentication request from char-serv + +0x2714: + Type: HA + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x2714) + - user_count: number of user present on the char-serv + desc: + - Retrieve the number of user present on a char-serv + +0x2715: + Type: HA + Structure: .W .L 40B + index: 0,2,6 + len: 46 + parameter: + - cmd : packet identification (0x2715) + - aid: account identification + - email: new email for account id + desc: + - Request to update the email linked to this aid + +0x2716: + Type: HA + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x2716) + - aid: account identification + desc: + - Request the account information of aid (see 0x2717) + +0x2717 + Type: AH + Structure: .W .L .40B .L .B .B .11B .5B .L .L .B .B .B + index: 0,2,6,46,50,51,52,63,68,72,76,77,78 + len: 79 + parameter: + - cmd: packet identification (0x2717) + - aid: account identification + - email: email of aid + - expiration_time: unknow @FIXME + - group_id: the group the aid belong too + - char_slots: number of slot available the account have (will be displayed on client) + - birthdate: birthdate of aid + - pincode: current pincode of aid + - pincode_change: new pincode of aid + - bank_vault: value in bank for this aid + - isvip: if this aid is currently vip or not + - char_vip: number of charslot that are vip (could only do creation on if you are vip) + - MAX_CHAR_BILLING: number of charslort that are for billing + desc: + - Request account data + +0x2718 + Type: AH + Structure: .W + index: 0 + len: 2 + parameter: + - cmd : packet identification (0x2718) + desc: + - Keep alive packet, (confirm we are still connected) + +0x2719: + Type: HA + Structure: .W + index: 0,2 + len: 2 + parameter: + - cmd : packet identification (0x2719) + desc: + - Ping request from char-server + +0x2720: +0x2721: + free + +0x2722: + Type: HA + Structure: .W .L .40B .40B + index: 0,2,6,46 + len: 86 + parameter: + - cmd : packet identification (0x2722) + - aid: account identification + - actual_email: current email address + - new_email: new email address + desc: + - Map server sends information to change an email of an account via char-server + +0x2723: + Type: AH + Structure: .W L B + index: 0,2,6 + len: 7 + parameter: + - cmd : packet identification (0x2723) + - aid: account identification + - sex: sex of account + 0 = SEX_FEMALE + 1= SEX_MALE + 2=SEX_SERVER + desc: + - Acknowledge sex update + +0x2724: + Type: HA + Structure: .W .L L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x2724) + - t_aid: account identification of target + - state: state of account + - 0 : unblock + - 5 : block (Connection refused) + desc: + - Receiving an account state update request from a map-server (relayed via char-server) + +0x2725: + Type: HA + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x2725) + - t_aid: account identification of target + - timediff: tick to add or remove to a timestamp + desc: + - Receiving of map-server via char-server a ban request (alter the ban time) + +0x2726: + free + +0x2727: + Type: HA + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x2727) + - aid: account identification + desc: + - Receive a request to change sex (sex is reversed) + +0x2728: + Type: HA + Structure: .W .W L .L { .?B .?B } + index: 0,2,4,8,13 + len: variable (reg size+4) + parameter: + - cmd : packet identification (0x2728) + - len: pakcet size + - aid: account identification + - cid : char identification + - str : name of variable in registry + - value : value of varaible in registry + desc: + - Receive an request to fetch account_reg2 from a char-server, see packet 0x3004 (mapif_parse_Registry) + + +0x2729: + Type: AH + Structure: .W .L .L .L .B { ?B ?B } + index: 0,2,4,8,12,13 + len: variable (reg2 size+13) + parameter: + - cmd : packet identification (0x2729) + - len: pakcet size + - aid: account identification + - cid : char identification + -type: + -type: + 1: account2 registry (only one used atm) + 2: account registry + 3: char registry + - str : name of variable in registry + - value : value of varaible in registry + desc: + - Receive account_reg2 registry, forward to map servers. + +0x272a: + Type: HA + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x272a) + - t_aid: account identification + desc: + - request unban account + + +0x272b: + Type: HA + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x272b) + - t_aid: account identification + desc: + - Add aid to list of online user on loginserv (setacconline). + +0x272c: + Type: HA + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x272c) + - t_aid: account identification + desc: + - Remove aid to the list of online user (setaccoffline). + +0x272d: + Type: HA + Structure: .W W L {.L}* + index: 0,2,4,8 + len: 8+users*4 + parameter: + - cmd : packet identification (0x272d) + - len : size of packet + - users: number of users connected to char-serv + - aid: account identification + desc: + - receive account list from char-server + +0x272e: + Type: HA + Structure: .W .L .L + index: 0,2,4,6 + len: 10 + parameter: + - cmd : packet identification (0x272e) + - aid: account identification + - cid: char identification + desc: + - request accreg2 to login + +0x272f: +0x2730: + free + +0x2731: + Type: AH + Structure: .W L B .L + index: 0,2,6,7 + len: 11 + parameter: + - cmd : packet identification (0x2731) + - aid: account identification + - state: 0=change of status, 1=ban + - status|date: status or final date of a banishment + desc: + - Notify char-serv of a state change or ban (accbannotification). + +0x2732: +0x2733: + free + +0x2734: + Type: AH + Structure: .W L + index: 0,2, + len: 6 + parameter: + - cmd : packet identification (0x2734) + - aid: account identification + desc: + - Account is already marked as online. (Login server request to kick a character out). + +0x2735: + Type: AH + Structure: .W + index: 0 + len: 2 + parameter: + - cmd : packet identification (0x2735 + desc: + - ip address update signal from login server + +0x2736: + Type: HA + Structure: .W L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x2736) + - ip: ip of char server + desc: + - IP update for char-server + +0x2737: + Type: HA + Structure: .W + index: 0 + len: 2 + parameter: + - cmd : packet identification (0x2737) + desc: + - Request to set all account as offline from char-server + +0x2738: + Type: HA + Structure: .W L ?B + index: 0,2,6 + len: 11 @FIXME should be 6+PINCODE_LENGTH+1 + parameter: + - cmd : packet identification (0x2738) + - aid : account identification + - pincode : new pincode code + desc: + - Change PIN Code of an account + +0x2739: + Type: HA + Structure: .W L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x2739) + - aid : account identification + desc: + - Login notify char that too many wrong PIN code entered. (fail auth) + +0x273a +0x273b +0x273c +0x273d +0x273e +0x273f + free + +0x2740: + Type: HA + Structure: .W .L .B .L + index: 0,2,6,7 + len: 11 + parameter: + - cmd : packet identification (0x2740) + - aid: account identification + - type: + - data: + desc: + - Request to update bank_vault + +0x2741: + Type: AH + Structure: .W .L .B .L + index: 0,2,6,7 + len: 11 + parameter: + - cmd : packet identification (0x2741) + - aid : account identification + - type : 1=select, 2=upd and save + - data : new bank vault + desc: + - Request the bank info of login + +0x2742: + Type: HA + Structure: .W .L .B .L .L + index: 0,2,6,7,11 + len: 15 + parameter: + - cmd : packet identification (0x2742) + - aid: account identification + - type: &1 ack vip data to char-serv, &2 add duration + - timediff: tick to add to viptime + - mapfd: map-serv link to ack if type&1 + desc: + - Received a VIP data request from char + +0x2743: + Type: AH + Structure: .W .L .L .B .L .L .B + index: 0,2,6,10,11,15,16 + len: 20 + parameter: + - cmd : packet identification (0x2743) + - aid: account identification + - vip_time: timestamp of vip_time if he is vip + - isvip: is this account in vip mode atm + - groupid: group id of account + - isgm: is he a gm + - mapfd: map-serv link to ack + desc: + - Transmit vip specific data to char-serv (will be transfered to mapserv) + +========================= +| 3.1 Inter-Map Packets | +========================= + +0x3000 + Type: ZI + Structure: .W W L W W W W ?B + index: 0,2,4,8,10,12,14,16 + len: 16+msglen + parameter: + - cmd : packet identification (0x3000) + - len : packet size + - fontColor: (standard broadcast color=0xFF000000) + - fontType: + - fontSize: + - fontAlign: + - fontY: + - mes: message to send + desc: + - Broadcasts a message to all map-servs connected to this char-serv + - NB carefull (also using cmd=3000 rAthena_report but encapsulate it into cmd 3008 for map-char) + + +0x3001 + Type: ZI + Structure: .W W (NAME_LENGTH)B (NAME_LENGTH)B ?B + index: 0,2,4,4+NAME_LENGTH,4+2*NAME_LENGTH + len: 52+mes_len + parameter: + - cmd : packet identification (0x3001) + - len: packet size + - name : sender name of msg + - nick : receiver name of msg + - mes : message to send + desc: + - Send a whisper to another player + +0x3002 + Type: ZI + Structure: .W < + index: 0,2,6 + len: 7 + parameter: + - cmd : packet identification (0x3002) + - id: cid (@FIXME of who ?) + - flag: 0=success, 1=target not found, 2=ignored by target + desc: + - Inform the char-serv of the result of the whisper + +0x3003 + Type: ZI + Structure: .W .w .24B .l .?B + index: + len: 32+mes_len + parameter: + - cmd : packet identification (0x3003) + - len: 32+mes_len + - wisp_name+permission + - mes_len + desc: + - Transmission of GM only Wisp/Page from server to inter-server + +0x3004 + Type: ZI + Structure: .W .L .L .B { ?B ?B }? + index: 0,4,8,12,13 + len: variable : 13+regnum*(len variable name+len value) (max=288 * MAX_REG_NUM+13) + parameter: + - cmd : packet identification (0x3004) + - aid: account identification + - cid: char identification + -type: + 1: account2 registry + 2: account registry + 3: char registry + -str: registre variable identifiant, (variable name) + -value: variable value + desc: + - Map-serv is requesting Char-serv to save registry values. (type=1 will forward data to login-serv) + +0x3005 + Type: ZI + Structure: .W .L .L .B .B .B + index: 0,2,6,10,11,12 + len: 13 + parameter: + - cmd : packet identification (0x3005) + - aid: + - cid: + -acc_reg2 : request account registry (permanent variable of account, save on login-serv) + -acc_reg : request account registry (permanent variable of account , save on char-serv) + -ch_reg : request char registry (permanent variable of char) + desc: + - Request the registries for this player. + +0x3006 + Type: ZI + Structure: .W .L .L .B .? + index: 0,2,6,10,11 + len: 12+NAME_LENGTH + parameter: + - cmd : packet identification (0x3006) + - aid + - cid + - type + - NAME_LENGTH + desc + +0x3007 + Type: ZI + Structure: .W .L .L .L + index: 0,2,6,10,14 + len: 14+NAME_LENGTH + parameter: + - cmd : packet identification (0x3007) + - u_fd + - aid + - group_lv + - query + desc: + - Request acc info + +0x3018 + Type: ZI + Structure: .W .L .L + index 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x3018) + - aid + - gid + desc: + - Request guild storage + +0x3019 + Type: ZI + Structure: .W .W .L .L + index: 0,2,4,8,12 + len: 12+guild_storage + parameter: + - cmd : packet identification (0x3019) + - guild_storage + - aid + - gid + desc: + - Send guild storage + +0x3020 + Type: ZI + Structure: .W .W .24B .B .B .?B + index: 0,2,4,28,29,30 + len: variable: 28+party_member (max=64) + parameter: + - cmd : packet identification (0x3020) + - party_member + - name + - item + - item2 + - member + desc: + - Party creation request + +0x3021 + Type: ZI + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x3021) + - party_id + - cid + desc: + - Party information request + +0x3022 + Type: ZI + Structure: .W .W .L .?B + index: 0,2,4,8 + len: variable: 8+party_member (Max=42) + parameter: + - cmd : packet identification (0x3022) + - party_member + - party_id + - member + desc: + - Request to add a member to party + +0x3023 + Type: ZI + Structure: .W .L .L .W .W + index: 0,2,6,10,12,14 + len: 14 + parameter: + - cmd : packet identification (0x3023) + - party_id + - aid + - exp + - item + desc: + - Request to change party configuration (exp,item share) + +0x3024 + Type: ZI + Structure: .W .L .L .L + index: 0,2,6,10 + len: 14 + parameter: + - cmd : packet identification (0x3024) + - party_id + - aid + - cid + desc: + - Request to leave party + +0x3025 + Type: ZI + Structure: .W .L .L .L .W .B .W + index: 0,2,6,10,14,16,17 + len: 19 + parameter: + - cmd : packet identification (0x3025) + - party_id + - aid + - cid + - mapindex + - online + - base_level + desc: + - Party change map + +0x3026 + Type: ZI + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x3026) + - party_id + desc: + - Request breaking party + +0x3027 + Type: ZI + Structure: .W .W .L .L .?B + index: 0,2,4,8,12 + len: variable: 12+len + parameter: + - cmd : packet identification (0x3027) + - len + - party_id + - aid + - mes + desc: + - Sending party chat + +0x3029 + Type: ZI + Structure: .W .L .L .L + index: 0,2,6,10 + len: 14 + parameter: + - cmd : packet identification (0x3029) + - party_id + - aid + - cid + desc: + - Request a new leader for party + +0x302A + Type: ZI + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x302a) + - share_lvl + desc: + - Request to update party share level + +0x3030 + Type: ZI + Structure: .W .W .L .?B .?B + index: 0,2,4,8,8+NAME_LENGTH + len: + parameter: + - cmd : packet identification (0x3030) + - guild_member + - aid + - name + - master + desc: + - Request a Guild creation + +0x3031 + Type: ZI + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x3031) + - guild_id + desc: + - Request Guild information + +0x3032 + Type: ZI + Structure: .W .W .L .?B + index: 0,2,4,8 + len: variable: 8+guild_member + parameter: + - cmd : packet identification (0x3032) + desc: + - Request to add member to the guild + +0x3033 + Type: ZI + Structure: .W .W .L .?B + index: 0,2,4,8 + len: variable: 8+len + parameter: + - cmd : packet identification (0x3033) + - len + - guild_id + - name + desc: + - Request a new leader for guild + +0x3034 + Type: ZI + Structure: .W .L .L .L .B .40B + index: 0,2,6,10,14,15 + len: 55 + parameter: + - cmd : packet identification (0x3034) + - guild_id + - aid + - cid + - flag + - mes + desc: + - Request to leave guild + +0x3035 + Type: ZI + Structure: .W .L .L .L .B .W .W + index: 0,2,6,10,14,15,17 + len: 19 + parameter: + - cmd : packet identification (0x3035) + - guild_id + - aid + - cid + - online + - lv + - class_ + desc: + - Update request / Lv online status of the guild members + +0x3036 + Type: ZI + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x3036) + - guild_id + desc: + - Guild disbanded notification + +0x3037 + Type: ZI + Structure: .W .W .L .L .?B + index: 0,2,4,8,12 + len: variable: 12+len + parameter: + - cmd : packet identification (0x3037) + - len + - guild_id + - aid + - mes + desc: + - Send a guild message + +0x3039 + Type: ZI + Structure: .W .W .L .W .?B + index: 0,2,4,8,10 + len: variable: 10+len + parameter: + - cmd : packet identification (0x3039) + - len + - guild_id + - type + - data + desc: + - Request a change of Guild basic information + +0x303a + Type: ZI + Structure: .W .W .L .L .L .W .?B + index: 0,2,4,8,12,16,18 + len: variable: 18+len + parameter: + - cmd : packet identification (0x303a) + - len + - guild_id + - aid + - cid + - type + - data + desc: + - Request a change of Guild member information + +0x303b + Type: ZI + Structure: .W .W .L .L

.?B + index: 0,2,4,8,12 + len: variable: 12+guild_position + parameter: + - cmd : packet identification (0x303b) + - guild_position + - guild_id + - idx + - p + desc: + - Request a change of Guild title + +0x303c + Type: ZI + Structure: .W .L .L .L .L + index: 0,2,6,10,14 + len: 18 + parameter: + - cmd : packet identification (0x303c) + - guild_id + - skill_id + - aid + - max + desc: + - Request an update of Guildskill skill_id + +0x303d + Type: ZI + Structure: .W .L .L .L .L .B + index: 0,2,6,10,14,18 + len: 19 + parameter: + - cmd : packet identification (0x303d) + - guild_id1 + - guild_id2 + - account_id1 + - account_id2 + - flag + desc: + - Request a new guild alliance + +0x303e + Type: ZI + Structure: .W .L .60B .120B + index: 0,2,6,66 + len: 186 + parameter: + - cmd : packet identification (0x303e) + - guild_id + - mes1 + - mes2 + desc: + - Request to change guild notice + +0x303f + Type: ZI + Structure: .W .W .L <0>.L .?B + index: 0,2,4,8,12 + len: variable: 12+len (Max=2012) + parameter: + - cmd : packet identification (0x303f) + desc: + - Request to change guild emblem + +0x3040 + Type: ZI + Structure: .W .W .?B + index: 0,2,4 + len: variable: 4 + num * 2,147,483,647 + parameter: + - cmd : packet identification (0x3040) + - num + - castle_ids + desc: + - Requests guild castles data from char-server + +0x3041 + Type: ZI + Structure: .W .W .B .L + index: 0,2,4,5 + len: 9 + parameter: + - cmd : packet identification (0x3041) + - castle_ids + - index + - value + desc: + - Request change castle guild owner and save data + +0x3048 + Type: ZI + Structure: .W .L .B + index: 0,2,6 + len: 7 + parameter: + - cmd : packet identification (0x3048) + - cid + - flag + desc: + - Inbox request + +0x3049 + Type: ZI + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x3049) + - mail_id + desc: + - Mail read + +0x304a + Type: ZI + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x3093) + - cid + - mail_id + desc: + - Mail get attachment + +0x304b + Type: ZI + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x3093) + - cid + - mail_id + desc: + - Mail delete + +0x304c + Type: ZI + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x3093) + - cid + - mail_id + desc: + - Mail return + +0x304d + Type: ZI + Structure: .W .W .L .?B + index: 0,2,4,8 + len: variable: 8+mail_message + parameter: + - cmd : packet identification (0x3093) + - len + - aid + - msg + desc: + - Mail send + +0x3050 + Type: ZI + Structure: .W .W .L .W .L .W .?B + index: 0,2,4,8,10,14,16 + len: variable: 16+NAME_LENGTH + parameter: + - cmd : packet identification (0x3093) + - len + - cid + - type + - price + - page + - searchtext + desc: + - Auction request list + +0x3051 + Type: ZI + Structure: .W .W .?B @FIXME + index: 0,2,4 + len: variable: 4+auction + parameter: + - cmd : packet identification (0x3093) + - len + - auction + desc: + - Auction register + +0x3052 + Type: ZI + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x3093) + - cid + - auction_id + desc: + - Auction cancel + +0x3053 + Type: ZI + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x3093) + - cid + - auction_id + desc: + - Auction close + +0x3055 + Type: ZI + Structure: .W .W .L .L .L .?B + index: 0,2,4,8,12,16 + len: variable: 16+NAME_LENGTH + parameter: + - cmd : packet identification (0x3093) + - len + - cid + - auction_id + - bid + desc: + - Auction bid + +0x3056 + Type: ZI + Structure: .W .L .L .W + index: 0,2,6,10 + len: 12 + parameter: + - cmd : packet identification (0x3093) + - cid + - aid + - guild_id + desc: + - Itembound request + +0x3060 + Type: ZI + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x3093) + - cid + desc: + - Requests a character's quest log entries to the inter server. + +0x3061 + Type: ZI + Structure: .W .W .L .?B + index: 0,2,4,8 + len: variable: 8+num_quests + parameter: + - cmd : packet identification (0x3093) + desc: + - Requests to the inter server to save a character's quest log entries. + +0x3070 + Type: ZI + Structure: .W .W .?B + index: 0,2,4 + len: variable: 4+s_mercenary + parameter: + - cmd : packet identification (0x3093) + - size + - merc + desc: + - Mercenary create + +0x3071 + Type: ZI + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x3071) + - merc_id + - cid + desc: + - Mercenary request + +0x3072 + Type: ZI + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x3072) + - merc_id + desc: + - Mercenary delete + +0x3073 + Type: ZI + Structure: .W .W .?B + index: 0,2,4 + len: variable: 4+s_mercenary + parameter: + - cmd : packet identification (0x3073) + - size + - merc + desc: + - Mercenary save + +0x307c + Type: ZI + Structure: .W .W .?B + index: 0,2,4 + len: variable: 4+s_elemental + parameter: + - cmd : packet identification (0x307c) + - size + - ele + desc: + - Elemental create + +0x307d + Type: ZI + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x307d) + - ele_id + - cid + desc: + - Elemental request + +0x307e + Type: ZI + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x307e) + - ele_id + desc: + - Elemental delete + +0x307f + Type: ZI + Structure: .W .W .?B + index: 0,2,4 + len: variable: 4+s_elemental + parameter: + - cmd : packet identification (0x307f) + - size + - ele + desc: + - Elemental save + +0x3080 + Type: ZI + Structure: .W .L .L .W .W .W .W .W .W .B .B + index: 0,2,6,10,12,14,16,18,20,22,23,24 + len: variable: 24+NAME_LENGTH + parameter: + - cmd : packet identification (0x3080) + - aid + - cid + - pet_class + - pet_lv + - pet_egg_id + -pet_equip + - intimate + - hungry + - rename_flag + - incubate + desc: + - Pet create + +0x3081 + Type: ZI + Structure: .W .L .L .L + index: 0,2,6,10 + len: 14 + parameter: + - cmd : packet identification (0x3081) + - aid + - cid + - pet_id + desc: + - Request pet data + +0x3082 + Type: ZI + Structure: .W .W .L

.?B @FIXME + index: 0,2,4,8 + len: variable: 8+s_pet + parameter: + - cmd : packet identification (0x3082) + - ? + - aid + - p + desc: + - Save pet data + +0x3083 + Type: ZI + Structure: .W .L + index: 0,2 + len 6: + parameter: + - cmd : packet identification (0x3083) + - pet_id + desc: + - Delete pet data + +0x3090: + Type: ZI + Structure: .W .W .L .?B + index: 0,2,4,8 + len: variable: 8+s_homunculus + parameter: + - cmd : packet identification (0x3090) + - s_homunculus + - aid + - sh + desc: + - Homunculus create + +0x3091: + Type: ZI + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x3091) + - aid + - homun_id + desc: + - Homunculus request load + +0x3092: + Type: ZI + Structure: .W .W .L .?B + index: 0,2,4,8 + len: variable: 8+s_homunculus + parameter: + - cmd : packet identification (0x3092) + - s_homunculus + - aid + - sh + desc: + - Homunculus request save + +0x3093: + Type: ZI + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x3093) + - homun_id + desc: + - Homunculus request delete + +0x3094: + Type: ZI + Structure: .W .L .L .?B + index: 0,2,6,10 + len: variable: 10+name + parameter: + - cmd : packet identification (0x3094) + - aid + - cid + - name + desc: + - Homunculus rename + + + +0x3800: + Type: IZ + Structure: .W .W .L .W .W .W .W .?B + index: 0,2,4,8,10,12,14,16 + len: variable: 16+len + parameter: + - cmd : packet identification (0x3800) + - len + - fontColor + - fontType + - fontSize + - fontAlign + - fontY + - mes + desc: + - Send broadcast message + +0x3801 + Type: IZ + Structure: .W .W .L .24B .24B .?B + index: 0,2,4,8,32,56 + len: variable: 56+len (Max=1991) + parameter: + - cmd : packet identification (0x3801) + - len + - id + - src + - dst + - msg + desc: + - Send whisper message + +0x3802 + Type: IZ + Structure: .W .24B .B + index: 0,2,26 + len: 27 + parameter: + - cmd : packet identification (0x3802) + - src + - flag + desc: + - Whisper sending result + +0x3803 + Type: IZ + Structure: .W .W .24B .W .?B @FIXME + index: 0,2 + len: variable: 30+message + parameter: + - cmd : packet identification (0x3803) + - + desc: + - Parse whisper to GM + +0x3804 + Type: IZ + Structure: .W .W .L .L .B + index: 0,2,4,8,12 + len: variable: 13 or p (Max=5013) + parameter: + - cmd : packet identification (0x3804) + - ? + - aid + - cid + - type + desc: + - Account registry transfer to map-server + +0x3806 + Type: IZ + Structure: .W .L .L .B .B .B + index: 0,2,6,10,11,12 + len: 13 + parameter: + - cmd : packet identification (0x3806) + - aid + - cid + - type + - flag + - name + desc: + - mapif_namechange_ack + +0x3807 + Type: IZ + Structure: .W .W .L .L .?B + index: 0,2,4,8,12 + len: variable: 12+len + parameter: + - cmd : packet identification (0x3807) + - len + - u_fd + - aid + - msg_out + desc: + - sends a mesasge to map server (fd) to a user (u_fd) although we use fd we keep aid for safe-check + +0x3818 + Type: IZ + Structure: .W .W .L .L .B .?B + index: 0,2,4,8,12,13 + len: variable: 13+guild_storage + parameter: + - cmd : packet identification (0x3818) + - len + - aid + - guild_id + - flag + - guild_storage + desc: + - mapif_load_guild_storage + +0x3819 + Type: IZ + Structure: .W .L .L .B + index: 0,2,6,10 + len: 11 + parameter: + - cmd : packet identification (0x3819) + - aid + - guild_id + - fail + desc: + - mapif_save_guild_storage_ack + +0x3820 + Type: IZ + Structure: .W .L .L .B .L .?B + index: 0,2,6,10,11,15 + len: 39 + parameter: + - cmd : packet identification (0x3820) + - aid + - char_id + - ? + - party_id + - name + desc: + - ACK party creation + +0x3821 + Type: IZ + Structure: .W .W .L .L + index: 0,2,4,8 + len: 12 + parameter: + - cmd : packet identification (0x3821) + - ? + - char_id + - party_id + desc: + - Party information not found + +0x3822 + Type: IZ + Structure: .W .L .L .L .B + index: 0,2,6,10,14 + len: 15 + parameter: + - cmd : packet identification (0x3822) + - party_id + - account_id + - char_id + - flag + desc: + - mapif_party_memberadded + +0x3823 + Type: IZ + Structure: .W .L .L .W .W .B + index: 0,2,6,10,12,14,15? + len: 16? + parameter: + - cmd : packet identification (0x3823) + - party_id + - account_id + - exp + - item + - flag + - ? + desc: + - Party setting change notification + +0x3824 + Type: IZ + Structure: .W .L .L .L .?B + index: 0,2,6,10,14 + len: 16? + parameter: + - cmd : packet identification (0x3824) + - party_ud + - account_id + - char_id + - ? + desc: + - Withdrawal notification party + +0x3825 + Type: IZ + Structure: .W .L .L .L .W .B .W .?B + index: 0,2,6,10,14,16,17,19 + len: 20? + parameter: + - cmd : packet identification (0x3825) + - party_id + - account_id + - char_id + - map + - online + - lv + - ? + desc: + - Party map update notification + +0x3826 + Type: IZ + Structure: .W .L .B .?B + index: 0,2,6,7 + len: 16 + parameter: + - cmd : packet identification (0x3826) + - party_id + - flag + - ? + desc: + - Dissolution party notification + +0x3827 + Type: IZ + Structure: .W .W .L .L .?B + index: 0,2,4,8,12 + len: variable: 12+len (max=512) + parameter: + - cmd : packet identification (0x3827) + - len + - party_id + - account_id + - mes + desc: + - mapif_party_message + +0x3830 + Type: IZ + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x3830) + - account_id + - guild_id + desc: + - mapif_guild_created + +0x3831 + Type: IZ + Structure: .W .W .L .?B + index: 0,2,4,8 + len: 12 + parameter: + - cmd : packet identification (0x3831) + - ? + - guild_id + - ? + desc: + - mapif_guild_noinfo + +0x3832 + Type: IZ + Structure: .W .L .L .L .B + index: 0,2,6,10,14 + len: 15 + parameter: + - cmd : packet identification (0x3832) + - guild_id + - account_id + - char_id + - flag + desc: + - ACK member add + +0x3834 + Type: IZ + Structure: .W .L .L .L .B .40B .?B + index: 0,2,6,10,14,15,55 + len: variable: 55+NAME_LENGTH + parameter: + - cmd : packet identification (0x3834) + - guild_id + - account_id + - char_id + - flag + - mes + - name + desc: + - mapif_guild_withdraw + +0x3835 + Type: IZ + Structure: .W .L .L .L .B .W .W + index: 0,2,6,10,14,15,17 + len: 19 + parameter: + - cmd : packet identification (0x3835) + - guild_id + - account_id + - char_id + - online + - lv + - class_ + desc: + - Send short guild member's info + +0x3836 + Type: IZ + Structure: .W .L .B + index: 0,2,6 + len: 7 + parameter: + - cmd : packet identification (0x3836) + - guild_id + - flag + desc: + - mapif_guild_broken + +0x3837 + Type: IZ + Structure: .W .W .L .L .?B + index: 0,2,4,8,12 + len: variable: 12+len (max=512) + parameter: + - cmd : packet identification (0x3837) + - len + - guild_id + - account_id + - mes + desc: + - Send guild message + +0x3839 + Type: IZ + Structure: .W .W .L .W .?B + index: 0,2,4,8,10 + len: variable: 10+len (Max=2048) + parameter: + - cmd : packet identification (0x3839) + - len + - guild_id + - type + - data + desc: + - mapif_guild_basicinfochanged + +0x383a + Type: IZ + Structure: .W .W .L .L .L .W .?B + index: 0,2,4,8,12,16,18 + len: variable: 18+len (Max=2048) + parameter: + - cmd : packet identification (0x383a) + - len + - guild_id + - account_id + - char_id + - type + - data + desc: + - mapif_guild_memberinfochanged + +0x383b + Type: IZ + Structure: .W .W .L .L .?B + index: 0,2,4,8,12 + len: variable: 12+guild_position + parameter: + - cmd : packet identification (0x383b) + - len + - guild_id + - idx + - position + desc: + - mapif_guild_position + +0x383c + Type: IZ + Structure: .W .L .L .L + index: 0,2,6,10 + len: 14 + parameter: + - cmd : packet identification (0x383c) + - guild_id + - skill_id + - account_id + desc: + - ACK guild skill up + +0x383d + Type: IZ + Structure: .W .L .L .L .L .B .?B .?B + index: 0,2,6,10,14,18,19 + len: variable: 19+2*NAME_LENGTH + parameter: + - cmd : packet identification (0x383d) + - guild_id1 + - guild_id2 + - account_id1 + - account_id2 + desc: + - ACK guild alliance + +0x383e + Type: IZ + Structure: .W .L .60B .120B .?B + index: 0,2,6,66,186 + len: 256 + parameter: + - cmd : packet identification (0x383e) + - guild_id + - mes1 + - mes2 + - ? + desc: + - Send the guild notice + +0x383f + Type: IZ + Structure: .W .W .L .L .?B + index: 0,2,4,8,12 + len: variable: 12+emblem_data + parameter: + - cmd : packet identification (0x383f) + - len + - guild_id + - emblem_id + - emblem_data + desc: + - Send emblem data + +0x3840 + Type: IZ + Structure: .W .W .?B + index: 0,2,4 + len: variable: 4+num*gc + parameter: + - cmd : packet identification (0x3840) + - len + - gc + desc: + - mapif_guild_castle_dataload + +0x3843 + Type: IZ + Structure: .W .L .L .L + index: 0,2,6,10 + len: 14 + parameter: + - cmd : packet identification (0x3843) + - guild_id + - aid + - cid + desc: + - mapif_guild_master_changed + +======================== +| 3.2 Char-Map Packets | +======================== +0x2af9 + Type: AZ + Structure: .W .B + index: 0,2 + len: 3 + parameter: + - cmd : packet identification (0x2af9) + - ? + desc: + - chrif_connectack + +0x2afb + Type: AZ + Structure: .W .B + index: 0,2 + len: variable: 3+NAME_LENGTH + parameter: + - cmd : packet identification (0x2afb) + - ? + desc: + - send name for wisp to player + +0x2afd + Type: AZ + Structure: .W .W .L .L .L .L .L .B .?B + index: 0,2,4,8,12,16,20,24,25 + len: variable: mmo_charstatus_len + parameter: + - cmd : packet identification (0x2afd) + - mmo_charstatus_len + - account_id + - ? + - ? + - ? + - ? + - ? + - cd + desc: + - auth request from map-server + +0x2b00 + Type: AZ + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x2b00) + desc: + - Send to map-servers the users count on this char-serv, (meaning the total of all mapserv) + +0x2b03 + Type: AZ + Structure: .W .L .B + index: 0,2,6 + len: 7 + parameter: + - cmd : packet identification (0x2b03) + - account_id + - ? + desc: + - Player Requesting char-select from map_serv + +0x2b04 + Type: AZ + Structure: .W .W .L .W + index: 0,2,4,8 + len: ? + parameter: + - cmd : packet identification (0x2b04) + - ? + - ip + - port + desc: + - Receive maps from some other map-server (relayed via char-server) + +0x2b06 + Type: AZ + Structure: .W .L .L .L .L .W .W .W .L .W + index: 0,2,6,10,14,16,18,20,24,28 + len: 30 + parameter: + - cmd : packet identification (0x2b06) + - account_id + - login_id1 + - login_id2 + - char_id + - map_index + - x + - y + - ip + - port + desc: + - Map-server change request acknowledgement (positive or negative) + +0x2b09 + Type: AZ + Structure: .W .L ? + index: 0,2,6 + len: 30 + parameter: + - cmd : packet identification (0x2b09) + - ? + - ? + desc: + - Lookup to search if that char_id correspond to a name. + +0x2b0b + Type: AZ + Structure: .W .W .L .L .W .?B + index: 0,2,4,8,12,14 + len: variable: 14+MAX_SKILLCOOLDOWN*skill_cooldown_data + parameter: + - cmd : packet identification (0x2b0b) + - len + - aid + - cid + - count + - skill_cooldown_data + desc: + - Retrieve and load skillcooldown for a player + +0x2b0d + Type: AZ + Structure: .W .L .L + index:0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x2b0d) + - acc + - sex + desc: + - Request char server to change sex of char + +0x2b0f + Type: AZ + Structure: .W .L .24B .W .W + index: 0,2,6,30,32 + len: 34 + parameter: + - cmd : packet identification (0x2b0f) + - aid + - name + - operation + - result + desc: + - Processing a reply to chrif_req_login_operation() (request to modify an account). + +0x2b12 + Type: AZ + Structure: .W .L .L .B + index: 0,2,6,10 + len: 11 + parameter: + - cmd : packet identification (0x2b12) + - partner_id1 + - partner_id2 + - ? + desc: + - Divorce players (only used if 'partner_id' is offline) + +0x2b14 + Type: AZ + Structure: .W .L .B .L + index: 0,2,6,7 + len: 11 + parameter: + - cmd : packet identification (0x2b14) + - id + - res + - ret_status + desc: + - Disconnection of a player (account has been banned of has a status, from login/char-server) + +0x2b1b + Type: AZ + Structure: .W .W .W .W ?B ?B ?B + index: 0,2,4,6,?,?,? + len: ? (Max=32000) + parameter: + - cmd : packet identification (0x2b1b) + - size: total packet length + - size: Alchemist block size + - size: Blacksmith block size + - + - + - + desc: + - Send map-servers fames ranking lists + +0x2b1d + Type: AZ + Structure: .W .W .L .L + index: 0,2,4,8 + len: variable: 14+50*status_change_data + parameter: + - cmd : packet identification (0x2b1d) + - len + - aid + - cid + desc: + - Map-serv requesting to send the list of sc_data the player has saved + +0x2b1e + Type: AZ + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x2b1e) + - new_ip + desc: + - Request forwarded from char-server for interserver IP sync + +0x2b1f + Type: AZ + Structure: .W .L .B + index: 0,2,6 + len: 7 + parameter: + - cmd : packet identification (0x2b1f) + - account_id + - reason + desc: + - Request to kick char from a certain map server + +0x2b20 + Type: AZ + Structure: .W .W .L .W + index: 0,2,4,8 + len: 10 + parameter: + - cmd : packet identification (0x2b20) + - len + - ip + - port + desc: + - Remove specified maps (used when some other map-server disconnects) + +0x2b21 + Type: AZ + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x2b21) + desc: + - chrif_save_ack (Received after a character has been "final saved" on the char-server) + +0x2b22 + Type: AZ + Structure: .W .B .B .L + index: 0,2,3,4 + len: 8 + parameter: + - cmd : packet identification (0x2b22) + - type + - index + - fame + desc: + - Send to map-servers the updated fame ranking lists + +0x2b24 + Type: AZ + Structure: .W + index: 0 + len: 2 + parameter: + - cmd : packet identification (0x2b24) + desc: + - Map-server keep alive packet, awnser back map that we alive as well + +0x2b25 + Type: AZ + Structure: .W .L .L .L + index: 0,2,6 + len: ? (Max=64) + parameter: + - cmd : packet identification (0x2b25) + - father_id + - mother_id + - char_id + desc: + - Removes baby from Father ID and Mother ID + +0x2b27 + Type: AZ + Structure: .W .L .L .L .B + index: 0,2,6,10,14 + len: 15 + parameter: + - cmd : packet identification (0x2b27) + - account_id + - char_id + - login_id1 + - sex + desc: + - Client authentication failed + +0x2b29 + Type: AZ + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x2b29) + - aid + - bank_vault + desc: + - Received bank data for player to be loaded + +0x2b2b + Type: AZ + Structure: .W .L .L .B .B .L + index: 0,2,6,10,11,12 + len: 16 + parameter: + - cmd : packet identification (0x2b2b) + - aid + - vip_time + - isvip + - isgm + - groupid + desc: + - Received vip-data from char-serv, fill map-serv data + +0x2b2f + Type: AZ + Structure: .W .W .L .W + index: 0,2,4,8 + len: variable: 10+50*bonus_script_data + parameter: + - cmd : packet identification (0x2b2f) + desc: + - Get bonus_script data(s) from table to load + +0x2736 + Type: ZA + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x2736) + desc: + - ip address update + +0x2afa + Type: ZA + Structure: .W .W .W + index: 0,2,4+1*4 @FIXME + len: variable 4+instance_start*4 + parameter: + - cmd : packet identification (0x2afa) + - ? + - ? + desc: + - chrif_sendmap + +0x2afc + Type: ZA + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x2afc) + - account_id + - char_id + desc: + - Request sc_data from charserver + +0x2afe + Type: ZA + Structure: .W .W + index: 0,2 + len: 4 + parameter: + - cmd : packet identification (0x2afe) + desc: + - send_usercount_tochar (unused) + +0x2aff + Type: ZA + Structure: .W .W .W .L .L + index: 0,2,4,6+8*i,6+8+i+4 + len: variable: 6+8*users + parameter: + - cmd : packet identification (0x2aff) + - len + - users + - account_id + - char_id + desc: + - Map-serv sent us all his users info, (aid and cid) so we can update online_char_db + +0x2b01 + Type: ZA + Structure: .W .W .L .L .B + index: 0,2,4,8,12 + len: variable: mmo_charstatus_len + parameter: + - cmd : packet identification (0x2b01) + desc: + - charsave of char XY account XY + +0x2b02 + Type: ZA + Structure: .W .L .L .L .L .B + index: 0,2,6,10,14,18 + len: 19 + parameter: + - cmd : packet identification (0x2b02) + - id + - login_id1 + - login_id2 + - s_ip + - packet_ver + desc: + - chrif_charselectreq + +0x2b05 + Type: ZA + Structure: .W .L .L .L .L .W .W .W .L .W .B .L .L + index: 0,2,6,10,14,18,20,22,24,28,30,31,35 + len: 39 + parameter: + - cmd : packet identification (0x2b05) + - id + - login_id1 + - login_id2 + - char_id + - mapindex + - x + - y + - ip + - port + - sex + - client_addr + - group_id + desc: + - Tell the charserver the mapchange / quest for ok + +0x2b07 + Type: ZA + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x2b07) + - char_id + - friend_id + desc: + - Asks char server to remove friend_id from the friend list of char_id + +0x2b08 + Type: ZA + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x2b08) + desc: + - Search char through id on char serv + +0x2b0a + Type: ZA + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x2b0a) + - account_id + - char_id + desc: + - Request skillcooldown from charserver + +0x2b0c + Type: ZA + Structure: .W .W .40B .40B + index: 0,2,6,46 + len: 86 + parameter: + - cmd : packet identification (0x2b0c) + - id + - actual_email + - new_email + desc: + - Change Email + +0x2b0e + Type: ZA + Structure: .W .L .24B .W .L .L .L + index: 0,2,30,36,40 + len: 44 + parameter: + - cmd : packet identification (0x2b0e) + - aid + - name + - operation_type + - timediff + - val1 + - val2 + desc: + - Send an account modification request to the login server (via char server). + +0x2b10 + Type: ZA + Structure: .W .L .L .B + index: 0,2,6,10 + len: 11 + parameter: + - cmd : packet identification (0x2b10) + - char_id + - fame + - type + desc: + - Request/Receive top 10 Fame character list + +0x2b11 + Type: ZA + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x2b11) + - partner_id1 + - partner_id2 + desc: + - Request Char Server to Divorce Players + +0x2b15 + Type: ZA + Structure: .W .W .L .L .W + index: 0,2,4,8,12 + len: variable: 14+MAX_SKILLCOOLDOWN*skill_cooldown_data + parameter: + - cmd : packet identification (0x2b15) + - len + - account_id + - char_id + - count + desc: + - Request to save skill cooldown data + +0x2b16 + Type: ZA + Structure: .W .L .L .L + index: 0,2,6,10 + len: 14 + parameter: + - cmd : packet identification (0x2b16) + - base_rate + - job_rate + - drop_rate + desc: + - Send rates and motd to char server + +0x2b17 + Type: ZA + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x2b17) + - char_id + - account_id + desc: + - Tell char-server character disconnected + +0x2b18 + Type: ZA + Structure: .W + index: 0 + len: 2 + parameter: + - cmd : packet identification (0x2b18) + desc: + - Tell char-server to reset all chars offline + +0x2b19 + Type: ZA + Structure: .W .L .L + index: 0,2,6 + len: 10 + parameter: + - cmd : packet identification (0x2b19) + - char_id + - account_id + desc: + - Tell char-server character is online + +0x2b1a + Type: ZA + Structure: .W + index: 0 + len: 2 + parameter: + - cmd : packet identification (0x2b1a) + desc: + - Build the fame ranking lists and send them + +0x2b1c + Type: ZA + Structure: .W .W .L .L .W + index: 0,2,4,8,12 + len: variable: 14+SC_MAX*status_change_data + parameter: + - cmd : packet identification (0x2b1c) + - len + - account_id + - char_id + - count + desc: + - parses the sc_data of the player and sends it to the char-server for saving + +0x2b23 + Type: ZA + Structure: .W + index: 0 + len: 2 + parameter: + - cmd : packet identification (0x2b23) + desc: + - pings the charserver (chrif_keepalive) + +0x2b26 + Type: ZA + Structure: .W .L .L .L .B .L .B + index: 0,2,6,10,14,15,19 + len: 20 + parameter: + - cmd : packet identification (0x2b26) + - account_id + - char_id + - login_id1 + - sex + - client_addr + - autotrade + desc: + - client authentication request + +0x2b28 + Type: ZA + Structure: .W .L .L .?B + index: 0,2,6,10 + len: variable: 10+NAME_LENGTH + parameter: + - cmd : packet identification (0x2b28) + - aid + - timediff + - character_name + desc: + - chrif_req_charban + +0x2b2a + Type: ZA + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x2b2a) + desc: + - chrif_req_charunban + +0x2b2d + Type: ZA + Structure: .W .L + index: 0,2 + len: 6 + parameter: + - cmd : packet identification (0x2b2d) + desc: + - Requests bonus_script data + +0x2b2e + Type: ZA + Structure: .W .W .L .W + index: 0,2,4,8 + len: variable: 10+MAX_PC_BONUS_SCRIPT*bonus_script_data + parameter: + - cmd : packet identification (0x2b2e) + - len + - char_id + - count + desc: + - Stores bonus_script data(s) to the table + +0x3008 + Type: ZA + Structure: .W .?B + index: 0,2 + len: variable: 2+len + parameter: + - cmd : packet identification (0x3008) + - buf + desc: + - chrif_send_report diff --git a/doc/skill_require_db.txt b/doc/skill_require_db.txt index e8eb5ed27a..f33656d10d 100644 --- a/doc/skill_require_db.txt +++ b/doc/skill_require_db.txt @@ -3,7 +3,7 @@ //===== By: ================================================== //= rAthena Dev Team //===== Last Updated: ======================================== -//= 20140719 +//= 20140831 //===== Description: ========================================= //= Explanation of the skill_require_db.txt file and structure. //============================================================ @@ -13,7 +13,8 @@ SkillID,HPCost,MaxHPTrigger,SPCost,HPRateCost,SPRateCost,ZenyCost,RequiredWeapon --------------------------------------- -SkillID: The ID of the skill. (See \db\[re|pre-re]\skill_db.txt for more details) +SkillID: The ID of the skill. + See 'db\(pre-)re\skill_db.txt' for more details. --------------------------------------- @@ -21,7 +22,7 @@ HPCost: Amount of HP needed to use the skill. --------------------------------------- -MaxHPTrigger: Player's HP has to be below this % of Max HP, in order to use the skill. +MaxHPTrigger: Player's HP must be below this % of Max HP in order to use the skill. --------------------------------------- @@ -29,11 +30,13 @@ SPCost: Amount of SP needed to use the skill. --------------------------------------- -HPRateCost: If more than 0, it's a percentage of the player's current HP. If less than 0, it's a percentage of the player's Max HP. +HPRateCost: If more than 0, the percentage of the player's current HP. + If less than 0, the percentage of the player's Max HP. --------------------------------------- -SPRateCost: If more than 0, it's a percentage of the player's current SP. If less than 0, it's a percentage of the player's Max SP. +SPRateCost: If more than 0, the percentage of the player's current SP. + If less than 0, the percentage of the player's Max SP. --------------------------------------- @@ -41,7 +44,7 @@ ZenyCost: Amount of Zeny needed to use the skill. --------------------------------------- -RequiredWeapons: Player needs to equip this type of weapon, in order to use the skill. +RequiredWeapons: Weapon type needed to use the skill. 0: bare fist 1: Daggers 2: One-handed swords @@ -74,12 +77,12 @@ RequiredWeapons: Player needs to equip this type of weapon, in order to use the 29: Dagger + Axe 30: Sword + Axe -Example usage of multiple values = type1:type2:type3 -Maximum multiple value is 30. +Up to 30 ':'-separated values can be used, e.g. + type1:type2:type3 --------------------------------------- -RequiredAmmoTypes: Player needs to equip this type of ammo to use the skill. +RequiredAmmoTypes: Ammo type needed to use the skill. 1: Arrows 2: Throwable daggers 3: Bullets @@ -90,20 +93,23 @@ RequiredAmmoTypes: Player needs to equip this type of ammo to use the skill. 8: Cannonballs 9: Throwable Items (Sling Item) -Example usage of multiple values = type1:type2:type3 -Maximum multiple value is 9. +Up to 9 ':'-separated values can be used, e.g. + type1:type2:type3 + --------------------------------------- RequiredAmmoAmount: Amount of ammo needed to use the skill. --------------------------------------- -RequiredState: Specify the 'State' required to be active, in order to use the skill. +RequiredState: The active 'State' needed to use the skill. + none = Nothing special. hidden = Requires hidden status by using Hiding, Cloaking, or Chasewalk. riding = Requires the player to ride either a Peco or a Dragon. falcon = Requires a Falcon. -cart = Requires a Pushcart (For renewal, this state can be replaced by SC_PUSH_CART in 'RequiredStatuses' field). +cart = Requires a Pushcart. + For renewal, this state can be replaced by SC_PUSH_CART in 'RequiredStatuses' field. shield = Requires a shield equipped. recover_weight_rate = Requires to be less than 50% weight. move_enable = Requires to be able to move. @@ -117,9 +123,14 @@ peco = Requires riding a Peco. --------------------------------------- -RequiredStatuses: List of status needed to be active, in order to use the skill. -Example usage of values = SC_STATUS1:SC_STATUS2:SC_STATUS3 (see db/const.txt for more details). -Maximum multiple value is 3. (Refer to skill.h: MAX_SKILL_STATUS_REQUIRE) +RequiredStatuses: The active statuses needed to use the skill. + +Up to 3 ':'-separated values can be used, e.g. + SC_STATUS1:SC_STATUS2:SC_STATUS3 + +See MAX_SKILL_STATUS_REQUIRE in 'src/map/skill.h' to modify the max number +of possible values, and 'db/const.txt' for a list of status constants. + Use any number or SC_ALL to disable status requirements. --------------------------------------- @@ -128,18 +139,25 @@ SpiritSphereCost: Amount of Spirit Sphere needed to use the skill. --------------------------------------- -RequiredItemID1-10: These items will be used when players use the skill. Maximum of 10 items. +RequiredItemID1..10: Items to be consumed when the skill is used (max 10). --------------------------------------- -RequiredItemAmount1-10: Amount of item used when player uses the skill. -0 means the item is required to be in inventory but won't be consumed. ---------------------------------------- - -RequiredEquipment: Player needs to equip these equipments to use the skill. (Use Item ID). -Example usage of multiple values = item1:item2:item3 -Maximum multiple value is 10. (Refer to skill.h: MAX_SKILL_EQUIP_REQUIRE) +RequiredItemAmount1..10: Amount of each item consumed when the skill is used. + If 0, the item is required to be in the inventory but won't be consumed. --------------------------------------- -Note: On some fields, ":" delimiter means for each skill level, but there are some level dependent check. (Refer to https://github.com/rathena/rathena/blob/master/src/map/skill.c#L14963) \ No newline at end of file +RequiredEquipment: Specific equipment IDs needed to use the skill. + +Up to 10 ':'-separated values can be used, e.g. + item1:item2:item3 + +See MAX_SKILL_EQUIP_REQUIRE in 'src/map/skill.h' to modify the max number +of possible values. + +--------------------------------------- + +NOTE: On some fields, the ':' delimiter means for each skill level, but there + are some level dependent checks. See 'skill_get_requirement()' in + 'src/map/skill.c'. \ No newline at end of file diff --git a/npc/re/instances/WolfchevLaboratory.txt b/npc/re/instances/WolfchevLaboratory.txt index 6794a35683..f501480367 100644 --- a/npc/re/instances/WolfchevLaboratory.txt +++ b/npc/re/instances/WolfchevLaboratory.txt @@ -925,7 +925,7 @@ lhz_cube,233,24,4 script Sorcerer#Bio4Reward 4_M_UMDANCEKID,{ .@equip_item = getequipid(.@part); .@lhz_max_num = 4000; if (.@equip_item == 13069 || .@equip_item == 1291 || .@equip_item == 1392 || - .@equip_item == 1393 || .@equip_item = 1435 || .@equip_item == 1490 || + .@equip_item == 1393 || .@equip_item == 1435 || .@equip_item == 1490 || .@equip_item == 13069 || .@equip_item == 13070 || .@equip_item == 16017) { .@type = 1; if (.@equip_item == 1490) diff --git a/npc/scripts_test.conf b/npc/scripts_test.conf index 93be340d6a..650e9b4d45 100644 --- a/npc/scripts_test.conf +++ b/npc/scripts_test.conf @@ -3,5 +3,6 @@ // -------------------------------------------------------------- // These scripts are meant for regression test purposes. +npc: npc/test/infinite_warp.txt npc: npc/test/OnInterInit.txt npc: npc/test/npc_test_checkweight.txt diff --git a/npc/test/infinite_warp.txt b/npc/test/infinite_warp.txt index 0e3c381018..4deffa1ad3 100644 --- a/npc/test/infinite_warp.txt +++ b/npc/test/infinite_warp.txt @@ -1,3 +1,13 @@ +//===== rAthena Script ======================================= +//= Test: Infinite Warp Loop +//===== By: ================================================== +//= rAthena Dev Team +//===== Last Updated: ======================================== +//= 20140829 +//===== Description: ========================================= +//= Tests infinite warp loop prevention. +//============================================================ + e_tower,74,116,0 warp #inf_warp1 2,2,e_tower,81,108 e_tower,81,108,0 warp #inf_warp2 2,2,e_tower,75,84 e_tower,75,84,0 warp #inf_warp3 2,2,e_tower,74,116