This plugin was created by the @PocketMine Team, mainly @shoghicp. This plugin has not been changed since its last commit in its original repo on GitHub (Ed. except for 3.0.0-ALPHA5 API update, example packet id's and formatting). For any copyright issues, please contact us at https://github.com/poggit/support/issues/new.

PocketMine Forums Release

This plugin allows server owners to log packets with custom selectors to select sessions to log and filters for packets.

For normal servers this plugin has no meaning.

It is useful for debugging purposes when developing a third-party client/tool that uses the protocol, or you just want to know what is going on in the low-end. It is also useful to detect things going wrong with the client, like protocol bugs.
Since networking is an important part, it has been done so it runs as fast as possible, detecting if logging is needed and then logging. Future improvements might include threading.

Check the config.yml file for help configurating filters and selectors.

GitHub README

PacketLogger

Log network packets as you want.

Usage

• Download the latest version for your API from releases.
• Place the .phar in the plugins directory
• Start and stop the server to generate the default config file
• Edit the config.yml (validate yaml)
• Start the server and connect. The logs are located in the plugins/PacketLogger/ directory.

Example config

Below a example config.yml that logs packets for the player with name steve and exclude some packets to reduce the size of the log.

#Configuration file for PacketLogger
#variables available: {name}, {clientId}, {ip}, {time}
logName: "{name}_{clientId}-{time}.log"
#These selectors will match when ANY of the conditions is met - UNCOMMENT AT LEAST ONE SELECTOR, IGN, CID or IP.
selectors:
mode: match #When match, it will allow when a selector is matched. When refuse, it'll log when there is no match
name: #case insensitive
#- steve
clientId:
#- 123456
ip:
#- 192.168.0.1
#These filters decide what packets will be logged
filters:
packetId: #Filter by the packet id (faster)
default: false #Default value of the packets not specified here. true will log it, false will not
#Available packet ID's can be found in https://github.com/PocketMine/PocketMine-MP/blob/master/src/pocketmine/network/protocol/Info.php
0x01: true # LoginPacket
#0xfe: false # BatchPacket
0x0b: true # StartGamePacket
#0x35: false # CraftingDataPacket
#0x3a: false # FullChunkDataPacket
#0x3f: false # PlayerListPacket
0x38: true # BlockEntityDataPacket