3 Copyright (C) 2010-2013 celeron55, Perttu Ahola <celeron55@gmail.com>
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU Lesser General Public License as published by
7 the Free Software Foundation; either version 2.1 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public License along
16 with this program; if not, write to the Free Software Foundation, Inc.,
17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20 #ifndef CLIENTSERVER_HEADER
21 #define CLIENTSERVER_HEADER
23 #include "util/pointer.h"
25 SharedBuffer<u8> makePacket_TOCLIENT_TIME_OF_DAY(u16 time, float time_speed);
28 changes by PROTOCOL_VERSION:
31 Base for writing changes here
36 Add TOCLIENT_CRAFTITEMDEF
38 Obsolete TOSERVER_CLICK_ACTIVEOBJECT
39 Obsolete TOSERVER_GROUND_ACTION
41 Make players to be handled mostly as ActiveObjects
43 Only non-cached textures are sent
46 Obsolete TOCLIENT_TOOLDEF
47 Obsolete TOCLIENT_CRAFTITEMDEF
48 Compress the contents of TOCLIENT_ITEMDEF and TOCLIENT_NODEDEF
50 Digging based on item groups
53 ContentFeatures and NodeDefManager use a different serialization
54 format; better for future version cross-compatibility
58 Version raised to force 'fly' and 'fast' privileges into effect.
59 Node metadata change (came in later; somewhat incompatible)
61 TileDef in ContentFeatures
64 TOCLIENT_INVENTORY_FORMSPEC
67 TOSERVER_INVENTORY_FIELDS
69 TOCLIENT_DETACHED_INVENTORY
71 InventoryList field "Width" (deserialization fails with old versions)
73 Added transfer of player pressed keys to the server
74 Added new messages for mesh and bone animation, as well as attachments
75 GENERIC_CMD_SET_ANIMATION
76 GENERIC_CMD_SET_BONE_POSITION
77 GENERIC_CMD_SET_ATTACHMENT
79 Serialization format changes
81 TOCLIENT_SHOW_FORMSPEC
83 Serialization format change: include backface_culling flag in TileDef
84 Added rightclickable field in nodedef
85 TOCLIENT_SPAWN_PARTICLE
86 TOCLIENT_ADD_PARTICLESPAWNER
87 TOCLIENT_DELETE_PARTICLESPAWNER
89 damageGroups added to ToolCapabilities
90 sound_place added to ItemDefinition
92 GENERIC_CMD_SET_PHYSICS_OVERRIDE
95 #define LATEST_PROTOCOL_VERSION 19
97 // Server's supported network protocol range
98 #define SERVER_PROTOCOL_VERSION_MIN 13
99 #define SERVER_PROTOCOL_VERSION_MAX LATEST_PROTOCOL_VERSION
101 // Client's supported network protocol range
102 #define CLIENT_PROTOCOL_VERSION_MIN 13
103 #define CLIENT_PROTOCOL_VERSION_MAX LATEST_PROTOCOL_VERSION
105 // Constant that differentiates the protocol from random data and other protocols
106 #define PROTOCOL_ID 0x4f457403
108 #define PASSWORD_SIZE 28 // Maximum password length. Allows for
109 // base64-encoded SHA-1 (27+\0).
111 #define TEXTURENAME_ALLOWED_CHARS "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789_."
115 TOCLIENT_INIT = 0x10,
117 Server's reply to TOSERVER_INIT.
118 Sent second after connected.
120 [0] u16 TOSERVER_INIT
121 [2] u8 deployed version
122 [3] v3s16 player's position + v3f(0,BS/2,0) floatToInt'd
123 [12] u64 map seed (new as of 2011-02-27)
124 [20] f1000 recommended send interval (in seconds) (new as of 14)
126 NOTE: The position in here is deprecated; position is
127 explicitly sent afterwards
130 TOCLIENT_BLOCKDATA = 0x20, //TODO: Multiple blocks
131 TOCLIENT_ADDNODE = 0x21,
132 TOCLIENT_REMOVENODE = 0x22,
134 TOCLIENT_PLAYERPOS = 0x23, // Obsolete
137 // Followed by an arbitary number of these:
138 // Number is determined from packet length.
140 [N+2] v3s32 position*100
141 [N+2+12] v3s32 speed*100
142 [N+2+12+12] s32 pitch*100
143 [N+2+12+12+4] s32 yaw*100
146 TOCLIENT_PLAYERINFO = 0x24, // Obsolete
149 // Followed by an arbitary number of these:
150 // Number is determined from packet length.
155 TOCLIENT_OPT_BLOCK_NOT_FOUND = 0x25, // Obsolete
157 TOCLIENT_SECTORMETA = 0x26, // Obsolete
161 [3...] v2s16 pos + sector metadata
164 TOCLIENT_INVENTORY = 0x27,
167 [2] serialized inventory
170 TOCLIENT_OBJECTDATA = 0x28, // Obsolete
175 u16 number of player positions
188 TOCLIENT_TIME_OF_DAY = 0x29,
192 Added in a later version:
196 // (oops, there is some gap here)
198 TOCLIENT_CHAT_MESSAGE = 0x30,
205 TOCLIENT_ACTIVE_OBJECT_REMOVE_ADD = 0x31,
208 u16 count of removed objects
209 for all removed objects {
212 u16 count of added objects
213 for all added objects {
216 u32 initialization data length
217 string initialization data
221 TOCLIENT_ACTIVE_OBJECT_MESSAGES = 0x32,
238 TOCLIENT_MOVE_PLAYER = 0x34,
241 v3f1000 player position
246 TOCLIENT_ACCESS_DENIED = 0x35,
253 TOCLIENT_PLAYERITEM = 0x36, // Obsolete
256 u16 count of player items
257 for all player items {
259 u16 length of serialized item
260 string serialized item
264 TOCLIENT_DEATHSCREEN = 0x37,
267 u8 bool set camera point target
268 v3f1000 camera point target (to point the death cause or whatever)
271 TOCLIENT_MEDIA = 0x38,
274 u16 total number of texture bunches
275 u16 index of this bunch
276 u32 number of files in this bunch
283 u16 length of remote media server url (if applicable)
287 TOCLIENT_TOOLDEF = 0x39,
290 u32 length of the next item
291 serialized ToolDefManager
294 TOCLIENT_NODEDEF = 0x3a,
297 u32 length of the next item
298 serialized NodeDefManager
301 TOCLIENT_CRAFTITEMDEF = 0x3b,
304 u32 length of the next item
305 serialized CraftiItemDefManager
308 TOCLIENT_ANNOUNCE_MEDIA = 0x3c,
316 u16 length of sha1_digest
321 TOCLIENT_ITEMDEF = 0x3d,
324 u32 length of next item
325 serialized ItemDefManager
328 TOCLIENT_PLAY_SOUND = 0x3f,
335 u8 type (0=local, 1=positional, 2=object)
336 s32[3] pos_nodes*10000
341 TOCLIENT_STOP_SOUND = 0x40,
347 TOCLIENT_PRIVILEGES = 0x41,
350 u16 number of privileges
356 TOCLIENT_INVENTORY_FORMSPEC = 0x42,
363 TOCLIENT_DETACHED_INVENTORY = 0x43,
368 [2] serialized inventory
371 TOCLIENT_SHOW_FORMSPEC = 0x44,
380 TOCLIENT_MOVEMENT = 0x45,
383 f1000 movement_acceleration_default
384 f1000 movement_acceleration_air
385 f1000 movement_acceleration_fast
386 f1000 movement_speed_walk
387 f1000 movement_speed_crouch
388 f1000 movement_speed_fast
389 f1000 movement_speed_climb
390 f1000 movement_speed_jump
391 f1000 movement_liquid_fluidity
392 f1000 movement_liquid_fluidity_smooth
393 f1000 movement_liquid_sink
394 f1000 movement_gravity
397 TOCLIENT_SPAWN_PARTICLE = 0x46,
405 u8 bool collisiondetection
410 TOCLIENT_ADD_PARTICLESPAWNER = 0x47,
425 u8 bool collisiondetection
431 TOCLIENT_DELETE_PARTICLESPAWNER = 0x48,
442 Sent first after connected.
444 [0] u16 TOSERVER_INIT
445 [2] u8 SER_FMT_VER_HIGHEST
446 [3] u8[20] player_name
447 [23] u8[28] password (new in some version)
448 [51] u16 minimum supported network protocol version (added sometime)
449 [53] u16 maximum supported network protocol version (added later than the previous one)
452 TOSERVER_INIT2 = 0x11,
454 Sent as an ACK for TOCLIENT_INIT.
455 After this, the server can send data.
457 [0] u16 TOSERVER_INIT2
460 TOSERVER_GETBLOCK=0x20, // Obsolete
461 TOSERVER_ADDNODE = 0x21, // Obsolete
462 TOSERVER_REMOVENODE = 0x22, // Obsolete
464 TOSERVER_PLAYERPOS = 0x23,
467 [2] v3s32 position*100
468 [2+12] v3s32 speed*100
469 [2+12+12] s32 pitch*100
470 [2+12+12+4] s32 yaw*100
471 [2+12+12+4+4] u32 keyPressed
474 TOSERVER_GOTBLOCKS = 0x24,
483 TOSERVER_DELETEDBLOCKS = 0x25,
492 TOSERVER_ADDNODE_FROM_INVENTORY = 0x26, // Obsolete
499 TOSERVER_CLICK_OBJECT = 0x27, // Obsolete
503 [2] u8 button (0=left, 1=right)
509 TOSERVER_GROUND_ACTION = 0x28, // Obsolete
514 [3] v3s16 nodepos_undersurface
515 [9] v3s16 nodepos_abovesurface
518 0: start digging (from undersurface)
519 1: place block (to abovesurface)
520 2: stop digging (all parameters ignored)
524 TOSERVER_RELEASE = 0x29, // Obsolete
526 // (oops, there is some gap here)
528 TOSERVER_SIGNTEXT = 0x30, // Old signs, obsolete
537 TOSERVER_INVENTORY_ACTION = 0x31,
539 See InventoryAction in inventory.h
542 TOSERVER_CHAT_MESSAGE = 0x32,
549 TOSERVER_SIGNNODETEXT = 0x33, // obsolete
557 TOSERVER_CLICK_ACTIVEOBJECT = 0x34, // Obsolete
561 [2] u8 button (0=left, 1=right)
566 TOSERVER_DAMAGE = 0x35,
572 TOSERVER_PASSWORD=0x36,
574 Sent to change password.
576 [0] u16 TOSERVER_PASSWORD
577 [2] u8[28] old password
578 [30] u8[28] new password
581 TOSERVER_PLAYERITEM=0x37,
583 Sent to change selected item.
585 [0] u16 TOSERVER_PLAYERITEM
589 TOSERVER_RESPAWN=0x38,
594 TOSERVER_INTERACT = 0x39,
599 [5] u32 length of the next item
600 [9] serialized PointedThing
602 0: start digging (from undersurface) or use
603 1: stop digging (all parameters ignored)
605 3: place block or item (to abovesurface)
608 (Obsoletes TOSERVER_GROUND_ACTION and TOSERVER_CLICK_ACTIVEOBJECT.)
611 TOSERVER_REMOVED_SOUNDS = 0x3a,
618 TOSERVER_NODEMETA_FIELDS = 0x3b,
623 u8[len] form name (reserved for future use)
632 TOSERVER_INVENTORY_FIELDS = 0x3c,
636 u8[len] form name (reserved for future use)
645 TOSERVER_REQUEST_MEDIA = 0x40,
648 u16 number of files requested
655 TOSERVER_RECEIVED_MEDIA = 0x41,