# dream-server: reconstructing a Pokémon Dream World server

> dream-server reconstructs server behavior for Pokémon Dream World, including Game Sync save uploads and downloads. Its Flask handlers track sleeping Pokémon state, store save data and assemble byte responses; code comments record observations about how the game interprets parts of a download response.

- Type: Case study
- Targets: Game · Protocol
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-08
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/NDSLink/dream-server>
- Primary source: <https://github.com/NDSLink/dream-server/blob/081d77ad32ef4b723a159b2cc7e1e71697ff1605/dsio.py>
- Catalog page: <https://awesomerea.org/resources/dream-server-case/>
- Record JSON: <https://awesomerea.org/resources/dream-server-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/dream-server-case/index.md)

## Requirements & limits

- **Prerequisites:** Python with Flask, Flask-SQLAlchemy, Flask-Migrate, Flask-Login, Flask-Babel, Flask-Bootstrap and Flagsmith.
- **Limits:** The save-download response includes fields whose behavior remains under investigation.
- **License:** MIT license.

## Primary sources

1. <https://github.com/NDSLink/dream-server/blob/081d77ad32ef4b723a159b2cc7e1e71697ff1605/dsio.py>
2. <https://github.com/NDSLink/dream-server/blob/081d77ad32ef4b723a159b2cc7e1e71697ff1605/README.md>
3. <https://github.com/NDSLink/dream-server/blob/081d77ad32ef4b723a159b2cc7e1e71697ff1605/app.py>

## More in Games

- [dream: Dream: Land of Giants disassembled and reimplemented in C](https://awesomerea.org/resources/dream-land-of-giants-case/index.md) · Case study
- [DriveClub Recomp: running the PS4 game on Windows and Linux](https://awesomerea.org/resources/driveclub-recomp-case/index.md) · Case study
- [ds3os: reconstructed Dark Souls 2 and 3 online servers](https://awesomerea.org/resources/ds3os-dark-souls-server-case/index.md) · Case study
- [EATF: Eric & the Floaters disassembly](https://awesomerea.org/resources/eatf-eric-floaters-case/index.md) · Case study
- [Elite: a symbolic MSX game disassembly](https://awesomerea.org/resources/elite-msx-disassembly-case/index.md) · Case study
- [Encounter HD: rebuilding the 1983 Oric adventure](https://awesomerea.org/resources/encounter-hd-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.