MayaTheShy/Starworld
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Add comprehensive entity logging and debug modes

Browse Source 
Co-authored-by: MayaTheShy <117858929+MayaTheShy@users.noreply.github.com>
This commit is contained in:
copilot-swe-agent[bot]
2025-11-17 00:12:32 +00:00
parent 48207fb4bc
commit 7b55e34cdd
1 changed files with 56 additions and 15 deletions
Download Patch File Download Diff File Expand all files Collapse all files

71
src/OverteClient.cpp
View File

@@ -108,6 +108,30 @@ static std::vector<uint8_t> qCompressLike(const std::vector<uint8_t>& input, int
} }
} // namespace } // namespace
// Debug logging configuration via environment variables
namespace DebugLog {
static bool debugEntityPackets = false;
static bool debugEntityLifecycle = false;
static bool debugNetworkPackets = false;
static void init() {
const char* envEntityPackets = std::getenv("STARWORLD_DEBUG_ENTITY_PACKETS");
const char* envEntityLifecycle = std::getenv("STARWORLD_DEBUG_ENTITY_LIFECYCLE");
const char* envNetworkPackets = std::getenv("STARWORLD_DEBUG_NETWORK");
debugEntityPackets = (envEntityPackets && (std::string(envEntityPackets) == "1" || std::string(envEntityPackets) == "true"));
debugEntityLifecycle = (envEntityLifecycle && (std::string(envEntityLifecycle) == "1" || std::string(envEntityLifecycle) == "true"));
debugNetworkPackets = (envNetworkPackets && (std::string(envNetworkPackets) == "1" || std::string(envNetworkPackets) == "true"));
if (debugEntityPackets || debugEntityLifecycle || debugNetworkPackets) {
std::cout << "[DebugLog] Debug logging enabled:" << std::endl;
if (debugEntityPackets) std::cout << " - Entity packets (STARWORLD_DEBUG_ENTITY_PACKETS=1)" << std::endl;
if (debugEntityLifecycle) std::cout << " - Entity lifecycle (STARWORLD_DEBUG_ENTITY_LIFECYCLE=1)" << std::endl;
if (debugNetworkPackets) std::cout << " - Network packets (STARWORLD_DEBUG_NETWORK=1)" << std::endl;
}
}
}
// Generate a simple UUID-like string for session identification // Generate a simple UUID-like string for session identification
static std::string generateUUID() { static std::string generateUUID() {
std::random_device rd; std::random_device rd;
@@ -125,6 +149,8 @@ static std::string generateUUID() {
OverteClient::OverteClient(std::string domainUrl) OverteClient::OverteClient(std::string domainUrl)
: m_domainUrl(std::move(domainUrl)) { : m_domainUrl(std::move(domainUrl)) {
// Initialize debug logging
DebugLog::init();
} }
OverteClient::~OverteClient() { OverteClient::~OverteClient() {
@@ -607,12 +633,14 @@ void OverteClient::parseEntityPacket(const char* data, size_t len) {
if (len < 1) return; if (len < 1) return;
// Debug: dump first bytes of packet // Debug: dump first bytes of packet if debug mode enabled
std::cout << "[OverteClient] parseEntityPacket: " << len << " bytes, first 32: "; if (DebugLog::debugEntityPackets) {
for (size_t i = 0; i < std::min(len, size_t(32)); i++) { std::cout << "[OverteClient] parseEntityPacket: " << len << " bytes, first 32: ";
printf("%02x ", (unsigned char)data[i]); for (size_t i = 0; i < std::min(len, size_t(32)); i++) {
printf("%02x ", (unsigned char)data[i]);
}
std::cout << std::endl;
} }
std::cout << std::endl;
unsigned char packetType = static_cast<unsigned char>(data[0]); unsigned char packetType = static_cast<unsigned char>(data[0]);
@@ -729,17 +757,20 @@ void OverteClient::parseEntityPacket(const char* data, size_t len) {
m_updateQueue.push_back(entityId); m_updateQueue.push_back(entityId);
std::cout << "[OverteClient] Entity added: " << name << " (id=" << entityId << ")" << std::endl; std::cout << "[OverteClient] Entity added: " << name << " (id=" << entityId << ")" << std::endl;
std::cout << " Type: " << static_cast<int>(entityType) << std::endl; if (DebugLog::debugEntityLifecycle) {
std::cout << " Position: (" << position.x << ", " << position.y << ", " << position.z << ")" << std::endl; std::cout << " Type: " << static_cast<int>(entityType) << std::endl;
std::cout << " Rotation: (" << rotation.x << ", " << rotation.y << ", " << rotation.z << ", " << rotation.w << ")" << std::endl; std::cout << " Position: (" << position.x << ", " << position.y << ", " << position.z << ")" << std::endl;
std::cout << " Dimensions: (" << dimensions.x << ", " << dimensions.y << ", " << dimensions.z << ")" << std::endl; std::cout << " Rotation: (" << rotation.x << ", " << rotation.y << ", " << rotation.z << ", " << rotation.w << ")" << std::endl;
std::cout << " Color: RGB(" << color.r << ", " << color.g << ", " << color.b << ")" << std::endl; std::cout << " Dimensions: (" << dimensions.x << ", " << dimensions.y << ", " << dimensions.z << ")" << std::endl;
if (!modelUrl.empty()) { std::cout << " Color: RGB(" << color.r << ", " << color.g << ", " << color.b << ")" << std::endl;
std::cout << " Model: " << modelUrl << std::endl; if (!modelUrl.empty()) {
} std::cout << " Model: " << modelUrl << std::endl;
if (!textureUrl.empty()) { }
std::cout << " Texture: " << textureUrl << std::endl; if (!textureUrl.empty()) {
std::cout << " Texture: " << textureUrl << std::endl;
}
} }
std::cout << "[OverteClient/Lifecycle] Total entities: " << m_entities.size() << ", Update queue: " << m_updateQueue.size() << std::endl;
break; break;
} }
@@ -1678,6 +1709,16 @@ void OverteClient::sendEntityQuery() {
std::cout << "[OverteClient] Sent EntityQuery to " << targetName std::cout << "[OverteClient] Sent EntityQuery to " << targetName
<< " (" << addrStr << ":" << ntohs(reinterpret_cast<const sockaddr_in*>(targetAddr)->sin_port) << " (" << addrStr << ":" << ntohs(reinterpret_cast<const sockaddr_in*>(targetAddr)->sin_port)
<< ", " << s << " bytes, seq=" << (m_sequenceNumber-1) << ")" << std::endl; << ", " << s << " bytes, seq=" << (m_sequenceNumber-1) << ")" << std::endl;
if (DebugLog::debugEntityPackets) {
std::cout << "[EntityQuery Details]" << std::endl;
std::cout << " Connection ID: " << connectionID << std::endl;
std::cout << " Num frustums: 0 (requesting all entities)" << std::endl;
std::cout << " Max PPS: 3000" << std::endl;
std::cout << " Octree scale: 1.0" << std::endl;
std::cout << " Flags: 0x1 (WantInitialCompletion)" << std::endl;
std::cout << " Payload size: " << payload.size() << " bytes" << std::endl;
}
} else { } else {
std::cerr << "[OverteClient] Failed to send EntityQuery: " << strerror(errno) << std::endl; std::cerr << "[OverteClient] Failed to send EntityQuery: " << strerror(errno) << std::endl;
} }