GRF: GRF Editor

[Tokei 403]

View File

GRF Editor

---

Hey everyone,

This is a GRF tool I started to develop for my own personnal use, but I thought I'd share it since I've upgraded the UI. Its primary goal is to be easy to use while offering a wide variety of options and customizations. The software is quite stable and can handle large operations easily.

How to install

• Download the zip archive provided from the download link at the bottom of this description or directly from there : http://www.mediafire.com/?aflylbhblrzpz0h
• Install the application with GRF Editor Installer.exe; if you are missing a .NET Framework you will be prompted to download it.
• Once you are done, you can start the program from the link on your desktop.

Key features

• Overall speed is faster (or at least equal) than any GRF tool.
• Common operations : add, delete, merge, extract, preview, save.
• Undo and redo for any operation.
• It can open any GRF file.
• Clean and very interactive interface.
• Saving formats supported : 0x200, 0x103 and 0x102 (through the Settings page) and conversion to the Thor format.
• Instant filter and search options (example : "map .gat").
• File association and context menus integration for .grf, .gpf, .rgz and .thor (through the Settings page).
• Can rebuild separated images into one file easily.
• Drag and drop (with the ALT key, can be modified in the Settings page). This is a big part of the software; most of the items can be moved around within the application itself or from/to Windows Explorer.

Tools

• Sprite editor : a simple sprite editor with powerful features. Semi-transparent images can be added, you can easily change the order or replace images, etc. This tool can convert images in the wrong type by showing you multiple solutions (merging a new palette, dithering the image by using current palette, using the closest color, and a few more).
• Grf validation : allows you to validate a GRF with multiple settings. It can detect corrupted GRF entries, invalid sprites, empty files, non-GRF files, duplicate files and a lot more.
• Flat maps maker : generates flat maps from .gat and .rsw files. Useful to generate WoE maps or to fasten up the loading time.
• Patch maker : generates a GRF patch based on two different GRFs.
• Hash viewer : shows the hash code (both CRC32 and MD5) for files.
• Image converter : converts an image to any format requested (BMP, PNG, JPG, TGA).
• GrfCL : used to create batch files (.bat) which can automate tasks on GRF files. See the content in GrfCL.rar in the download for more information. This tool can be customized from the sources as well.
• Palette recolorer : creates new sprites by changing their colors (this tool is now deprecated).
• Client database editor : allows modifications of the database client files (txt and lua) with easy and simple tools. Work in progress.

Grf encryption

The encryption feature has been enabled again. It's similar to what it used to be and it has been tested on client versions ranging from 2012-08-01 to 2014-02-05. Some error messages will be displayed if necessary. If you have an issue, copy the error message (with the code, if there's one) and send me the client executable with the cps.dll file generated by GRF Editor. There shouldn't be compatibility issues anymore though!

Thor files

Thor files are patches used by Thor Patcher (

http://thor.aeomin.net/

). Because of their similarity with the GRF file structure, they have been integrated within GRF Editor. The primary utility of this feature is that it allows you to add encrypted files to a Thor patch. All the other options can be achieved by using Thor Maker. You'll find the necessary steps below, but test your patches before sending them off to players (I've done a lot of testing on my end, but better be safe).

If you're using SecureGRF, then make a new GRF, add the files and encrypt it. In GRF Editor, open the encrypted GRF you just made, use "Save as" and name the new file with a .thor extension. That's it, if you want to change the output directory, click on the root node of the project and select the tab "Container options". You can select the output mode and the GRF to merge the patch with. Simply save again if you change these properties.

If you're using GRF Editor's encryption, then make a new Thor file (File > New > New Thor) and add the files you want to patch it with. Right-click on the files you want to encrypt and use Encryption > Encrypt.

Technical stuff

• Requires .Net Framework 3.5 (SP1) Client Profile to run (3.5 or more will work as well).
• Automatically converts file name encoding to their proper values (you can change the encoding).
• Data virtualization is used as much as possible to preview files, meaning the files aren't completely loaded.
• Right-clicking an item will bring up the available options with that file.
• Preview file formats : txt, log, xml, lua, lub, bmp, png, tga, jpp, db, ebm, pal, gnd, rsw, gat, rsm, str, spr, act, imf, fna and wav.
• Services are "crash ready", meaning that you will be warned about a failed operation and no work will be lost (the application won't close and crash). It tries to continue operating even if it meets unsual conditions.
• Operations can be cancelled by clicking on the button near the progress bar.
• The warning level can be changed to avoid messages like "Please select a folder first."
• When prompted with an error, use Ctrl-C to copy the current dialog's content.

Some screenshots!

1) Previewing an act file, while showing the search feature

2) Preview of a model file (rsm)

3) Preview of GrfCL with the MakeGrf command

4) Preview of maps

5) Preview of Grf validation

6) Search feature (press Ctrl-F or Ctrl-H to bring up within a text editor)

Got a feedback? I'd gladly hear you out and fix issues you have with the program.

---

• Submitter
  Tokei
• Submitted
  01/10/2013
• Category
  GRF Files
• Content Author

 

Edited October 1, 2015 by Tokei

[eJay 75]

Wooo! This is great nice work Tokei!

[Syouji 371]

Wow this is amazing work. It has features GRF Tool only has. Is it possible if you can add GPF as a saving option as well? + 1 to your work.

Another possible feature could be GRF Encrypt / Decrypt Option

[Fai T.Flowright 2]

yeah great tools, tq

[QQfoolsorellina 99]

very useful tool !

need more encodeing code like codepage 950 and view spr feature

[Tokei 403]

Wow this is amazing work. It has features GRF Tool only has. Is it possible if you can add GPF as a saving option as well? + 1 to your work.

Another possible feature could be GRF Encrypt / Decrypt Option

Well, a GRF structure is exactly the same as a GPF file (the only difference is the file name extension), so I added the option when saving! But yeah, as far as the encryption goes, that's not something I'll do right away. The application can already decrypt files and it does it automatically when you save a GRF. I'm still not sure why someone would encrypt their GRF though... but the option will definitely be available anyway.

very useful tool !

need more encodeing code like codepage 950 and view spr feature

I'm working on the first part, but what SPR features do you want exactly? A converter from BMP files to SPR and vice versa?

[QQfoolsorellina 99]

I'm working on the first part, but what SPR features do you want exactly? A converter from BMP files to SPR and vice versa?

Thanks for working on encodeing code.

The view spr features like the show map features, we can see what the selected spr look like.

[Tokei 403]

Thanks for working on encodeing code.

The view spr features like the show map features, we can see what the selected spr look like.

I'll be honest, I'm a bit confused here! You can already view the spr files (here's what you can preview : txt, log, xml, lua, lub, bmp, png, spr, pal, gat, jpg, tga, wav and act.)

Did you mean something else?

[QQfoolsorellina 99]

Thanks for working on encodeing code.

The view spr features like the show map features, we can see what the selected spr look like.

I'll be honest, I'm a bit confused here! You can already view the spr files (here's what you can preview : txt, log, xml, lua, lub, bmp, png, spr, pal, gat, jpg, tga, wav and act.)

Did you mean something else?

It is strange, all features work for me except the spr-preview

[Brainsteal 14]

Very useful tool! Thank you!

[mrlongshen 76]

nice tools. thank man..

[Tokei 403]

It is strange, all features work for me except the spr-preview

It's a problem with windows XP and indexed colors (it should be fixed now). Thanks for finding this bug ;P.

Oh also, you can select any encoding you want. HOWEVER, watch out for the automatic file name translation. There will be no problems if you work with Korean or ANSI file names, but if you add japanese file names, it might have issues detecting the proper encoding (so select the japanese codepage before dropping the files with japanese characters).

Edited January 11, 2013 by Tokei

[QQfoolsorellina 99]

It's a problem with windows XP and indexed colors (it should be fixed now). Thanks for finding this bug ;P.

Oh also, you can select any encoding you want. HOWEVER, watch out for the automatic file name translation. There will be no problems if you work with Korean or ANSI file names, but if you add japanese file names, it might have issues detecting the proper encoding (so select the japanese codepage before dropping the files with japanese characters).

Thank you so much ! now it was working perfectly

[technoriot01 1]

Very useful tool indeed. =))

I agree to Syouji to add GRF Encrypt / Decrypt Option.

Anyway thanks to you for this tool. =))

[Tokei 403]

Very useful tool indeed. =))

I agree to Syouji to add GRF Encrypt / Decrypt Option.

Anyway thanks to you for this tool. =))

I'm not sure of what you mean exactly by this though. Are you referring to the DES encryption used by the 0x102 and 0x103 GRF formats? (This should be coming very soon, the code is already written, I'm just testing to make sure everything is working properly). But... I still don't understand its purpose; what is the encryption of the GRF used for?

[technoriot01 1]

Very useful tool indeed. =))

I agree to Syouji to add GRF Encrypt / Decrypt Option.

Anyway thanks to you for this tool. =))

I'm not sure of what you mean exactly by this though. Are you referring to the DES encryption used by the 0x102 and 0x103 GRF formats? (This should be coming very soon, the code is already written, I'm just testing to make sure everything is working properly). But... I still don't understand its purpose; what is the encryption of the GRF used for?

Just like this. http://rathena.org/board/topic/60627-guide-securing-your-grf-includes-grf-encryptor-and-game-client-decrypt-library/

[Kirito 1]

Nice! Thank you!

[SlashGeeGee 19]

i can't run it. on windows 7 even I run it as Administrator. it won't start. :'(

[Cephaler 2]

Very nice but, how to make an entire new grf and then merge my data folder with it? Like grf builder does?

Edited January 12, 2013 by Cephaler

[Tokei 403]

i can't run it. on windows 7 even I run it as Administrator. it won't start. :'(

You need .Net version 4 or more to be able to run it (also WPF applications take longer to load for their first time). -> http://www.microsoft.com/en-ca/download/details.aspx?id=17718

Very nice but, how to make an entire new grf and then merge my data folder with it? Like grf builder does?

Hm, you select your data folder in explorer and drop it in the left panel / tree. If you already have a data folder in your new GRF, you will have to select all the files and folders inside your data folder and drop them on the data folder node in the tree (I will change that so that two directories with the same name merges by default).

Just like this. http://rathena.org/b...ecrypt-library/

Enabling a similar type of encryption requires an external library used by the client and I have absolutely no knowledge regarding a client's configuration. Also, many applications that will attempt to patch the GRF will have difficulties reading its content and even if you manage to make some part of it non-encrypted (necessary for the merging purposes), some patcher might fail because they won't recognize the content (I'd rather avoi that). Plus... there's already a tool that does it if you really want to ;P. I'm also not a huge fan of encryption so it would be rather annoying / boring for me. So yeah, I most likely won't add an Encrypt / Decrypt feature.

General note :

If anyone finds or gets an error related to the DES encryption of the formats 0x102 and 0x103, please report it as soon as possible.

[Euphy 1,109]

This is awesome. Great work!

[Olrox 913]

Great tool, thanks a lot for sharing! it is really awesome!

[icabit 69]

thx dude

[Aeomin 25]

Seems working fine, but you need improve on GUI...

[Tokei 403]

Seems working fine, but you need improve on GUI...

Such as what? I think the GUI's pretty much done, what would you suggest updating? I'm aware there are a couple of common shortcuts missing, such as the del key or F2 key, but that will be added in the next release.