CloudMax's N64 Texture Packer v2.3

The tool has been tested and works on the latest version of Chrome, Firefox, Opera and IE.

Internet Explorer 9 and below is not supported due to lack of proper file and binary support.


I cannot guarantee that the tool works properly in all scenarios. Always keep a backup of your files.

Keep in mind that this tool is for decompressed ROM files and will not work otherwise.

Importing Textures
0/0
0%
Next

Changelog

Previous
Version 2.3 (Released 2/23/2014)
  • Solved an issue that caused textures to not get imported if the browser didn't load them fast enough. If changes didn't apply when importing a pack before, it will most likely work now.
  • The ia4 converter now round the colors correctly when provided with ones that aren't supported.
  • The rgb5a1 converter no longer set the colors incorrectly for transparent pixels.
  • Updated two textures in the OoT Debug generator which were incorrectly set to i4 instead of ia4. The textures were sign_background and ocarina_background in the message_static folder.
  • Incorrectly named folders and images as well as attempting to read/write outside the bounds of the ROM should no longer cause the tool to crash and instead provides an error message in the browser console.
Version 2.2 (Released 2/16/2014)
  • Solved an issue that caused some textures to not get extracted from the ROM.
  • Over 100 textures were added to the OoT Debug generator. Some texture names were changed.
Version 2.1 (Released 1/27/2014)
  • IA16 was incorrectly named IA8, this has been corrected.
  • IA8 was incorrectly named IA4, this has been corrected.
  • IA4 (the real IA4 format) is now supported.
  • All textures in the OoT Debug Generator that were incorrectly set to I4 has been corrected.
  • Solved an issue that caused the gray and alpha channels to swap place in IA16 textures.
Version 2.0 (Released 1/26/2014)
  • Solved an issue that caused some browsers to crash when attempting to generate a pack.
  • When using the tool online you'll no longer have issues with previous versions being cached.
  • The tool no longer get stuck in the loading state when providing an invalid file.
  • The tool will no longer crash when using any symbol except underscore in pack file names.
  • Generated packs will only include the A_00000000_default folder if the pack is empty.
  • Texture Packs and ROMs that are generated now have a timestamp in the file name.
  • The OoT MQ Debug ROM pack now include title screen, item names and action texts textures.
  • A new feature called "Generators" has now been implemented. The generators is what tells the tool where textures are located so that they can be extracted from the ROM. You're able to add new ones for other games, or modify existing ones. There is a brief explanation of how it is set up in the generators/generators.js and generators/oot_debug_gen.js files.
Version 1.2 (Released 1/25/2014)
  • The tool will no longer crash when importing ia8 and rgb5a1 textures.
  • Solved an issue that caused the tool to get stuck in a loop if provided with 2 ROMs or 2 Packs.
  • Fixed several crashes that could occur if you provided various files in specific orders.
  • You must now provide a N64 ROM in order to generate a new texture pack.
Version 1.1 (Released 1/24/2014)
  • Deflate compressed files are now supported.
  • .jpeg/.jpg and .bmp/.dib images are now supported.
  • The tool will no longer crash if you attempt to import an empty texture pack.
  • If an error occurs, such as the one specified above, you'll now receive a message.
  • Large files will no longer cause the tool to freeze temporarily when importing a pack.
  • Rewrote the texture pack import code to improve performance and make import bar reliable.
  • Solved an issue that caused the tool to get stuck in an import state if a file was invalid.
  • You can no longer generate or import a pack when the tool is already doing so.
  • The import bar is now properly reset after importing a texture pack.
  • Updated a dead link in the instructions.txt file.
  • All buttons can now be properly selected with Tab.
  • All links now open a new tab.

Contact

You can get in touch with me over at the BadnikNET #zelda IRC.

IRC
Generate Texture Pack

To generate a new texture pack, drop a ROM file anywhere on the page.

Only the OoT MQ Debug ROM has a texture pack generator by default.

For info on how to create your own, read the .js files in the generators folder.

The extension of the ROM must be .z64, .n64 or .v64 (The tool does NOT byteswap the ROM)


Import Texture Pack

To import a texture pack into a ROM, drop the pack .zip and ROM file on the page together.

The extension of the ROM must be .z64, .n64 or .v64 (The tool does NOT byteswap the ROM)


Texture Pack Format

The pack is a zip archive that contains a directory named "pack".

The pack directory contains another set of folders, each representing an offset.

The folder names are formatted as [type]_[hex address]_[description]

Type A will import the textures relative to the specified address.

Type P will import the textures relative to the 32bit value at the specified address.

The description is optional and can be used to describe what the folder points toward, etc.

The actual textures are located within these folders and are .png files.

The textures names are formatted as [hex address]_[texture type]_[description].png

The address indicates where the texture should be imported to relative to the folder offset.

The texture type is what format the texture is inside the ROM, see below for supported formats

The description is optional and can be used to describe what the texture is used for, etc.


Examples

medallion_pack.zip/pack/P_00012FF0_icon_item_24_static/00000900_rgba32_fire_medallion.png

This imports the image as an rgba32 texture to offset 0x900 relative to the address at 0x012FF0.

medallion_pack.zip/pack/A_007D6000/00000900_rgba32.png

This imports the image as an rgba32 texture to offset 0x900 relative to address 0x7D6000.


Supported Texture Formats: i4, i8, ia4, ia8, ia16, rgb5a1 and rgba32