Dwarf Fortress

Dwarf Fortress

Not enough ratings
Quick Mod Upload Guide
By A Nickel
Quick and dirty guide for uploading mods to Steam Workshop.
   
Award
Favorite
Favorited
Unfavorite
How to Upload
Feel like an idiot like I did? No worries! I smashed my head on the keyboard trial and error until I figured this out.

Make your edits to the files you need.

Take those files and place them into an "objects" or "graphics" folder (or both if you have graphics with your mod)

Make a separate folder for your mod, call it whatever the name of your mod is: "ExampleMod"

Place "ExampleMod" into mod_upload located at: Dwarf Fortress\mods\mod_upload

Make a text file called info.txt

Fill out the information inside:

(I'm using my mod as an example of how yours should look)

[ID:foreign_equipment_smithing]
[NUMERIC_VERSION:1]
[DISPLAYED_VERSION:1]
[EARLIEST_COMPATIBLE_NUMERIC_VERSION:1]
[EARLIEST_COMPATIBLE_DISPLAYED_VERSION:1]
[AUTHOR:ANickel]
[NAME:Foreign Equipment Smithing]
[DESCRIPTION:Allows your dwarves to unravel the secrets of crafting foreign weaponry such as scimitars, halberds and blowdarts]

[STEAM_TITLE:Foreign Equipment Smithing]
[STEAM_DESCRIPTION:Allows your dwarves to unravel the secrets of crafting foreign weaponry such as scimitars, halberds and blowdarts]
[STEAM_TAG:mod]
[STEAM_TAG:weapon]

Go ahead and save that file, boot up Dwarf Fortress and select the "Mod" tab, click on "Publish" and you should be good to go.

The file structure stumped me the most, so I'll leave it here as an example!

Dwarf Fortress\mods\mod_upload\examplemod\objects\modcontentinhere

14 Comments
Upir Feb 8, 2024 @ 1:23pm 
@Pururin sorry for the late answer, the reason you don't see publish button is you have to launch DF from Steam, not from the desktop shortcut. So now you know.
WendyKitten Dec 11, 2022 @ 10:08am 
Awesome guide, thank you so much!

For those wondering, you want to put your smaller, square "thumbnail" up one level from what the image shows, alongside info.txt. It also needs to be named "preview.png". The larger cut, as well as any supporting screenshots or images can be uploaded on the item's workshop page once it's published.
FarSet Dec 9, 2022 @ 8:20am 
How i can create modification?:dummy:
Pururin Dec 8, 2022 @ 9:09pm 
So I subscribed to a random mod from the workshop and the Mod menu appears.

Yet I still can't upload my mod because the Publish button isn't available in the Mod menu.

So frustrating
Pururin Dec 8, 2022 @ 7:45pm 
I have:

Continue active game
Create new world
Settings
About DF
Quit

Am I missing an update? Wheres the mod button :(
Yuubi Dec 8, 2022 @ 7:31pm 
Thank you, i was very confused why i couldn't find the upload button here in the workshop xD
A Nickel  [author] Dec 8, 2022 @ 6:16pm 
It's right on the main menu, it's impossible to miss.
Pururin Dec 8, 2022 @ 3:21pm 
where is the mod tab? I see a mod button if I first go to Create New World but I can't even find the publish button
A Nickel  [author] Dec 7, 2022 @ 7:40pm 
Probably a good thing to ask on the forum, I only do RAW modding, I don't mess with the actual code.
Damp Bees Dec 7, 2022 @ 7:16pm 
Is there an easy way to decompile and view the code of dwarf fortress. I am unfamiliar with cpp processes of decompiling. I think in one of these dll folders lies the answer. Like when it calls and starts to read the raws to put them into memory.