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.

Difference between revisions of "Utility:Tweak"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
({{uv}})
 
(16 intermediate revisions by 10 users not shown)
Line 1: Line 1:
[[Category:Hacking]][[Category:Utilities]]
+
{{Quality|Superior|01:30, 29 September 2013 (UTC)}}
=Gibbed's Dwarf Fortress Tweak=
+
{{uv|40d}}
 +
'''Tweak is obsolete, and its functions are now provided through [[utility:DFHack|DFHack]].'''
  
 
[[Image:Dwarf Fortress Tweak.png|right]]
 
[[Image:Dwarf Fortress Tweak.png|right]]
Line 6: Line 7:
 
Tweak is a utility for Dwarf Fortress created by [[User:Rick|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.
 
Tweak is a utility for Dwarf Fortress created by [[User:Rick|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 [http://www.microsoft.com/downloads/details.aspx?FamilyID=10CC340B-F857-4A14-83F5-25634C3BF043 .NET 3.0 Runtime].
+
It is written in C# and requires the [http://www.microsoft.com/downloads/details.aspx?FamilyID=333325FD-AE52-4E35-B531-508D977D32A6 .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.
 
There are many modules - both written by myself and others.
Line 18: Line 19:
 
==Updating Tweak for a new version of Dwarf Fortress==
 
==Updating Tweak for a new version of Dwarf Fortress==
  
Tweak still uses a similar system that my old tools did with memory.ini -- there is no pattern scanning in the core address and offset definitions. This is because I consider pattern scanning to be a bit slow, and there isn't a need to have it scan every time you open Tweak when the addresses are the same. I do however, provide a module called '''Lookup Addresses''' which can load an XML file which has definitions and patterns.
+
To update Gibbed's Utilities for a new version of DF:
 +
 
 +
# Download, install and launch the Utilities, if not already done so.
 +
# Open versions.xml in Notepad.
 +
# 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.
 +
# On the new line you just created, change the version number to match the version of DF you have installed.  Delete the "hash" value.
 +
# 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.
 +
# Go to [http://www.geocities.com/jifodus/tables/dwarvis/ 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"
 +
# Open a new Notepad window
 +
# Bring up Gibbed's utilities, and under the File menu, click "Select Process".  Click yes on the confirmation.
 +
# When asked if you want to look up the hash, click "No."
 +
# Under the Tools menu, click "Log"
 +
# Right-click in the Log window, and choose Copy All.
 +
# Paste the log in the blank Notepad window.
 +
# 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.
 +
# Paste the hash value into the blank spot on the last line of the <versions> section in versions.xml.
 +
# Save and close versions.xml
 +
# Close the Untitled Notepad window.
 +
# Close the Log window.
 +
# Close Gibbed's Utilities.
 +
# Relaunch Gibbed's Utilities.
 +
# Under the File menu, click "Select Process" and click yes on the confirmation.
 +
# All the circles next to the items in the list should turn red.  You are now ready to go!
  
 
==Core Modules==
 
==Core Modules==
Line 25: Line 48:
 
*[[User:Rinn/AdjustProfile|Adjust Profile]] - Allows editing of the skills for starting dwarves in the prepare screen.
 
*[[User:Rinn/AdjustProfile|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.
 
*Adjust Start - Allows editing of starting dwarf count and starting points.
 +
*Enable Magma Buildings - Enables magma buildings.
 
*Heal - Heal or hurts a creature.
 
*Heal - Heal or hurts a creature.
 
*Lookup Addresses - Pattern scanning for finding addresses in new versions of Dwarf Fortress.
 
*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.
 
*Reveal - Reveals all allocated tiles on the map.
 
*[[User:Rick/Tweak/Tile_Edit|Tile Edit]] - Edit nearly all properties of a selected tile.
 
*[[User:Rick/Tweak/Tile_Edit|Tile Edit]] - Edit nearly all properties of a selected tile.
Line 41: Line 66:
 
==Download Tweak==
 
==Download Tweak==
  
'''Requires [http://www.microsoft.com/downloads/details.aspx?FamilyID=10CC340B-F857-4A14-83F5-25634C3BF043 .NET 3.0 Runtime]!'''
+
'''Requires [http://www.microsoft.com/downloads/details.aspx?FamilyID=333325FD-AE52-4E35-B531-508D977D32A6 .NET 3.5 Runtime]!'''
  
The current version of Tweak is '''1.1.0.0'''.
+
The current version of Tweak is '''1.2.0.1'''. See the [[User:Rick/Tweak/Changelog|changelog for detailed information on changes since last version]].
  
*[http://dffd.wimbli.com/file.php?id=74 Download Tweak 1.1.0.0]
+
'''Mirrors to download Tweak 1.2.0.1 from'''
 +
*[http://dffd.wimbli.com/file.php?id=666 From Dwarf Fortress File Depot] - updated with offsets for DF 0.28.181.40d
 +
*[http://dffd.wimbli.com/file.php?id=74 From Dwarf Fortress File Depot] - Please try this one first, if it doesn't work use another one.
 +
*[http://df.pipboy.us/tweak/tweak_1201.zip df.pipboy.us]
  
 
==Found a bug? Have a suggestion?==
 
==Found a bug? Have a suggestion?==
Line 54: Line 82:
  
 
[[User:Rick/Tweak/Development|See the development article for more details]].
 
[[User:Rick/Tweak/Development|See the development article for more details]].
 +
[[Category:Tweak]][[Category:Hacking|Tweak]][[Category:Utilities]]

Latest revision as of 21:34, 12 June 2014

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[edit]

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[edit]

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[edit]

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[edit]

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

Get more modules[edit]

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

Download Tweak[edit]

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?[edit]

Report it on the talk page!

XML files? Developing modules?[edit]

See the development article for more details.