MetzNet
/
dfhack
3
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Merge pull request #4133 from myk002/myk_mac 

[installing] add installation instructions for wineskin on mac
develop
Myk 2024-01-03 14:59:45 -08:00 committed by GitHub
parent b7c64da235 2393e8f73b
commit 8816286614
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 21 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
docs/Installing.rst
Unescape Escape View File

@ -22,7 +22,7 @@ releases *never* support newer versions of DF -- DFHack requires data about DF
that is only possible to obtain after DF has been released. Occasionally, that is only possible to obtain after DF has been released. Occasionally,
DFHack releases will be able to maintain support for older versions of DF - for DFHack releases will be able to maintain support for older versions of DF - for
example, DFHack 0.34.11-r5 supported both DF 0.34.11 and 0.34.10. For maximum example, DFHack 0.34.11-r5 supported both DF 0.34.11 and 0.34.10. For maximum
stability, you should usually use the latest versions of both DF and DFHack. stability, you should use the latest versions of both DF and DFHack.
.. _downloading: .. _downloading:
@ -60,7 +60,8 @@ Beta releases
In between stable releases, we may create beta releases to test new features. In between stable releases, we may create beta releases to test new features.
These are available via the ``beta`` release channel on Steam or from our These are available via the ``beta`` release channel on Steam or from our
regular Github page as a pre-release tagged with a "beta" or "rc" suffix. regular Github page as a pre-release tagged with a "beta" or "rc" ("release
candidate") suffix.
Development builds Development builds
------------------ ------------------
@ -104,6 +105,23 @@ among other things. Some redistributions of Dwarf Fortress may place DF in
another folder, so ensure that the ``hack`` folder ends up next to the ``data`` another folder, so ensure that the ``hack`` folder ends up next to the ``data``
folder, and you'll be fine. folder, and you'll be fine.
Installing into a wineskin on Mac
---------------------------------
Until DF (and DFHack) is natively available for Mac, you'll have to run the
Windows version under emulation. Here are the instructions for adding DFHack to
a wineskin that has DF installed in it:
#. Find the location of your existing Dwarf Fortress app (default is
``/user/applications/Wineskin/``). Control + click and select "Show package
contents" from the menu.
#. Find the location of the ``Dwarf Fortress`` folder inside the package
contents (default is ``/drive_c/Program Files/``)
#. Copy the contents of the unzipped DFHack folder (Windows versino) into the
``Dwarf Fortress`` folder inside the package.
These instructions were last tested on Mac Sonoma 14.1.2.
Uninstalling DFHack Uninstalling DFHack
=================== ===================

1
docs/changelog.txt
Unescape Escape View File

@ -68,6 +68,7 @@ Template for new versions:
- `work-now`: now saves its enabled status with the fort - `work-now`: now saves its enabled status with the fort
## Documentation ## Documentation
- `installing`: Add installation instructions for winskin on Mac
- UTF-8 text in tool docs is now properly displayed in-game in `gui/launcher` (assuming that it can be converted to cp-437) - UTF-8 text in tool docs is now properly displayed in-game in `gui/launcher` (assuming that it can be converted to cp-437)
- `modding-guide`: Add examples for script-only and blueprint-only mods that you can upload to DF's Steam Workshop - `modding-guide`: Add examples for script-only and blueprint-only mods that you can upload to DF's Steam Workshop