# POGOserver: reconstructing a Pokémon GO game server

> POGOserver implements a JavaScript replacement server for Pokémon GO and accepts game-app traffic redirected to it. Its source organizes player, inventory, world, gym and encounter behavior into packet handlers backed by a MySQL database.

- Type: Case study
- Targets: Game
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/maierfelix/POGOserver>
- Primary source: <https://github.com/maierfelix/POGOserver/blob/0f73b8805e9dd5e9a1ec309fa1e1f07361689943/README.md>
- Catalog page: <https://awesomerea.org/resources/pogoserver-pokemon-go-case/>
- Record JSON: <https://awesomerea.org/resources/pogoserver-pokemon-go-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/pogoserver-pokemon-go-case/index.md)

## Requirements & limits

- **Prerequisites:** Requires the Pokémon GO app's traffic to be forwarded to the custom server.
- **Prerequisites:** Requires Node.js 6.x or later and MySQL configuration.
- **License:** GPL-3.0 license.

## Primary sources

1. <https://github.com/maierfelix/POGOserver/blob/0f73b8805e9dd5e9a1ec309fa1e1f07361689943/README.md>

## More in Games

- [pokegold-ko: Korean Pokémon Gold and Silver disassembly](https://awesomerea.org/resources/pokegold-ko-case/index.md) · Case study
- [poketaka-sim: reconstructing PokéTaka battle rules from replays](https://awesomerea.org/resources/poketaka-sim-case/index.md) · Case study
- [Pokémon Aurora Ticket Distribution: a GBA disassembly](https://awesomerea.org/resources/aurora-ticket-distribution-case/index.md) · Case study
- [Power Strike: ROM, sound and compression teardown](https://awesomerea.org/resources/power-strike-teardown-case/index.md) · Case study
- [Prineo_RE: PriPara arcade model-format investigation](https://awesomerea.org/resources/prineo-re-case/index.md) · Case study
- [Project Topaz: a Final Fantasy XI server emulation](https://awesomerea.org/resources/project-topaz-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.
