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"
Jump to navigation
Jump to search
(→Linux) |
|||
| Line 28: | Line 28: | ||
* Remove the {{tt|hack}} folder from your DF folder. | * Remove the {{tt|hack}} folder from your DF folder. | ||
** If [[Stonesense]] is installed, also remove the {{tt|stonesense}} folder. | ** If [[Stonesense]] is installed, also remove the {{tt|stonesense}} folder. | ||
| − | ** If [http://dwarffortresswiki.org/index.php/DF2014:Utilities#Isoworld Isoworld] is installed, also | + | ** If [http://dwarffortresswiki.org/index.php/DF2014:Utilities#Isoworld Isoworld] is installed, also remove the {{tt|isoworld}} folder. |
* Remove the {{tt|dfhack.init}} and {{tt|dfhack.init-example}} files if they exist. | * Remove the {{tt|dfhack.init}} and {{tt|dfhack.init-example}} files if they exist. | ||
| + | * Remove residual log files that may remain such as dfhack.history, tiletypes.history, liquids.history, ss_fix.log, stderr.log, stdout.log | ||
* On Windows, remove {{tt|SDL.dll}} and rename {{tt|SDLreal.dll}} to {{tt|SDL.dll}}. | * 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. | * On Linux and OS X, remove the {{tt|dfhack}} and {{tt|dfhack-run}} scripts. | ||
Revision as of 23:26, 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.
Note: a dfhack package is available to Arch users at the AUR. A dfhack port is also available to Gentoo users.
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.
- If Isoworld is installed, also remove the isoworld folder.
- Remove the dfhack.init and dfhack.init-example files if they exist.
- Remove residual log files that may remain such as dfhack.history, tiletypes.history, liquids.history, ss_fix.log, stderr.log, stdout.log
- On Windows, remove SDL.dll and rename SDLreal.dll to SDL.dll.
- On Linux and OS X, remove the dfhack and dfhack-run scripts.