Preprocessor Directives

MafiaNet provides numerous preprocessor directives to customize builds for different platforms, features, and optimization levels.

Configuration File

Primary configuration is in RakNetDefinesOverrides.h. Create this file to override defaults from RakNetDefines.h.

// RakNetDefinesOverrides.h
#ifndef RAKNET_DEFINES_OVERRIDES_H
#define RAKNET_DEFINES_OVERRIDES_H

// Your custom defines here
#define RAKNET_SUPPORT_IPV6 1
#define USE_SLIDING_WINDOW_CONGESTION_CONTROL 1

#endif

Core Feature Toggles

Network Features:

// IPv6 support (default: 0)
#define RAKNET_SUPPORT_IPV6 1

// Secure connections with encryption
#define _RAKNET_SECURE_CONNECTIONS 1

// Enable statistics tracking
#define _RAKNET_STAT_COLLECTION 1

Component Toggles:

// File operations (FileListTransfer, etc.)
#define _RAKNET_SUPPORT_FileOperations 1

// TCP wrapper support
#define _RAKNET_SUPPORT_PacketizedTCP 1

// Thread support
#define _RAKNET_SUPPORT_THREADS 1

Performance Options

// Congestion control algorithm
#define USE_SLIDING_WINDOW_CONGESTION_CONTROL 1

// Maximum MTU size (default: 1492)
#define MAXIMUM_MTU_SIZE 1492

// Packet pool sizes
#define RAKNET_MESSAGE_HANDLER_LIST_SIZE 32

// Send buffer size
#define RAKNET_SEND_BUFFER_SIZE 8192

Debug Options

// Enable memory tracking
#define RAKNET_MEMORY_TRACKING 1

// Verbose debug output
#define _DEBUG 1

// Assert on errors
#define _RAKNET_DEBUG_ASSERT 1

// Log packet details
#define _RAKNET_PACKET_LOGGER 1

Platform-Specific

// Windows-specific
#ifdef _WIN32
#define RAKNET_WINDOWS 1
#endif

// Unix/Linux
#ifdef __linux__
#define RAKNET_LINUX 1
#endif

// macOS
#ifdef __APPLE__
#define RAKNET_APPLE 1
#endif

CMake Options

CMake build options (passed via -D):

  • MAFIANET_BUILD_SHARED - Build shared library

  • MAFIANET_BUILD_STATIC - Build static library

  • MAFIANET_BUILD_SAMPLES - Build sample applications

  • MAFIANET_BUILD_TESTS - Build test suite

See Also