Modding Tilesets: Difference between revisions

From PMDOWiki
IDK (talk | contribs)
Created page with "TBD Category:Modding Assets"
 
IDK (talk | contribs)
formatting and image placement
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
TBD
In PMDO, graphics for maps are stored in tilesheet files.  They are the *.tile files found in the Content/Tile subdirectory.  Ground maps can be 8x8, 16x16, 24x24, etc.  Dungeons are always 24x24 in tilesize, and thus can only use tilesheets that are 24x24.
 
There are several ways to import tilesets.
 
== PNG Import ==
The easiest way to import a tileset is through the Map or Ground Editor:
 
[[File:ModdingTilesets_MapEditor.png|frameless]]
 
This option will import a PNG and slice it by the tilesize that the current ground is edited as.  You can check this value by going to Edit->Re-Tile Map:
 
[[File:ModdingTilesets_MapEditorTileSize.png|frameless]]
 
If you are editing a dungeon map, the tile size is always 24x24 and you cannot change this value.
 
 
You can also import a PNG using the Tiles editor:
 
[[File:ModdingTilesets_DevPanelSprite.png|frameless]]
[[File:ModdingTilesets_SpriteList.png|frameless]]
 
In this case, you will be prompted for a tileset size to import it with:
 
[[File:ModdingTilesets_SpriteImportSize.png|frameless]]
 
== DTEF Import ==
If you want to import an autotile, you can also import a folder that conforms to DTEF specification.  You can do this from the Autotile editor:
 
[[File:ModdingTilesets_DevPanelData.png|frameless]]
[[File:ModdingTilesets_DataList.png|frameless]]
 
 
In order for your autotile to be imported correctly, you will need to arrange the tiles in a specific format:
 
[[File:ModdingTilesets_FileStructure.png|frameless]]
 
Tileset images must conform to a naming convention:
 
<code>tileset_[Variant].png</code>
 
You can learn more in the [https://github.com/SkyTemple/skytemple-dtef/blob/main/docs/SkyTemple.rst DTEF specification].
 
Additionally, PMDO extends the format by using additional pngs that adhere to secondary naming convention:
 
<code>tileset_[Variant]_frame[Layer]_[Frame].[Duration].png</code>
 
* Layer: the layer of the animation; tile animations may have multiple layers.  An example would be the water of Apple Woods: The base water changes color on one layer, while the water sparkle animation is done on a different layer.
* Frame: The frame number of the animation.
* Duration: The duration of the animation in frames (1/60th of a second)
 
You can find examples of this in the [https://github.com/PMDCollab/RawAsset/tree/master/TileDtef RawAsset] repository.


[[Category:Modding Assets]]
[[Category:Modding Assets]]

Latest revision as of 22:46, 4 October 2022

In PMDO, graphics for maps are stored in tilesheet files. They are the *.tile files found in the Content/Tile subdirectory. Ground maps can be 8x8, 16x16, 24x24, etc. Dungeons are always 24x24 in tilesize, and thus can only use tilesheets that are 24x24.

There are several ways to import tilesets.

PNG Import

The easiest way to import a tileset is through the Map or Ground Editor:

This option will import a PNG and slice it by the tilesize that the current ground is edited as. You can check this value by going to Edit->Re-Tile Map:

If you are editing a dungeon map, the tile size is always 24x24 and you cannot change this value.


You can also import a PNG using the Tiles editor:

In this case, you will be prompted for a tileset size to import it with:

DTEF Import

If you want to import an autotile, you can also import a folder that conforms to DTEF specification. You can do this from the Autotile editor:


In order for your autotile to be imported correctly, you will need to arrange the tiles in a specific format:

Tileset images must conform to a naming convention:

tileset_[Variant].png

You can learn more in the DTEF specification.

Additionally, PMDO extends the format by using additional pngs that adhere to secondary naming convention:

tileset_[Variant]_frame[Layer]_[Frame].[Duration].png

  • Layer: the layer of the animation; tile animations may have multiple layers. An example would be the water of Apple Woods: The base water changes color on one layer, while the water sparkle animation is done on a different layer.
  • Frame: The frame number of the animation.
  • Duration: The duration of the animation in frames (1/60th of a second)

You can find examples of this in the RawAsset repository.