https://github.com/muqsit/simplepackethandler
A PocketMine-MP library/virion that provides a simple API to handle data packets per network session.
https://github.com/muqsit/simplepackethandler
Last synced: 9 months ago
JSON representation
A PocketMine-MP library/virion that provides a simple API to handle data packets per network session.
- Host: GitHub
- URL: https://github.com/muqsit/simplepackethandler
- Owner: Muqsit
- License: gpl-3.0
- Created: 2020-06-03T10:25:37.000Z (almost 6 years ago)
- Default Branch: pm5
- Last Pushed: 2025-02-16T23:28:05.000Z (over 1 year ago)
- Last Synced: 2025-09-01T02:36:00.374Z (9 months ago)
- Language: PHP
- Homepage: https://poggit.pmmp.io/ci/Muqsit/SimplePacketHandler
- Size: 51.8 KB
- Stars: 40
- Watchers: 3
- Forks: 13
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SimplePacketHandler
Put an end to the if-elseif instanceof hell.
## API Documentation
### Packet Monitor
Monitor data packets - use this if you aren't modifying the outcome of the event.
Packet monitor registers DataPacket(Receive/Send)Event(s) at `MONITOR` priority.
Use case:
- Dumping extra data from packets
- Debugging whether a packet was sent / received
```php
/** @var Plugin $plugin */
$packet_monitor = SimplePacketHandler::createMonitor($plugin);
$packet_monitor->monitorIncoming(function(LoginPacket $packet, NetworkSession $origin) : void{
$this->getLogger()->debug("Received LoginPacket from #" . spl_object_id($origin));
});
$packet_monitor->monitorIncoming(function(ServerSettingsResponsePacket $packet, NetworkSession $origin) : void{
$this->getLogger()->debug("Received server settings response from {$origin->getPlayer()->getName()}");
});
$packet_monitor->monitorOutgoing(function(SetActorDataPacket $packet, NetworkSession $target) : void{
$this->getLogger()->debug("Sent SetActorDataPacket to #" . spl_object_id($target));
});
```
The `LoginPacket` example above is the equivalent of:
```php
/**
* @param DataPacketReceiveEvent $event
* @priority MONITOR
*/
public function onDataPacketReceive(DataPacketReceiveEvent $event) : void{
$packet = $event->getPacket();
if($packet instanceof LoginPacket){
$origin = $event->getOrigin();
$this->getLogger()->debug("Received LoginPacket from #" . spl_object_id($origin));
}
}
```
The `SetActorDataPacket` example above is the equivalent of:
```php
/**
* @param DataPacketSendEvent $event
* @priority MONITOR
*/
public function onDataPacketSend(DataPacketSendEvent $event) : void{
foreach($event->getPackets() as $packet){
if($packet instanceof SetActorDataPacket){
foreach($event->getTargets() as $target){
$this->getLogger()->debug("Sent SetActorDataPacket to #" . spl_object_id($target));
}
}
}
}
```
### Packet Interceptor
Handle data packets - DataPacket(Receive/Send)Event(s) are registered at < `MONITOR` priority.
Use case:
- Blocking pocketmine from handling specific data packets
- Modifying data packets before pocketmine handles them
```php
/** @var Plugin $plugin */
$packet_interceptor = SimplePacketHandler::createInterceptor($plugin);
$packet_interceptor->interceptIncoming(function(AdventureSettingsPacket $packet, NetworkSession $origin) : bool{
if($packet->getFlag(AdventureSettingsPacket::FLYING)){
return false; // cancels the DataPacketReceiveEvent
}
return true; // do nothing
});
$packet_interceptor->interceptOutgoing(function(SetTimePacket $packet, NetworkSession $target) : bool{
$custom_player = CustomPlayerManager::get($target->getPlayer());
if($custom_player->getPTime() !== $packet->time){
$target->sendDataPacket(SetTimePacket::create($custom_player->getPTime()));
return false;
}
return true;
});
```
The `AdventureSettingsPacket` example above is the equivalent of:
```php
/**
* @param DataPacketReceiveEvent $event
* @priority NORMAL
*/
public function onDataPacketReceive(DataPacketReceiveEvent $event) : void{
$packet = $event->getPacket();
if($packet instanceof AdventureSettingsPacket){
$origin = $event->getOrigin();
if($packet->getFlag(AdventureSettingsPacket::FLYING)){
$event->cancel();
}
}
}
```
The `SetTimePacket` example above is the equivalent of:
```php
/**
* @param DataPacketSendEvent $event
* @priority NORMAL
*/
public function onDataPacketSend(DataPacketSendEvent $event) : void{
foreach($event->getPackets() as $packet){
if($packet instanceof SetTimePacket){
$targets = $event->getTargets();
$new_targets = $targets;
foreach($new_targets as $index => $target){
$custom_player = CustomPlayerManager::get($target->getPlayer());
if($custom_player->getPTime() !== $packet->time){
$target->sendDataPacket(SetTimePacket::create($custom_player->getPTime()));
unset($new_targets[$index]);
}
}
if(count($new_targets) !== count($targets)){
// Cancel the event, try sending the remaining targets the
// batch of packets again.
$event->cancel();
if(count($new_targets) > 0){
$new_target_players = [];
foreach($new_targets as $new_target){
$new_target_players[] = $new_target->getPlayer();
}
$this->getServer()->broadcastPackets($new_target_players, $event->getPackets());
}
break;
}
}
}
}
```