Skip to content

Studded With Patches

Paul edited this page Mar 13, 2014 · 12 revisions

What is this?

Masterwork-DF - Studded With Patches (MWDF-SWP) is an unofficial development branch of Meph's amazing Masterwork Dwarf Fortress, with patches and experimental features applied. It's not intended to replace the official Masterwork releases, and due to the developmental nature of the project, it may actually contain more bugs than the official releases. However the project goal is to provide the community with faster access to Masterwork bugfixes with minimal friction.

How does it differ from official Masterwork DF?

MWDF-SWP contains bugfixes, software upgrades, and experimental features that are not yet in the official Masterwork release. The definitive list can be seen in the commit logs, which show changes are they are made. Note that some changes in that list are to developer tools, and won't be visible to end-users. MWDF-SWP has been the basis of official Masterwork releases, including 4e and 4f

Changes since Masterwork 4g include:

[spoiler]

Latest changes (against 4g)

{% latest-changes %}

[/spoiler]

The unified branch and master branches are currently the same.

Finally, all the changes ever made are:

[spoiler]

{% all-changes %}

[/spoiler]

Downloading

The distribution is updated whenever I apply a patch. There are two downloads I recommend you chose from:

  • The gold release contains all bugfixes and improvements which are considered stable. It is always based upon the most recently release of Masterwork Dwarf Fortress.
  • The beta release (recommended) is the same as the gold release, but with additional changes which are not yet considered completely stable. Things don't get placed into beta until we're pretty sure they work, so it's recommended for most users, but occasionally things will still be a bit rough around the edges.

Both downloads are based on the latest release of Masterwork, and both include an updated release of Dwarf Therapist.

There's also a release for the very, very brave, but if it's broken, you can't complain. ;)

[spoiler]

  • The alpha release is the same as the beta release, but also includes experimental features and bugfixes. Things here may be completely broken, but you're welcome to try it if you like.
  • alpha release (patches only)

[/spoiler]

If you already have the latest release of Dwarf Fortress, you can download patch files which should update your distributions to the Studded With Patches versions of the files. These are automatically generated, and are not guaranteed to work. If in doubt, use the zips above.

Contributing

MWDF-SWP is hosted on github, so you'll want to get yourself a github account, which only takes a few seconds.

The SWP Contributor's Guide is a wiki page which contains information on how to report bugs, contribute patches, and other useful information. If you feel it's missing something, then please add it.

Thanks

Super-thanks goes to Meph, and all the Masterwork contributors, for making such an amazing mod. Special thanks to Meph again, for giving me permission to publicly host a development branch to solicit bugfixes and improvements. Thanks goes to thistleknot, for being consistently encouraging in my efforts. ;) Thanks to Putnam, for integrating DFHack r4! Thanks to Splinterz, for the new settings manager! Thanks to Falconne, for all the updated DFHack plug-ins! And a big thank you goes to you, for testing and contributing!


This top-post is generated automatically! You can edit it in markdown format if you think it's missing something. Be bold with your edits, they're easy to undo!

Note: Modifying this page will also modify the top-post of the relevant post in the Dwarf Fortress forums. It's easy for us to roll-back bad changes, so be bold with your edits.

Unfortunately, we have a bug involving Unicode characters. Please use them sparingly, if at all.

Clone this wiki locally