Melee Toolkit - NOW AVAILABLE (v1.03 Alpha)

[genkaku]

amazing
will start playing around with it soon!

 

[danny135]

Being able to open .dat or .iso files in the program would be convenient, instead of having to open the program and load the file from inside the program.

 

[fatman667]

Dang this is a nice tool, loving it. Hope we can get a model viewer someday for this.

 

[Tcll]

holy [censord] this is awesome =D
how the heck have I not seen this!

/hopes I can compile in SharpDevelop
(Visual Studio expired for me, but SD is just as good)

 

[Tiberious]

Bug report time again:

Attempted to open TyMMario.dat (Metal Mario's trophy) to see once and for all what his environment texture really is, but it shows this:


************** Exception Text **************
System.ArgumentException: Source array was not long enough. Check srcIndex and length, and the array's lower bounds.
at System.Array.Copy(Array sourceArray, Int32 sourceIndex, Array destinationArray, Int32 destinationIndex, Int32 length, Boolean reliable)
at libWiiSharp.TPL.ConvertFromTextureMelee(ImageHeader imageHeader, PaletteHeader paletteHeader, Int32& imageSize)
at MeleeToolkit.TextureListObject..ctor(UInt32 imageHeaderOffset, TextureNode node)
at MeleeToolkit.DatFile.BuildTextureNodes(TreeNode parent, UInt32 offset)
at MeleeToolkit.DatFile.BuildMaterialNodes(TreeNode parent, UInt32 offset)
at MeleeToolkit.DatFile.BuildJointDataNodes(TreeNode parent, UInt32 offset)
at MeleeToolkit.DatFile.BuildJointNodes(TreeNode parent, UInt32 offset)
at MeleeToolkit.DatFile.BuildRootNodes()
at MeleeToolkit.DatFile.OpenDatFile(Byte[] inFile, String inFileName, ListBox& texList)
at MeleeToolkit.MainWindow.OpenDatFileAndUpdateWindow(Byte[] file, String fileName)
at MeleeToolkit.MainWindow.button5_Click(Object sender, EventArgs e)
at System.Windows.Forms.Control.OnClick(EventArgs e)
at System.Windows.Forms.Button.OnClick(EventArgs e)
at System.Windows.Forms.Button.OnMouseUp(MouseEventArgs mevent)
at System.Windows.Forms.Control.WmMouseUp(Message& m, MouseButtons button, Int32 clicks)
at System.Windows.Forms.Control.WndProc(Message& m)
at System.Windows.Forms.ButtonBase.WndProc(Message& m)
at System.Windows.Forms.Button.WndProc(Message& m)
at System.Windows.Forms.Control.ControlNativeWindow.OnMessage(Message& m)
at System.Windows.Forms.Control.ControlNativeWindow.WndProc(Message& m)
at System.Windows.Forms.NativeWindow.Callback(IntPtr hWnd, Int32 msg, IntPtr wparam, IntPtr lparam

 

[Dan Salvato]

Strange, I was able to open the file just fine with the current release. Here is the texture in question:

 

[danny135]

You know what would be useful, a feature to port textures from one file to another. (Or at least export all and import all buttons)

Some guy made a spiderman sheik recently, and it was for the red sheik, but my favorite sheik texture was already on the red costume. So I used this to export all the textures from spiderman sheik and put them in the blue sheik file. Very useful program, would've taken hours to do without it (probably never would've done it).

 

[Dan Salvato]

Are you not able to simply rename the file from PlSkRe.dat to PlSkBu.dat?

 

[SypherPhoenix]

Only a few texture files are swappable like that, most of them have extra data that's altered or simply removed/present.

 

[danny135]

An import all / export all buttons would still be useful. I doubt it would be hard to implement.

 

[Dan Salvato]

You're right, I didn't mean to say it wouldn't be. Next time I touch this program I'll probably add support for that.

 

[Tiberious]

Ah. I must've been using 1.02 still. Sorry. I grabbed 1.03 to make sure, and it opened.

But, TyStand.dat (the trophy base file) does still cause an error:

************** Exception Text **************
System.ArgumentOutOfRangeException: Index was out of range. Must be non-negative and less than the size of the collection.
Parameter name: startIndex
at System.ThrowHelper.ThrowArgumentOutOfRangeException(ExceptionArgument argument, ExceptionResource resource)
at System.BitConverter.ToInt32(Byte[] value, Int32 startIndex)
at MeleeToolkit.Values.ReadUInt32(Byte[] data, Int32 startIndex)
at MeleeToolkit.Values..ctor(String name, UInt32 location, Int32 offset, Types type, Boolean isEditable, Byte[] file)
at MeleeToolkit.MaterialNode..ctor(Byte[] file, UInt32 offset)
at MeleeToolkit.DatFile.BuildMaterialNodes(TreeNode parent, UInt32 offset)
at MeleeToolkit.DatFile.BuildJointDataNodes(TreeNode parent, UInt32 offset)
at MeleeToolkit.DatFile.BuildJointNodes(TreeNode parent, UInt32 offset)
at MeleeToolkit.DatFile.BuildRootNodes()
at MeleeToolkit.DatFile.OpenDatFile(Byte[] inFile, String inFileName, ListBox& texList)
at MeleeToolkit.MainWindow.OpenDatFileAndUpdateWindow(Byte[] file, String fileName)
at MeleeToolkit.MainWindow.button5_Click(Object sender, EventArgs e)
at System.Windows.Forms.Control.OnClick(EventArgs e)
at System.Windows.Forms.Button.OnClick(EventArgs e)
at System.Windows.Forms.Button.OnMouseUp(MouseEventArgs mevent)
at System.Windows.Forms.Control.WmMouseUp(Message& m, MouseButtons button, Int32 clicks)
at System.Windows.Forms.Control.WndProc(Message& m)
at System.Windows.Forms.ButtonBase.WndProc(Message& m)
at System.Windows.Forms.Button.WndProc(Message& m)
at System.Windows.Forms.Control.ControlNativeWindow.OnMessage(Message& m)
at System.Windows.Forms.Control.ControlNativeWindow.WndProc(Message& m)
at System.Windows.Forms.NativeWindow.Callback(IntPtr hWnd, Int32 msg, IntPtr wparam, IntPtr lparam)

 

[shuall]

Darn, I started on something like this, but I couldn't find a lot of literature on dat files. Working on decompiling dols instead. Do you have the source for this? I'd love to try to make a command line version, or maybe port it to Qt so I won't have to use wine/mono. Or would you rather not release it?

 

[Dan Salvato]

The source is already available! There's a link to it in the OP, under the download link. Enjoy!

 

[danny135]

Stage nodes!

 

[Dan Salvato]

I'm making progress on stage nodes, hopefully we'll see a future update including them.

 

[God with a Wavebird]

I decided to try this program out to edit PlLgWh.dat but it didn't load all the textures. I think it only left out these textures: eye closed, eye half closed, eye hurt, eye looking left, and eye looking right.

Other than that I really like this program, it's going to save mondo time

 

[danny135]

I decided to try this program out to edit PlLgWh.dat but it didn't load all the textures. I think it only left out these textures: eye closed, eye half closed, eye hurt, eye looking left, and eye looking right.

This happened to me with PlZdRe.dat, it didn't load all of the eye textures.

 

[Dan Salvato]

Those textures are probably in some node structure that I haven't yet mapped, since they're not the default model textures but applied only in special scenarios.

 

[Tcll]

you know... resizing the DAT isn't all that hard :/
you just have to change the pointers that link to data after the affected (resized) portion of the DAT.

you can easily use the pointer table to figure out the locations of every valid pointer and where they point to so you change them appropriatly

 

[Dan Salvato]

you know... resizing the DAT isn't all that hard :/
you just have to change the pointers that link to data after the affected (resized) portion of the DAT.

you can easily use the pointer table to figure out the locations of every valid pointer and where they point to so you change them appropriatly

I know. I just haven't gotten to implementing it yet.

 

[Kadano]

It would be great if you could add stage texture support! More specifically, I need it for FD. That white phase sucks and everyone hates it, so I want to create a fix.

 

[Viceversa96]

Melee Toolkit​

v1.03 Alpha​

​

Download!​

Source Code!​

To-Do List​

NOTE: This program is in alpha.​

Please back up any files before modifying!​

[collapse="Screenshot 1"]

[/collapse]
[collapse="Screenshot 2"]

[/collapse]
[collapse="Screenshot 3"]

[/collapse]
[collapse="Screenshot 4"]

[/collapse]
[collapse="Screenshot 5"]

[/collapse]
[collapse="Changelog"]
Changelog

v1.03
* You can now edit certain values in .dat files using the node value table.

v1.02
* CToolsWii was re-introduced because LibWiiSharp cannot convert to CMPR. It is used only for converting to CMPR and nothing else.
* Editable node values are dynamic and displayed in bold. However, editing these values still does nothing.

v1.01
* Fully migrated from CToolsWii to LibWiiSharp. All texture formats are now supported for extract/replace. Replacing an indexed texture is limited to as many colors as was used in the original texture.
* Bug fixes

v1.00
* Initial release
[/collapse]



Hello, hackers!

Introducing a new program: Melee Toolkit. This program will provide easy and automatic .dat and .iso editing.

Features (for first release):

• Export and replace textures in .png format
• Load and save directly to .iso, plus export files
• Edit .dat node values on the fly
• Patch .iso between v1.00 and v1.02 (future release)

Functionality is somewhat limited for the time being. You can export/replace files from a disc image and export/replace character textures, and that's about it. Not all texture formats are yet supported.


Please report bugs!

I'm providing an early release so I can hopefully catch some bugs early before going crazy with features.

How do you edit move properties? Like the power of a move like BKB and KBG

 

[Dan Salvato]

How do you edit move properties? Like the power of a move like BKB and KBG

This program is currently not capable of doing that, as most node information for character .dat files has not been added. If somebody would like to add this functionality, I'm willing to help (though this is a backburner project so I won't be adding it myself anytime soon).

 

[Viceversa96]

This program is currently not capable of doing that, as most node information for character .dat files has not been added. If somebody would like to add this functionality, I'm willing to help (though this is a backburner project so I won't be adding it myself anytime soon).

Is there a program that can do that?

 

[Dan Salvato]

I believe the program known as Master Hand will show you many move properties as well as the file offset, but you must edit them yourself in a hex editor.

 

[Lanceinthepants]

Woah I totally missed this. Great work IE

 

[AprilShaw]

I believe the program known as Master Hand will show you many move properties as well as the file offset, but you must edit them yourself in a hex editor.

Where do you find this program? I searched around for it before and couldn't find it

 

[Dan Salvato]

Where do you find this program? I searched around for it before and couldn't find it

http://www.smashboards.com/threads/tool-master-hand-v1-20-melee-character-file-viewer.313930/

 

[AprilShaw]

Thanks dude

 

[the wizard howl]

Is there a reason audio replacement is so low on the list? 'cause I do it more often than anything else and it takes forever.

 

[Dan Salvato]

Is there a reason audio replacement is so low on the list? 'cause I do it more often than anything else and it takes forever.

Mainly because the format is not fully understood, so it would take a ton of work for a flawless implementation. I highly doubt it will happen unless someone else decides to contribute to this project.

 

[Tcll]

UGC is planned to convert audio and video, but that's a future project of UMC...

so unfortunately, Melee audio hacking wont happen any time soon, unless another programmer makes it easier...

EDIT:
also, here's something I've worked on to help out with what's known about the DAT format:
http://wiki.tockdom.com/wiki/HAL_DAT_(File_Format)
^I've written it to describe much of the format at a level for people who know how to hex a file.
(kinda noob level, but kinda basic level as well)

 

[OninO]

Hmm, I just found the link to this thread. I'll checkout the source tonight and see what can be done about maybe getting an editor for move stat values up and running. Caveat: I've never worked in C# before (only python/C/Matlab) so it will take me a while to figure out how anything is done.

@ Dan Salvato Could you please create a git repo of the source for the Melee Toolkit?

 

[Dan Salvato]

Hmm, I just found the link to this thread. I'll checkout the source tonight and see what can be done about maybe getting an editor for move stat values up and running. Caveat: I've never worked in C# before (only python/C/Matlab) so it will take me a while to figure out how anything is done.

@ Dan Salvato Could you please create a git repo of the source for the Melee Toolkit?

The repo is currently public on Google Code. The link is in the OP. Unless you were specifically asking for a git repo as opposed to the current one?

 

[OninO]

Hi Internet, I was, I use git and for some reason I get "bad url" when trying to use git-svn with that repo link.

 

[Dan Salvato]

Hi Internet, I was, I use git and for some reason I get "bad url" when trying to use git-svn with that repo link.

Okay, I imported the existing repo into a new BitBucket repo and we'll use that one from now on. I prefer BitBucket anyway and maybe now you can branch/merge instead of fork, since I'm working on some stuff as well. If you PM me account info I'll add you to the project.

 

[Tcll]

@ OninO : when getting an SVN from Google, I usually view a raw file and copy the URL, then delete what's after /trunk before importing.

I use Tortise SVN, it's really good


on a side note:
IE, how could you do me like this >3< (Project M Dev Team)
everyone knows I hate PM, mainly for it's horrid ledge grabbing and Pika's B-air.
lol

 

[Luddoj]

I hope this amazing tool continues to be developed. The amount of things simplified by this is ASTOUNDING, with texture hacking now basically converted to a matter of editing your textures and then just choosing them to replace in-game files. This is what the Melee hacking community has been needing for quite some time, and, after testing it myself, it works perfectly, not only for textures but also for replacing pre-made files (like the ones with .dat) easily just by right clicking them.

So yeah, I'm definetely happy this exists, and after watching the amazing job they did with the custom Melee used for BEAST 5, I feel even more inspired to focus on Melee Modding.

 

[Tcll]

last I talked to IE, he had to take a break...

I havn't stopped working on the format though, and I have a near final pathfinder built for entry into the file data (of ANY HAL-formatted file)
reference: http://wiki.tockdom.com/wiki/HAL_DAT_(File_Format)

as noted on the page, the pathfinder works with more than just Melee files:

though it currently doesn't test if a pointer is valid in the relocation table...
it only tests to make sure that a pointer is smaller than the file size, and offsets to a structure.

so yea, TODO:
if ptroffset in relocations: # test struct size
elif pointer: # invalid pointer