mirror of
https://github.com/DarkflameUniverse/DarkflameServer.git
synced 2026-10-03 19:33:43 +00:00
Every game message still written or read by hand is now a NetGameMsg with Serialize and Deserialize, in per-domain files: - MovementMessages: teleport, platforms (resync and its request), orient to angle, node rotation lock, gravity scale, jetpack mode, control scheme, respawn checkpoint, rails (set/start, ready, cancel, arrived), mount inventory ID, dismount complete, possession ack, ghost reference override and position, camera cycling (eCameraTargetCyclingMode moves here). - ZoneMessages: player loaded (the old PLAYER_LOADED case), ready for updates, player ready, restore to post load stats, server done loading, invalid zone transfer list, zone summary display/dismissed, level processing complete, object world state, and the localized announcement WorldMigration wrote by hand. - PlayerMessages: chat mode, GM level, LEGO score, currency, reputation, GM invis, pickup currency, zone and player statistics, chat commands, bug reports, verify ack. - ObjectMessages: fire event client/server side, notify client (zone) object, notify object, script network vars, failed preconditions, terminate interaction, set name, request use, request server object info. - QuickBuildMessages: notify state, enable, cancel. - ActivityMessages gains match response/update/request, leaderboard request and data, shooting gallery score/rotation/fire, activity state change. - MissionMessages gains MissionDialogueCancelled (a no-op, as before). The wire structs left in GameMessages.h move to their domains (tooltip and emote to Effects, loot and item use to Inventory, model build to Building, behavior sound to Property, skill sets to Skill) and gain the missing direction. The dismount logic moves to PossessorComponent::OnDismountComplete. Every inbound message is registered in the GameMessageHandler map; the switch is gone, and GameMessages.cpp only holds the GameMsg/NetGameMsg base code. Call sites build the structs (NotifyClientObject, TerminateInteraction, Teleport, PlatformResync, FireEventClientSide, NotifyObject and NotifyClientZoneObject get convenience constructors like PlayFXEffect). Dead senders are dropped: SendSetShootingGalleryParams (no callers, field order was a guess), SendTeamPickupItem (the struct already existed), SendRequestActivitySummaryLeaderboardData (the struct covers it). Verified with RemainingMessagesTests: every old Send* function is frozen verbatim in Legacy/RemainingMessagesLegacy.h and compared byte for byte (same bits, destination and broadcast flag) over grids of inputs; every old Handle* read sequence is frozen as a Read* oracle and compared with the struct's Deserialize; round trips, truncation and a golden packet. PlayerLoaded (0x00dc36f0), SetGMLevel (0x00dd6230), MissionDialogueCancelled (0x00d9cc10) and LocalizedAnnouncementServerToSingleClient (0x00f23c50) were checked against the client. Behaviour notes: an inbound message that fails to deserialize is dropped, so ParseChatMessage over MAX_MESSAGE_LENGTH is dropped instead of truncated, and PLAYER_LOADED / READY_FOR_UPDATES / MISSION_DIALOGUE_CANCELLED now read their (unused) client fields. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
209 lines
7.1 KiB
C++
209 lines
7.1 KiB
C++
#ifndef __BITSTREAMUTILS__H__
|
|
#define __BITSTREAMUTILS__H__
|
|
|
|
#include "GeneralUtils.h"
|
|
#include "BitStream.h"
|
|
#include "MessageIdentifiers.h"
|
|
#include "ServiceType.h"
|
|
#include <string>
|
|
#include <algorithm>
|
|
#include <type_traits>
|
|
|
|
#define VALIDATE_READ(x) do { if (!x) return false; } while (0)
|
|
|
|
struct LUString {
|
|
std::string string;
|
|
uint32_t size;
|
|
|
|
LUString(uint32_t size = 33) {
|
|
this->size = size;
|
|
};
|
|
LUString(std::string string, uint32_t size = 33) {
|
|
this->string = string;
|
|
this->size = size;
|
|
};
|
|
std::u16string GetAsU16String() const {
|
|
return GeneralUtils::ASCIIToUTF16(this->string);
|
|
};
|
|
};
|
|
|
|
struct LUWString {
|
|
std::u16string string;
|
|
uint32_t size;
|
|
|
|
LUWString(uint32_t size = 33) {
|
|
this->size = size;
|
|
};
|
|
LUWString(std::u16string string, uint32_t size = 33) {
|
|
this->string = string;
|
|
this->size = size;
|
|
};
|
|
LUWString(std::string string, uint32_t size = 33) {
|
|
this->string = GeneralUtils::ASCIIToUTF16(string);
|
|
this->size = size;
|
|
};
|
|
std::string GetAsString() const {
|
|
return GeneralUtils::UTF16ToWTF8(this->string);
|
|
};
|
|
};
|
|
|
|
struct LUBitStream {
|
|
ServiceType connectionType = ServiceType::UNKNOWN;
|
|
uint32_t internalPacketID = 0xFFFFFFFF;
|
|
|
|
LUBitStream() = default;
|
|
virtual ~LUBitStream() = default;
|
|
|
|
template <typename T>
|
|
LUBitStream(ServiceType connectionType, T internalPacketID) {
|
|
this->connectionType = connectionType;
|
|
this->internalPacketID = static_cast<uint32_t>(internalPacketID);
|
|
}
|
|
|
|
void WriteHeader(RakNet::BitStream& bitStream) const;
|
|
bool ReadHeader(RakNet::BitStream& bitStream);
|
|
void Send(const SystemAddress& sysAddr) const;
|
|
void Broadcast() const { Send(UNASSIGNED_SYSTEM_ADDRESS); };
|
|
|
|
// Writes the complete packet (WriteHeader() then Serialize()) into bitStream.
|
|
// This is exactly what Send puts on the wire; tests use it to compare bytes without a server.
|
|
void WritePacket(RakNet::BitStream& bitStream) const;
|
|
|
|
virtual void Serialize(RakNet::BitStream& bitStream) const {}
|
|
virtual bool Deserialize(RakNet::BitStream& bitStream) { return true; }
|
|
virtual void Handle() {};
|
|
};
|
|
|
|
|
|
#define BITSTREAMUTILS_HAS_WRITEHEADER
|
|
namespace BitStreamUtils {
|
|
template<typename T>
|
|
void WriteHeader(RakNet::BitStream& bitStream, ServiceType connectionType, T internalPacketID) {
|
|
bitStream.Write<MessageID>(ID_USER_PACKET_ENUM);
|
|
bitStream.Write<ServiceType>(connectionType);
|
|
bitStream.Write(static_cast<uint32_t>(internalPacketID));
|
|
bitStream.Write<uint8_t>(0);
|
|
}
|
|
|
|
/**
|
|
* Writes an optional ("default flag") field: one bit saying whether value differs from defaultValue, then
|
|
* the value itself only if it does. This is how the client encodes game message parameters that have a default.
|
|
*/
|
|
template<typename T>
|
|
void WriteOptional(RakNet::BitStream& bitStream, const T& value, const T& defaultValue) {
|
|
const bool isNotDefault = value != defaultValue;
|
|
bitStream.Write(isNotDefault);
|
|
if (isNotDefault) bitStream.Write(value);
|
|
}
|
|
|
|
/**
|
|
* Reads a field written by WriteOptional. If the flag bit is not set, value is set to defaultValue.
|
|
*/
|
|
template<typename T>
|
|
bool ReadOptional(RakNet::BitStream& bitStream, T& value, const T& defaultValue) {
|
|
bool isNotDefault = false;
|
|
if (!bitStream.Read(isNotDefault)) return false;
|
|
if (!isNotDefault) {
|
|
value = defaultValue;
|
|
return true;
|
|
}
|
|
return bitStream.Read(value);
|
|
}
|
|
|
|
/**
|
|
* Writes a length prefixed string: a LenT holding the number of characters, followed by the raw
|
|
* characters (1 byte each for std::string, 2 bytes each for std::u16string) with no null terminator.
|
|
* This is the layout the client uses for std::string / std::wstring game message fields.
|
|
*/
|
|
template<typename LenT = uint32_t, typename StringT>
|
|
void WriteLengthPrefixed(RakNet::BitStream& bitStream, const StringT& value) {
|
|
bitStream.Write<LenT>(static_cast<LenT>(value.size()));
|
|
bitStream.WriteBits(reinterpret_cast<const unsigned char*>(value.data()), BYTES_TO_BITS(value.size() * sizeof(typename StringT::value_type)));
|
|
}
|
|
|
|
/**
|
|
* Reads a string written by WriteLengthPrefixed. Fails (returns false) if the stream runs out of data or
|
|
* if the length is negative or larger than maxLength characters.
|
|
*/
|
|
/**
|
|
* Writes name-value (LDF) text the way the client reads it: a u32 character count, the characters, and a null
|
|
* terminator (not counted) when the text isn't empty.
|
|
*/
|
|
inline void WriteNameValueText(RakNet::BitStream& bitStream, const std::u16string& text) {
|
|
WriteLengthPrefixed<uint32_t>(bitStream, text);
|
|
if (!text.empty()) bitStream.Write<uint16_t>(0);
|
|
}
|
|
|
|
/**
|
|
* Reads text written by WriteNameValueText (the null terminator is consumed and not kept).
|
|
*/
|
|
inline bool ReadNameValueText(RakNet::BitStream& bitStream, std::u16string& text, const uint32_t maxLength = 0x500000 /* MAX_MESSAGE_LENGTH */);
|
|
|
|
template<typename LenT = uint32_t, typename StringT>
|
|
bool ReadLengthPrefixed(RakNet::BitStream& bitStream, StringT& value, const uint32_t maxLength = 0x500000 /* MAX_MESSAGE_LENGTH */) {
|
|
LenT length{};
|
|
if (!bitStream.Read(length)) return false;
|
|
if constexpr (std::is_signed_v<LenT>) {
|
|
if (length < 0) return false;
|
|
}
|
|
if (static_cast<uint64_t>(length) > maxLength) return false;
|
|
value.resize(length);
|
|
if (length == 0) return true;
|
|
return bitStream.ReadBits(reinterpret_cast<unsigned char*>(value.data()), BYTES_TO_BITS(value.size() * sizeof(typename StringT::value_type)), true);
|
|
}
|
|
|
|
inline bool ReadNameValueText(RakNet::BitStream& bitStream, std::u16string& text, const uint32_t maxLength) {
|
|
if (!ReadLengthPrefixed<uint32_t>(bitStream, text, maxLength)) return false;
|
|
uint16_t terminator{};
|
|
return text.empty() || bitStream.Read(terminator);
|
|
}
|
|
}
|
|
|
|
namespace RakNet {
|
|
#ifndef __BITSTREAM_NATIVE_END
|
|
#error No definition for big endian reading of LUString
|
|
#endif
|
|
|
|
template <>
|
|
inline bool RakNet::BitStream::Read<LUString>(LUString& value) {
|
|
value.string.resize(value.size);
|
|
bool res = ReadBits(reinterpret_cast<unsigned char*>(value.string.data()), BYTES_TO_BITS(value.string.size()), true);
|
|
if (!res) return false;
|
|
value.string.erase(std::find(value.string.begin(), value.string.end(), '\0'), value.string.end());
|
|
return res;
|
|
}
|
|
|
|
template <>
|
|
inline bool RakNet::BitStream::Read<LUWString>(LUWString& value) {
|
|
value.string.resize(value.size);
|
|
bool res = ReadBits(reinterpret_cast<unsigned char*>(value.string.data()), BYTES_TO_BITS(value.string.size()) * sizeof(std::u16string::value_type), true);
|
|
if (!res) return false;
|
|
value.string.erase(std::find(value.string.begin(), value.string.end(), u'\0'), value.string.end());
|
|
return res;
|
|
}
|
|
|
|
template <>
|
|
inline void RakNet::BitStream::Write<std::string>(std::string value) {
|
|
this->WriteBits(reinterpret_cast<const unsigned char*>(value.data()), BYTES_TO_BITS(value.size()));
|
|
}
|
|
|
|
template <>
|
|
inline void RakNet::BitStream::Write<std::u16string>(std::u16string value) {
|
|
this->WriteBits(reinterpret_cast<const unsigned char*>(value.data()), BYTES_TO_BITS(value.size()) * sizeof(std::u16string::value_type));
|
|
}
|
|
|
|
template <>
|
|
inline void RakNet::BitStream::Write<LUString>(LUString value) {
|
|
value.string.resize(value.size);
|
|
this->Write(value.string);
|
|
}
|
|
|
|
template <>
|
|
inline void RakNet::BitStream::Write<LUWString>(LUWString value) {
|
|
value.string.resize(value.size);
|
|
this->Write(value.string);
|
|
}
|
|
};
|
|
|
|
#endif //!__BITSTREAMUTILS__H__
|