roblabla / minecraft-dissector Goto Github PK

# README

    This is a WireShark dissector to decode the Minecraft protocol.  It is 
    incomplete but useless. Especially you should keep these words from the 
    license in mind:

    > IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY 
    > CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, 
    > TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE 
    > SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

# HOWTO

    For Ubuntu you need:
    sudo apt-get install wireshark wireshark-dev libgtk2.0-dev pkg-config libtool

    run Make in the directory

    it expects /usr/include/wireshark to exist, on ubuntu aptitude install wireshark-dev

    It should copy the plugin to ~/.wireshark/plugins, and then loading a wireshark packet dump should decode the packet types.

    When I tested, I used a tcpdump with full packets, I'd recommend the same or things will probably break.

    ex:
    tcpdump -w minecraft.dump -s 0 'port 25565'

# CREDITS

    * for the playground
        * http://www.wireshark.org
    * for initial development
        * https://github.com/ScottBrooks/minecraft-dissector
        * https://github.com/AlanDeSmet/minecraft-dissector
    * for all protocol wisdom
        * http://mc.kev009.com/Main_Page
    * for inspiration and stuff
        * https://github.com/superjoe30/mineflayer

# NUMBER PLATE

    Enjoy!