Skip to content

Latest commit

 

History

History

Dolphin PC texture pack generator

README.md

Generate Dolphin Texture Pack from PC assets

Usage

  1. Have the PC version of "Pitfall: The Lost Expedition" installed
  2. Download the release folder and extract it
  3. Run the application
    • Console Application:
      3.1. Open a terminal of your choice inside the PCTexturePackGenerator folder
      3.2. Run PCTexturePackGeneratorConsole.exe
      • When prompted for a path, enter the location of your install. Or just press Enter if the default value looks good.
    • GUI Application: GUI app is not complete yet
  4. That's it! The texture pack is generated! You can now load it in Dolphin.

How it works

This application automates the process of generating a Dolphin texture pack from a PC installation through the following steps:

  • Extract assets from an existing PC installation using UltiNaruto's PitfallArcTool.
  • Convert the raw texture files to a usable format using Helco's TexConvert
  • Rename the converted textures to their Dolphin GX texture hash equivalent. The mapping was generated from Venomalia's Dolphin Texture Extraction tool's log file after running it on the US GameCube version.
  • Some textures are actually split in Dolphin: Color + Mask, or Palette + Transparency. The same technique as TexConvert on GameCube is used to split the PC textures.

By generating the texture pack yourself, using your own installed assets, this allows us to share this tool completely legally, rather than distributing game assets.

Examples

GameCube PC
Items_NGC Items_PC
Jungle_NGC Jungle_PC

Known issues / Planned features

  • Output a resource pack instead of just dumping all the textures for a texture pack.
  • The fonts texture has a different shape on PC, so smoother PC textures cannot be used directly (this can be fixed with a lot of hardcoded image manipulation).
  • LOD (Level of Details, aka lower resolution) textures are simply skipped for now. I wanna make a different tool that replaces LOD textures by their higher res version for completed texture packs.
  • It's bound to have a handful of unused textures added to the pack. Known ones are already excluded, but there's no easy way to filter them all out.
  • I wanna make a simple GUI application with buttons to select the folders and a logs window. Low priority because the console app is still very easy to use.
  • Use more and higher quality examples!