Print

Please login or register.
1 Hour 1 Day 1 Week 1 Month Forever
Login with username, password and session length

[BradUffner]

Raw explorer is a tool designed to let you visually browse, edit, and create Raw files for Dwarf Fortress.  All the objects defined in the raws are categorized and displayed in a tree, with all the tokens of the selected object displayed in a searchable grid.  The tokens can be edited directly in the grid with simple controls that help ensure the proper syntax.  Thanks to a great community almost all the major tokens and their arguments are fully documented.  An easy to use definition editor will let you upload definitions for undocumented, or new tokens with just a few clicks, making them available to anyone else.

Screenshots:
Browsing the Creatures:

Spoiler (click to show/hide)

Complex Argument Editing:

Spoiler (click to show/hide)

Token Definition Editor:

Spoiler (click to show/hide)

Custom Building Designer:

Spoiler (click to show/hide)

Spoiler (click to show/hide)

Spoiler (click to show/hide)

Spoiler (click to show/hide)

Language Editor:

Spoiler (click to show/hide)

Graphic Set / Tile Editor:

Spoiler (click to show/hide)

Spoiler (click to show/hide)

Spoiler (click to show/hide)

Recent Changes:

Spoiler (click to show/hide)

• Beta 13
• Bug fixes for Workshop designer
• Added Object Templates
• Beta 12
• Bug fixes
• Beta 11
• Fixing various bugs
• Beta 10
• Full Graphic Set Editing and Creation
• When inserting a token you can select and insert multiple tokens at one time.
• Newly inserted objects are sorted correctly now.
• Right clicking the empty area of grids should show the context menu now. (fixes being able to use it on empty grids)
• Window positions and sizes are remembered
• A fabulous new application icon.
• Many more small bug fixes that I've lost track of.
• Beta 9
• Fixed ability to delete Objects and Tokens.
• Added Graphic set Editing with Tile Editor. Look for it under the "Library" menu.
• Context menu in Object Editor now works when there are no tokens.
• Creating a new object will default the object to the type of the currently selected object.
• Added context menu to object category tree nodes to allow creation of a new object of the selected type.

Download Beta 13

DFFD Mirror
Raw Explorer requires the .NET Framework version 4.0.

[RadHazard]

This is amazing! Being a dabbling modder myself, I'm looking forward to being able to use this.  The only feature you haven't mentioned that I'd like to see would be a simple search/filter function.  Being able to search all the files by the name of a creature/item/material/whatever would be nice.  Even cooler would be if you could define any tag or combination of tags and be able to filter out anything that has those tags.  An example would be searching for all creatures with the QUADRUPED or QUADRUPED_HOOF tokens and with the [GRAZER] tag to display all four-legged herbavores.

[UnkemptArmada]

Honestly, even a good viewer like this is ultra helpful. I have problems wrapping my head around the pure-text sometimes (I'm too addicted to my programming IDE's ). A beautiful idea with just the right amount of ambition.

[3]

Just so you know, there have been various attempts at this sort of thing in the past. The one I remember (and apparently the most recent) is here.

[BradUffner]

This is amazing! Being a dabbling modder myself, I'm looking forward to being able to use this.  The only feature you haven't mentioned that I'd like to see would be a simple search/filter function.  Being able to search all the files by the name of a creature/item/material/whatever would be nice.  Even cooler would be if you could define any tag or combination of tags and be able to filter out anything that has those tags.  An example would be searching for all creatures with the QUADRUPED or QUADRUPED_HOOF tokens and with the [GRAZER] tag to display all four-legged herbavores.

That's all planned!  In addition to that there will be the ability to apply commands as Batches to all objects that fit some criteria, as in "Add / Remove [Token] to all these objects", as a single step.

[BradUffner]

Honestly, even a good viewer like this is ultra helpful. I have problems wrapping my head around the pure-text sometimes (I'm too addicted to my programming IDE's ). A beautiful idea with just the right amount of ambition.

I may upload an alpha version of this soon, as long as everyone realizes that it's buggy as hell (no input validation) and is missing a ton of even the most basic features.

[RadHazard]

This is amazing! Being a dabbling modder myself, I'm looking forward to being able to use this.  The only feature you haven't mentioned that I'd like to see would be a simple search/filter function.  Being able to search all the files by the name of a creature/item/material/whatever would be nice.  Even cooler would be if you could define any tag or combination of tags and be able to filter out anything that has those tags.  An example would be searching for all creatures with the QUADRUPED or QUADRUPED_HOOF tokens and with the [GRAZER] tag to display all four-legged herbavores.

That's all planned!  In addition to that there will be the ability to apply commands as Batches to all objects that fit some criteria, as in "Add / Remove [Token] to all these objects", as a single step.

Then this tool could very well become my favorite modding tool ever.  Good luck to you in making it!

[BradUffner]

I added a preview build up in the first post...  be kind.

[Alem]

This tool would be an absolute dream. Hell as it is with the ability to edit the fields would be amazingly useful, get all the other features mentioned in and this would be total win. Good luck! 

[RadHazard]

Okay, I downloaded your preview and I'm getting an error message when I try to open up my raws folder.  I'm using Ironhand's 0.34.04 package with several custom creatures, reactions, and interactions added.  Here's the error message it's giving me:

Code: [Select]

See the end of this message for details on invoking
just-in-time (JIT) debugging instead of this dialog box.

************** Exception Text **************
System.ArgumentException: An item with the same key has already been added.
   at System.ThrowHelper.ThrowArgumentException(ExceptionResource resource)
   at System.Collections.Generic.Dictionary`2.Insert(TKey key, TValue value, Boolean add)
   at System.Collections.Generic.Dictionary`2.Add(TKey key, TValue value)
   at RawExplorer.RawObjectDictionary.add(RawObject obj)
   at RawExplorer.RawLibrary..ctor(String rawDirectory)
Just to be clear, I should be selecting the "raw" folder when I load it up, not the main dwarf fortress folder or the raw/objects folder, right?

[BradUffner]

Okay, I downloaded your preview and I'm getting an error message when I try to open up my raws folder.  I'm using Ironhand's 0.34.04 package with several custom creatures, reactions, and interactions added.  Here's the error message it's giving me:

Code: [Select]

See the end of this message for details on invoking
just-in-time (JIT) debugging instead of this dialog box.

************** Exception Text **************
System.ArgumentException: An item with the same key has already been added.
   at System.ThrowHelper.ThrowArgumentException(ExceptionResource resource)
   at System.Collections.Generic.Dictionary`2.Insert(TKey key, TValue value, Boolean add)
   at System.Collections.Generic.Dictionary`2.Add(TKey key, TValue value)
   at RawExplorer.RawObjectDictionary.add(RawObject obj)
   at RawExplorer.RawLibrary..ctor(String rawDirectory)
Just to be clear, I should be selecting the "raw" folder when I load it up, not the main dwarf fortress folder or the raw/objects folder, right?

Correct.  I'll run it on my local copy of IronHand and see what happens.

*UPDATE*
It ran fine on the new Iron Hand set for me.  My best guess at this point is that point is that you have a duplicate object in your raws someplace.  I'll be adding better checks for this kind of thing in the future.  At the moment if it encounters anything unexpected it blows up badly.

If you zip up your raws and send them to bradley.uffner@gumpstudio.com I'll take a look.  It can't hurt to have a set of custom raws for me to test against anyway.

[RadHazard]

There you go, sent 'em to ya.

[BradUffner]

There you go, sent 'em to ya.

I ran the program against the raws you sent me and I didn’t get any errors.  I may have already fixed the bug while doing general work on the program.  One thing that I did see was that some of the raw files have an incorrect filename marker.  According to the wiki the first line of each raw file needs to match the filename of the file without the extension.  Several of the raws that you sent me have the wrong values. Specifically creature_vlk.txt, creature_varulf.txt, reaction_vlk.txt, and others.  I don’t know if this is an actually something that the game checks or uses, but I thought that I would mention it since they aren't strictly following the format.

Thanks for supplying me with a new set of data to test against.

[RadHazard]

Haha, facepalm. That's what I get for copying and pasting files and editing them, without actually checking them for errors.

[BigD145]

Search and comparing two or more files would be handy for most, I'm sure.