Home - Rangi42/polishedcrystal GitHub Wiki

v3.2 is now live! 🎉 It'll take some time for this wiki to get up to date.

Welcome to the Polished Crystal Wiki!

This is a community-driven wiki for Polished Crystal — by players, for players.

Not all information might be entirely up to date by nature. The only fully accurate, fully up-to-date information is the source code in the repository. (If a Development Rolling Release exists, the master branch will track it. Browse the repository with care.)

Make sure to read the official README and FAQ:

If you have a question about playing Polished Crystal, or think you've found a bug, please read this FAQ first.

— Polished Crystal dev team, FAQ.md

General Gameplay Notice

Read the official Releases page carefully. It also links to the save patcher for upgrading your save files from older versions. As of Oct. 2025, the latest official build is v3.2.0, tagged as Latest on GitHub.

Some additional notes:

  • A few new side quests may only be teased in-game; those areas are works in progress.
  • The game requires accurate emulators shown on Releases and FAQ, particularly because some emulators (and their save-state function) are incompatible with the new Pokémon Box and corrupt it.
  • It's impolite to ask the devs for the estimated time of arrival (ETA); that's a general rule for fan-games, as they don't revolve around schedules or deadlines. Follow the #development channel in the Discord server.
  • About older versions:
    • v2.2.0, finished in Sept. 2016 (and tagged as such in 2017), is obsolete and out of support; the upgrade of v2.2.0 saves is unavailable.
    • What was called 9bit became v3.0.0.

Known Issues

  • Intimidate may trigger twice, overriding opponent Ability activations.
  • Damage-dealing moves with an additional effect may fail to trigger it when knocking out an opponent: e.g. Flame Charge against a non-last opponent; Thief against a wild Pokémon.
  • Some secondary damage calculations may be wrong: e.g. Toxic; confusion damage.
  • Inver's Pokémon may be bugged, which may even crash the game.
  • Hurricane's animation doesn't look like a wind.
  • Alolan Dugtrio lacks its back sprite.
  • A few texts may be bugged: e.g. Elm; Blaine; Places and People radio.
  • Blanche's pronoun may be incorrect.
  • Some Gen. IX learnsets are missing.

Info for Testers

If a Development Rolling Release exists, it won't be intended for public playtesting but for the development purpose. Ask the devs about playtesting if you wish to help them.

Info for Cheaters

Use the tools linked below (instead of PKHeX). Avoid asking the devs for cheat codes.

The devs have been concerned about false bug reports caused by cheating. Cheat codes overwrite a specific data byte, so using incorrect or outdated ones not only fails to work but also corrupts your game/save:

  • This game's data structure is significantly different from the vanilla's; so PKHeX is incompatible, and vanilla codes are highly likely to cause corruption.
  • Due to its active development, the game may often reorganize its data, which outdates cheat codes quickly.

For those interested in more complex cheating:

  • Read the .sym file guide to learn how to generate valid cheat codes;
  • Use your emulator's hex editor; or
  • Clone the repository to code and create a custom build.

Wiki Pages

Use the sidebar of this wiki. It could be at the bottom on mobile browsers.

External Links

Some players are working on automating databases and tools for this game. Show them some support!

WIP Auto-Generated Databases

WIP Auto-Generated Tools