#file-format #pokemon #mystery #dungeon #parser #image #wan

bin+lib pmd_wan

A library that can read wan file, a sprite format used in pokemon mystery dungeon games

13 stable releases (4 major)

5.1.1 Jan 29, 2023
4.0.0 Feb 25, 2022
3.0.1 Dec 2, 2021
2.0.1 Nov 27, 2021
1.1.1 Jun 12, 2020

#658 in Parser implementations

Download history 647/week @ 2024-01-05 107/week @ 2024-01-12 75/week @ 2024-01-19 166/week @ 2024-01-26 181/week @ 2024-02-02 67/week @ 2024-02-09 52/week @ 2024-02-16 108/week @ 2024-02-23 65/week @ 2024-03-01 327/week @ 2024-03-08 117/week @ 2024-03-15 54/week @ 2024-03-22 667/week @ 2024-03-29 211/week @ 2024-04-05 94/week @ 2024-04-12 63/week @ 2024-04-19

1,038 downloads per month

CC0 license



Licensed under the creative–common 0 license (TODO: just put a LICENSE file)


Note that the information written bellow is outdated, and new function has been added. None has been removed, thought. (Still have to update it).

read wan sprites, used in pokemon mystery dungeon: Explorers and Rescue Team (only tested with Explorers of Sky)

reading : production ready. Should never panic, and has been fuzzed

  • m_attack.bin can sometimes errors

writing : does not provide a nice API for high level stuff for now, but should work correctly, and produce readable images by the game


I’m currently trying to read images from the Shiren The Wanderer on DS. They are similar in some point, and dissimilar in others.

For now, I focus on being able to read them.

It’s behind a feature flag. It is mostly experimental code for now.

Executing benchs

The benchs use real image not under the license of this repo, that you need to provide yourself.

  • parse use the bulbasaur.wan in the m_ground.bin file. Can be exported with SkyTemple or another .bin EOS extractor.
  • find_fragment use the White Kyurem sprite by FunnyKecleonMeme. It can be downloaded here : (TODO: actually put the download link)


~68K SLoC