SystemAddress¶

SystemAddress uniquely identifies a network endpoint by IP address and port.

Structure¶

struct SystemAddress {
    // Binary IP address (network byte order)
    union {
        unsigned char addr4[4];    // IPv4
        unsigned char addr6[16];   // IPv6
    };
    unsigned short port;           // Port (host byte order)
    // ...
};

Creating SystemAddress¶

From String¶

MafiaNet::SystemAddress addr;
addr.FromString("192.168.1.100:60000");

// Or separately
addr.FromString("192.168.1.100");
addr.SetPortHostOrder(60000);

From IP and Port¶

MafiaNet::SystemAddress addr("192.168.1.100", 60000);

// Or using SetBinaryAddress
MafiaNet::SystemAddress addr;
addr.SetBinaryAddress("192.168.1.100");
addr.SetPortHostOrder(60000);

Special Values¶

// Unassigned (used for broadcast)
MafiaNet::UNASSIGNED_SYSTEM_ADDRESS

// Localhost
MafiaNet::SystemAddress localhost("127.0.0.1", 60000);

Converting to String¶

MafiaNet::SystemAddress addr;

// Full address with port
const char* str = addr.ToString(true);   // "192.168.1.100:60000"

// IP only
const char* ip = addr.ToString(false);   // "192.168.1.100"

// With buffer (thread-safe)
char buffer[64];
addr.ToString(true, buffer);

Getting Components¶

// Get port
unsigned short port = addr.GetPort();

// Get IP as string
const char* ip = addr.ToString(false);

// Check if valid
if (addr != MafiaNet::UNASSIGNED_SYSTEM_ADDRESS) {
    // Address is valid
}

Comparison¶

MafiaNet::SystemAddress addr1("192.168.1.100", 60000);
MafiaNet::SystemAddress addr2("192.168.1.100", 60000);

if (addr1 == addr2) {
    // Same address
}

if (addr1 != MafiaNet::UNASSIGNED_SYSTEM_ADDRESS) {
    // Valid address
}

SystemAddress vs RakNetGUID¶

MafiaNet provides two ways to identify peers:

SystemAddress:

IP + Port combination
Changes if client reconnects from different IP/port
Used for network operations

RakNetGUID:

Unique 64-bit identifier generated at startup
Survives reconnections (if you track it)
Better for player identification

// Get GUID from SystemAddress
MafiaNet::RakNetGUID guid = peer->GetGuidFromSystemAddress(addr);

// Get SystemAddress from GUID
MafiaNet::SystemAddress addr = peer->GetSystemAddressFromGuid(guid);

Using with Send¶

You can use either SystemAddress or GUID with Send:

// Using SystemAddress
peer->Send(&bs, HIGH_PRIORITY, RELIABLE, 0, systemAddress, false);

// Using GUID (AddressOrGUID accepts both)
peer->Send(&bs, HIGH_PRIORITY, RELIABLE, 0, guid, false);

Getting Your Own Address¶

// Get your external address (as seen by a specific peer)
MafiaNet::SystemAddress myAddr = peer->GetExternalID(remoteAddr);

// Get your local/internal address
MafiaNet::SystemAddress localAddr = peer->GetInternalID();

IPv6¶

For IPv6 addresses:

MafiaNet::SystemAddress addr6;
addr6.FromString("fe80::7c:31f7:fec4:27de%14");
addr6.SetPortHostOrder(60000);

// Check if IPv6
if (addr6.IsIPV6()) {
    // Handle IPv6
}