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:DFHack/Installation"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(split to subpage)
 
(+uninstallation, formatting)
Line 21: Line 21:
 
===Pre-bundled packages===
 
===Pre-bundled packages===
 
Most [[Utility:Lazy Newb Pack|recent starter packs]] include DFHack pre-installed; simply run Dwarf Fortress as usual. Note that every DF update will break existing DFHack versions; if a DF release is very recent, the DFHack team may not have had the time to update it to the latest DF version, and the latest starter packs may not include it.
 
Most [[Utility:Lazy Newb Pack|recent starter packs]] include DFHack pre-installed; simply run Dwarf Fortress as usual. Note that every DF update will break existing DFHack versions; if a DF release is very recent, the DFHack team may not have had the time to update it to the latest DF version, and the latest starter packs may not include it.
 +
 +
==Uninstallation==
 +
 +
* Remove the {{tt|hack}} folder from your DF folder.
 +
** If Stonesense is installed, also remove the {{tt|stonesense}} folder.
 +
* Remove the {{tt|dfhack.init}} and {{tt|dfhack.init-example}} files if they exist.
 +
* On Windows, remove {{tt|SDL.dll}} and rename {{tt|SDLreal.dll}} to {{tt|SDL.dll}}.
 +
* On Linux and OS X, remove the {{tt|dfhack}} and {{tt|dfhack-run}} scripts.

Revision as of 20:56, 11 September 2014

Installation

DFHack works on Windows XP, Vista, 7, most modern Linux distributions, and OS X 10.6 and later. On Windows, only the SDL version of DF is supported.

Windows

  • Get the archive meant for your system. Extract the contents into your DF folder. Be sure to erase the SDL.dll file with the downloaded one, as it's used by DFHack to operate its magic.
  • You're ready to use DFHack. Simply run Dwarf Fortress.exe and you should see a separate command-line prompt window.

OS X

  • Get the archive meant for your system. Extract the contents into your DF folder.
  • Run 'dfhack' in a terminal. Dwarf Fortress should start and the terminal be taken over and turned into a DFHack prompt.

Linux

  • Get the archive meant for your system and your current gcc version. If you're not sure, try the latest version first (4.9.2 as of September 2014) before trying downgraded versions.
  • Run 'dfhack' in a terminal. Dwarf Fortress should start and the terminal be taken over and turned into a DFHack prompt.

Pre-bundled packages

Most recent starter packs include DFHack pre-installed; simply run Dwarf Fortress as usual. Note that every DF update will break existing DFHack versions; if a DF release is very recent, the DFHack team may not have had the time to update it to the latest DF version, and the latest starter packs may not include it.

Uninstallation

  • Remove the hack folder from your DF folder.
    • If Stonesense is installed, also remove the stonesense folder.
  • Remove the dfhack.init and dfhack.init-example files if they exist.
  • On Windows, remove SDL.dll and rename SDLreal.dll to SDL.dll.
  • On Linux and OS X, remove the dfhack and dfhack-run scripts.