Table Of Contents

• Table Of Contents
• I'm trying to follow the release installation instructions, but I keep hitting a bunch of error messages...
• Why does the metatile picker in Porymap look so garbled?
• Why am I seeing "palette assignment parameter search matrix failed to find any suitable parameters" even though I am using fewer than the maximum number of colors?
• What's the difference between a "compiled tileset", a "decompiled tileset", a "Porytiles-format tileset", and a "Porymap-format tileset?" Why are there so many confusing terms??
  • Porytiles-Format / Decompiled Tileset
  • Porymap-Format / Compiled Tileset

I'm trying to follow the release installation instructions, but I keep hitting a bunch of error messages...

TODO : fill in

Why does the metatile picker in Porymap look so garbled?

TODO : fill in

Why am I seeing "palette assignment parameter search matrix failed to find any suitable parameters" even though I am using fewer than the maximum number of colors?

TODO : fill in

What's the difference between a "compiled tileset", a "decompiled tileset", a "Porytiles-format tileset", and a "Porymap-format tileset?" Why are there so many confusing terms??

I agree it's a bit confusing. There are multiple terms floating around that mean the same thing. Let's define our terms to clear things up.

Porytiles-Format / Decompiled Tileset

A Porytiles-format tileset and a decompiled tileset are interchangable terms for the same thing. A decompiled tileset is what you feed into Porytiles as input. It has the following basic structure:

pokeemerald/porytiles/my-tileset/
|--- bottom.png
|--- middle.png
|--- top.png
|--- anim/
|------|--- key.png
|------|--- 00.png
|------|--- 01.png
|------|--- ...
|--- ...

(Advanced users will note that you might also provide an attributes.csv, palette-overrides directory, etc.)

This is the tileset that you feed into Porytiles when you run a command like this:

porytiles compile-primary ... pokeemerald/porytiles/my-tileset ...

Porymap-Format / Compiled Tileset

A Porymap-format and a compiled tileset are interchangable terms for the same thing. A compiled tileset is what you get as output when you run Porytiles. It has the following basic structure:

pokeemerald/data/tilesets/primary/my-tileset-compiled/
|--- tiles.png
|--- metatiles.bin
|--- metatile_attributes.bin
|--- palettes/
|------|--- 00.pal
|------|--- 01.pal
|------|--- ...
|--- anim/
|------|--- 00.png
|------|--- 01.png
|------|--- ...

This is the tileset that Porytiles writes to your selected output location (usually specified with the -o flag), e.g.

porytiles compile-primary ... -o pokeemerald/data/tilesets/primary/my-tileset-compiled ...