// ProtocolRecognizer.h
// Interfaces to the cProtocolRecognizer class representing the meta-protocol that recognizes possibly multiple
// protocol versions and redirects everything to them
#pragma once
#include "Protocol.h"
#include "../ByteBuffer.h"
// Adjust these if a new protocol is added or an old one is removed:
#define MCS_CLIENT_VERSIONS "1.2.4, 1.2.5, 1.3.1, 1.3.2, 1.4.2, 1.4.4, 1.4.5, 1.4.6, 1.4.7, 1.5, 1.5.1, 1.5.2, 1.6.1, 1.6.2, 1.6.3, 1.6.4, 1.7.2, 1.7.4, 1.7.5, 1.7.6, 1.7.7, 1.7.8, 1.7.9"
#define MCS_PROTOCOL_VERSIONS "29, 39, 47, 49, 51, 60, 61, 73, 74, 77, 78, 4, 5"
class cProtocolRecognizer :
public cProtocol
{
typedef cProtocol super;
public:
enum
{
PROTO_VERSION_1_2_5 = 29,
PROTO_VERSION_1_3_2 = 39,
PROTO_VERSION_1_4_2 = 47,
PROTO_VERSION_1_4_4 = 49,
PROTO_VERSION_1_4_6 = 51,
PROTO_VERSION_1_5_0 = 60,
PROTO_VERSION_1_5_2 = 61,
PROTO_VERSION_1_6_1 = 73,
PROTO_VERSION_1_6_2 = 74,
PROTO_VERSION_1_6_3 = 77,
PROTO_VERSION_1_6_4 = 78,
PROTO_VERSION_NEXT,
PROTO_VERSION_LATEST = PROTO_VERSION_NEXT - 1, ///< Automatically assigned to the last protocol version, this serves as the default for PrimaryServerVersion
// These will be kept "under" the next / latest, because the next and latest are only needed for previous protocols
PROTO_VERSION_1_7_2 = 4,
PROTO_VERSION_1_7_6 = 5,
} ;
cProtocolRecognizer(cClientHandle * a_Client);
virtual ~cProtocolRecognizer();
/// Translates protocol version number into protocol version text: 49 -> "1.4.4"
static AString GetVersionTextFromInt(int a_ProtocolVersion);
/// Called when client sends some data:
virtual void DataReceived(const char * a_Data, size_t a_Size) /*override*/;
/// Sending stuff to clients (alphabetically sorted):
virtual void SendAttachEntity (const cEntity & a_Entity, const cEntity * a_Vehicle) /*override*/;
virtual void SendBlockAction (int a_BlockX, int a_BlockY, int a_BlockZ, char a_Byte1, char a_Byte2, BLOCKTYPE a_BlockType) /*override*/;
virtual void SendBlockBreakAnim (int a_EntityID, int a_BlockX, int a_BlockY, int a_BlockZ, char a_Stage) /*override*/;
virtual void SendBlockChange (int a_BlockX, int a_BlockY, int a_BlockZ, BLOCKTYPE a_BlockType, NIBBLETYPE a_BlockMeta) /*override*/;
virtual void SendBlockChanges (int a_ChunkX, int a_ChunkZ, const sSetBlockVector & a_Changes) /*override*/;
virtual void SendChat (const AString & a_Message) /*override*/;
virtual void SendChat (const cCompositeChat & a_Message) /*override*/;
virtual void SendChunkData (int a_ChunkX, int a_ChunkZ, cChunkDataSerializer & a_Serializer) /*override*/;
virtual void SendCollectEntity (const cEntity & a_Entity, const cPlayer & a_Player) /*override*/;
virtual void SendDestroyEntity (const cEntity & a_Entity) /*override*/;
virtual void SendDisconnect (const AString & a_Reason) /*override*/;
virtual void SendEditSign (int a_BlockX, int a_BlockY, int a_BlockZ) /*override*/; ///< Request the client to open up the sign editor for the sign (1.6+)
virtual void SendEntityEffect (const cEntity & a_Entity, int a_EffectID, int a_Amplifier, short a_Duration) /*override*/;
virtual void SendEntityEquipment (const cEntity & a_Entity, short a_SlotNum, const cItem & a_Item) /*override*/;
virtual void SendEntityHeadLook (const cEntity & a_Entity) /*override*/;
virtual void SendEntityLook (const cEntity & a_Entity) /*override*/;
virtual void SendEntityMetadata (const cEntity & a_Entity) /*override*/;
virtual void SendEntityProperties (const cEntity & a_Entity) /*override*/;
virtual void SendEntityRelMove (const cEntity & a_Entity, char a_RelX, char a_RelY, char a_RelZ) /*override*/;
virtual void SendEntityRelMoveLook (const cEntity & a_Entity, char a_RelX, char a_RelY, char a_RelZ) /*override*/;
virtual void SendEntityStatus (const cEntity & a_Entity, char a_Status) /*override*/;
virtual void SendEntityVelocity (const cEntity & a_Entity) /*override*/;
virtual void SendExplosion (double a_BlockX, double a_BlockY, double a_BlockZ, float a_Radius, const cVector3iArray & a_BlocksAffected, const Vector3d & a_PlayerMotion) /*override*/;
virtual void SendGameMode (eGameMode a_GameMode) /*override*/;
virtual void SendHealth (void) /*override*/;
virtual void SendInventorySlot (char a_WindowID, short a_SlotNum, const cItem & a_Item) /*override*/;
virtual void SendKeepAlive (int a_PingID) /*override*/;
virtual void SendLogin (const cPlayer & a_Player, const cWorld & a_World) /*override*/;
virtual void SendLoginSuccess (void) /*override*/;
virtual void SendMapColumn (int a_ID, int a_X, int a_Y, const Byte * a_Colors, unsigned int a_Length) /*override*/;
virtual void SendMapDecorators (int a_ID, const cMapDecoratorList & a_Decorators) /*override*/;
virtual void SendMapInfo (int a_ID, unsigned int a_Scale) /*override*/;
virtual void SendParticleEffect (const AString & a_ParticleName, float a_SrcX, float a_SrcY, float a_SrcZ, float a_OffsetX, float a_OffsetY, float a_OffsetZ, float a_ParticleData, int a_ParticleAmmount) /*override*/;
virtual void SendPaintingSpawn (const cPainting & a_Painting) /*override*/;
virtual void SendPickupSpawn (const cPickup & a_Pickup) /*override*/;
virtual void SendPlayerAbilities (void) /*override*/;
virtual void SendEntityAnimation (const cEntity & a_Entity, char a_Animation) /*override*/;
virtual void SendPlayerListItem (const cPlayer & a_Player, bool a_IsOnline) /*override*/;
virtual void SendPlayerMaxSpeed (void) /*override*/;
virtual void SendPlayerMoveLook (void) /*override*/;
virtual void SendPlayerPosition (void) /*override*/;
virtual void SendPlayerSpawn (const cPlayer & a_Player) /*override*/;
virtual void SendPluginMessage (const AString & a_Channel, const AString & a_Message) /*override*/;
virtual void SendRemoveEntityEffect (const cEntity & a_Entity, int a_EffectID) /*override*/;
virtual void SendRespawn (eDimension a_Dimension, bool a_ShouldIgnoreDimensionChecks) /*override*/;
virtual void SendExperience (void) /*override*/;
virtual void SendExperienceOrb (const cExpOrb & a_ExpOrb) /*override*/;
virtual void SendScoreboardObjective (const AString & a_Name, const AString & a_DisplayName, Byte a_Mode) /*override*/;
virtual void SendScoreUpdate (const AString & a_Objective, const AString & a_Player, cObjective::Score a_Score, Byte a_Mode) /*override*/;
virtual void SendDisplayObjective (const AString & a_Objective, cScoreboard::eDisplaySlot a_Display) /*override*/;
virtual void SendSoundEffect (const AString & a_SoundName, double a_X, double a_Y, double a_Z, float a_Volume, float a_Pitch) /*override*/;
virtual void SendSoundParticleEffect (int a_EffectID, int a_SrcX, int a_SrcY, int a_SrcZ, int a_Data) /*override*/;
virtual void SendSpawnFallingBlock (const cFallingBlock & a_FallingBlock) /*override*/;
virtual void SendSpawnMob (const cMonster & a_Mob) /*override*/;
virtual void SendSpawnObject (const cEntity & a_Entity, char a_ObjectType, int a_ObjectData, Byte a_Yaw, Byte a_Pitch) /*override*/;
virtual void SendSpawnVehicle (const cEntity & a_Vehicle, char a_VehicleType, char a_VehicleSubType) /*override*/;
virtual void SendStatistics (const cStatManager & a_Manager) /*override*/;
virtual void SendTabCompletionResults(const AStringVector & a_Results) /*override*/;
virtual void SendTeleportEntity (const cEntity & a_Entity) /*override*/;
virtual void SendThunderbolt (int a_BlockX, int a_BlockY, int a_BlockZ) /*override*/;
virtual void SendTimeUpdate (Int64 a_WorldAge, Int64 a_TimeOfDay, bool a_DoDaylightCycle) /*override*/;
virtual void SendUnloadChunk (int a_ChunkX, int a_ChunkZ) /*override*/;
virtual void SendUpdateBlockEntity (cBlockEntity & a_BlockEntity) /*override*/;
virtual void SendUpdateSign (int a_BlockX, int a_BlockY, int a_BlockZ, const AString & a_Line1, const AString & a_Line2, const AString & a_Line3, const AString & a_Line4) /*override*/;
virtual void SendUseBed (const cEntity & a_Entity, int a_BlockX, int a_BlockY, int a_BlockZ) /*override*/;
virtual void SendWeather (eWeather a_Weather) /*override*/;
virtual void SendWholeInventory (const cWindow & a_Window) /*override*/;
virtual void SendWindowClose (const cWindow & a_Window) /*override*/;
virtual void SendWindowOpen (const cWindow & a_Window) /*override*/;
virtual void SendWindowProperty (const cWindow & a_Window, int a_Property, int a_Value) /*override*/;
virtual AString GetAuthServerID(void) /*override*/;
virtual void SendData(const char * a_Data, size_t a_Size) /*override*/;
protected:
cProtocol * m_Protocol; ///< The recognized protocol
cByteBuffer m_Buffer; ///< Buffer for the incoming data until we recognize the protocol
/// Tries to recognize protocol based on m_Buffer contents; returns true if recognized
bool TryRecognizeProtocol(void);
/** Tries to recognize a protocol in the length-less family, based on m_Buffer; returns true if recognized.
Handles protocols before release 1.7, that didn't include packet lengths, and started with a 0x02 handshake packet
Note that length-less server ping is handled directly in TryRecognizeProtocol(), this function is called only
when the 0x02 Handshake packet has been received
*/
bool TryRecognizeLengthlessProtocol(void);
/** Tries to recognize a protocol in the leghted family (1.7+), based on m_Buffer; returns true if recognized.
The packet length and type have already been read, type is 0
The number of bytes remaining in the packet is passed as a_PacketLengthRemaining
**/
bool TryRecognizeLengthedProtocol(UInt32 a_PacketLengthRemaining);
/** Called when the recognizer gets a length-less protocol's server ping packet
Responds with server stats and destroys the client.
*/
void SendLengthlessServerPing(void);
} ;