Bedriox/RakNet is a standalone RakNet transport library written in modern PHP for Bedriox and other PHP applications. It is developed and maintained by the Bedriox team with performance, reliability, security, and testability in mind.
Project status: Early development. IPv4 discovery, offline and connected-control negotiation, and a bounded connected transport for raw application byte payloads are implemented. Bedrock packet decoding is not. Do not use this package in production.
This repository owns UDP discovery, connection negotiation, reliable and ordered delivery, ACK/NACK processing, fragmentation, reassembly, retransmission, and transport lifecycle events. It deliberately contains no Minecraft packets, player state, world logic, or game behavior.
- 64-bit PHP
^8.4(PHP 8.4 or later within the PHP 8 major line) - PHP
socketsextension - Composer 2
- Windows x86-64 or Linux x86-64
composer install
composer checkThe package is not currently published on Packagist. Bedriox consumes the public repository at an exact reviewed commit.
The current scaffold provides a validated transport configuration object:
use Bedriox\RakNet\TransportConfig;
$config = new TransportConfig(port: 19132, maximumSessions: 512);Established sessions send a connected ping every five seconds and expire after 30 seconds without inbound activity. sessionPingIntervalMilliseconds and sessionIdleTimeoutMilliseconds on TransportConfig can be adjusted for a deployment's network conditions.
Run a non-blocking discovery responder from an existing event loop:
use Bedriox\RakNet\DiscoveryServer;
use Bedriox\RakNet\DiscoveryStatus;
use Bedriox\RakNet\TransportConfig;
$guid = 8675309;
$status = new DiscoveryStatus('application-owned bounded status');
$server = DiscoveryServer::bind(new TransportConfig(port: 19132), $guid, $status);
while (true) {
$server->poll();
// Perform other event-loop work here.
}The status payload is opaque to RakNet. Applications own its format and semantics and must encode it before constructing DiscoveryStatus. poll() handles RakNet protocol 11 offline and connected-control negotiation, routes ready endpoint traffic, advances retries, and flushes complete UDP datagrams. Applications must drain lifecycle events and only attach protocol state after SessionOpenedEvent.
- Architecture
- Codebase map
- Discovery contract
- Change safety
- Reliability model
- Development
- Usage
- Testing
- Security
- Compatibility
- Troubleshooting
See CONTRIBUTING.md before proposing a change and SECURITY.md for private vulnerability reporting guidance.
Original source code is licensed under the GNU General Public License v3.0 only. Required third-party legal notices are documented in THIRD_PARTY_NOTICES.md.
Bedriox is an independent project and is not affiliated with or endorsed by Mojang Studios or Microsoft. Minecraft is a trademark of Microsoft Corporation. The Bedriox name and marks are not granted by the GPL.