Home

Awesome

This project is no longer maintained. Please use https://github.com/Furtif/POGOProtos instead, which is a fork of this project.

POGOProtos

This repository contains the ProtoBuf .proto files needed to decode the PokémonGo RPC.

If you want to know which messages are implemented right now, click here.

Usage

Versioning

We are following semantic versioning for POGOProtos. Every version will be mapped to their current PokémonGo version.

VersionAndroidiOSExtra
2.14.00.71.01.41.0
2.13.00.69.11.39.1
2.12.00.69.01.39.0
2.11.00.67.21.37.2
2.11.0-beta0.67.11.37.1
2.10.x0.63.11.33.1
2.9.20.61.01.31.0Updated protobuf to 3.3.0
2.9.10.61.01.31.0Updated protobuf to 3.2.0
2.9.00.61.01.31.0
2.8.00.59.11.29.1
2.7.00.57.21.27.2
2.6.x0.55.01.25.0
2.5.x0.53.11.23.1
2.4.x0.51.01.21.0
2.3.00.49.11.19.1
2.2.00.47.11.17.0
2.1.00.45.01.15.0
2.1.0-beta0.45.01.15.0
2.0.x0.43.41.13.4

If you want to figure out the current version in an automated system, use this file.

https://raw.githubusercontent.com/AeonLucid/POGOProtos/master/.current-version

Note: This file will contain pre-release versions too.

Preparation

Current recommended protoc version: "Protocol Buffers v3.3.0".

You can find download links here.

Windows

Be sure to add protoc to your environmental path.

*nix

Ensure that you have the newest version of protoc installed.

OS X

Use homebrew to install protobuf with brew install --devel protobuf.

Compilation

The compilation creates output specifically for the target language, i.e. respecting naming conventions, etc.
This is an example of how the generated code will be organized:

python compile.py cpp:
 - POGOProtos/Data/PlayerData.proto -> POGOProtos/Data/PlayerData.pb.cpp
python compile.py csharp:
 - POGOProtos/Data/PlayerData.proto -> POGOProtos/Data/PlayerData.g.cs
python compile.py go:
- POGOProtos/Data/*.proto -> github.com/aeonlucid/pogoprotos/data
- POGOProtos/Data/PlayerData.proto -> github.com/aeonlucid/pogoprotos/data/player_data.pb.go
python compile.py java:
 - POGOProtos/Data/*.proto -> com/github/aeonlucid/pogoprotos/Data.java
python compile.py js:
- POGOProtos/**/*.proto -> pogoprotos.js
python compile.py objc:
 - POGOProtos/Data/PlayerData.proto -> POGOProtos/Data/PlayerData.pbobjc.m
python compile.py python:
 - POGOProtos/Data/*.proto -> pogoprotos/data/__init__.py
 - POGOProtos/Data/PlayerData.proto -> pogoprotos/data/player_data_pb2.py
python compile.py ruby:
 - POGOProtos/Data/*.proto -> pogoprotos/data.rb
 - POGOProtos/Data/PlayerData.proto -> pogoprotos/data/player_data.rb

Command

Run python compile.py --help for help.

Extra information

You can find all available languages here https://github.com/google/protobuf.

Libraries

If you don't want to compile POGOProtos but instead use it directly, check out the following repository.

LanguageSource
NodeJShttps://github.com/rastapasta/node-pokemongo-protobuf
NodeJS (pure JS)https://github.com/cyraxx/node-pogo-protos
.NEThttps://github.com/AeonLucid/POGOProtos.NetStandard1
.NEThttps://github.com/Necrobot-Private/POGOProtos
.NEThttps://github.com/johnduhart/POGOProtos-dotnet
PHPhttps://github.com/jaspervdm/pogoprotos-php
Gohttps://github.com/pkmngo-odi/pogo-protos
Haskellhttps://github.com/relrod/pokemon-go-protobuf-types
Rusthttps://github.com/rockneurotiko/pokemon-go-protobuf-rs