v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Utility:Tweak

From Dwarf Fortress Wiki
Revision as of 21:34, 12 June 2014 by Lethosor (talk | contribs) ({{uv}})
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
This utility page is about v0.28.121.40d, an older version of DF.

Tweak is obsolete, and its functions are now provided through DFHack.

Dwarf Fortress Tweak.png

Tweak is a utility for Dwarf Fortress created by Rick which can load modules that provide different functionality to the user for tweaking, or editing Dwarf Fortress memory. It will attempt to automatically identify the version of the running Dwarf Fortress process and automatically load data related to that version.

It is written in C# and requires the .NET 3.5 Runtime, as well as the .net 2.0 as well as the .net 1.1 SEPARATELY installed.

There are many modules - both written by myself and others.

Installing Tweak

Tweak does not have an installer, but it does have several directories and many files within them, so it is suggested not to directly extract to your Dwarf Fortress directory, if it must, I would suggest putting it in a subdirectory named 'tweak' or equivilent.

The ZIP file for Tweak comes with everything in the tweak directory to make this easier.

Updating Tweak for a new version of Dwarf Fortress

To update Gibbed's Utilities for a new version of DF:

  1. Download, install and launch the Utilities, if not already done so.
  2. Open versions.xml in Notepad.
  3. Copy the last line in the <versions> section to a new line below it. The last two lines of the <versions> section should now be identical.
  4. On the new line you just created, change the version number to match the version of DF you have installed. Delete the "hash" value.
  5. In the "Versions" sub folder of the "tweak" folder, create a new folder with the exact same name as the version number you just typed into versions.xml.
  6. Go to Dwarvis' Page and download the core.xml that matches your version of DF. Save it to the folder you just created, and rename it to "core.xml"
  7. Open a new Notepad window
  8. Bring up Gibbed's utilities, and under the File menu, click "Select Process". Click yes on the confirmation.
  9. When asked if you want to look up the hash, click "No."
  10. Under the Tools menu, click "Log"
  11. Right-click in the Log window, and choose Copy All.
  12. Paste the log in the blank Notepad window.
  13. On the line that starts with "Verbose: Selected game with process ID" (Should be the second to last line) copy the hash value without the leading space or trailing period.
  14. Paste the hash value into the blank spot on the last line of the <versions> section in versions.xml.
  15. Save and close versions.xml
  16. Close the Untitled Notepad window.
  17. Close the Log window.
  18. Close Gibbed's Utilities.
  19. Relaunch Gibbed's Utilities.
  20. Under the File menu, click "Select Process" and click yes on the confirmation.
  21. All the circles next to the items in the list should turn red. You are now ready to go!

Core Modules

For more details on Core Modules see the Core Modules article.

  • Adjust Profile - Allows editing of the skills for starting dwarves in the prepare screen.
  • Adjust Start - Allows editing of starting dwarf count and starting points.
  • Enable Magma Buildings - Enables magma buildings.
  • Heal - Heal or hurts a creature.
  • Lookup Addresses - Pattern scanning for finding addresses in new versions of Dwarf Fortress.
  • Resume - Resumes a stuck process.
  • Reveal - Reveals all allocated tiles on the map.
  • Tile Edit - Edit nearly all properties of a selected tile.
  • Warp - Warp a creature to another location.

Installing modules

Todo: But pretty much you just drop the files from the plugin into directory Tweak is installed to.

Get more modules

Looking for more modules? You can likely find more in the Tweak Modules category.

Download Tweak

Requires .NET 3.5 Runtime!

The current version of Tweak is 1.2.0.1. See the changelog for detailed information on changes since last version.

Mirrors to download Tweak 1.2.0.1 from

Found a bug? Have a suggestion?

Report it on the talk page!

XML files? Developing modules?

See the development article for more details.