718
edits
Modding:Creating a Workshop Mod: Difference between revisions
Jump to navigation
Jump to search
m
Modding:Creating a Workshop Mod (view source)
Revision as of 05:57, 26 October 2023
, 05:57, 26 October 2023Add some info about ImagePath
mNo edit summary |
Kernelmethod (talk | contribs) m (Add some info about ImagePath) |
||
| (One intermediate revision by the same user not shown) | |||
| Line 11: | Line 11: | ||
# Click the Upload Content... button. The contents of your mod folder will be uploaded. | # Click the Upload Content... button. The contents of your mod folder will be uploaded. | ||
# Now users can Subscribe to your mod in Steam and restart Caves of Qud and get your mod content! | # Now users can Subscribe to your mod in Steam and restart Caves of Qud and get your mod content! | ||
==Structure of workshop.json== | |||
The <code>workshop.json</code> configuration file contains the Steam Workshop configuration for your mod. Here's an example of what such a file might look like: | |||
<syntaxhighlight lang="json"> | |||
{ | |||
"WorkshopId": 2995934012, | |||
"Title": "Snapjaw Mages", | |||
"Description": "[h1]Snapjaw Mages[/h1]\n\nThis mod adds the new [b]Snapjaw Mage[/b] creature to Caves of Qud.", | |||
"Tags": "Creatures", | |||
"Visibility": "2", | |||
"ImagePath": "Preview.png" | |||
} | |||
</syntaxhighlight> | |||
Usually you don't need to modify this file manually, and you can just use the workshop uploader tool built into the game. Nonetheless, it can be helpful to know what each of these fields mean: | |||
* '''WorkshopId:''' an ID that uniquely identities your mod. When you first go to the workshop uploader in your game to upload your mod, you should get a screen like the one below which will automatically create a workshop ID for you. | |||
[[File:Snapjaw_Mages_--_workshop_uploader.webp|700px]] | |||
* '''Title:''' the name of your mod as it appears in the Steam Workshop. | |||
* '''Description:''' your mod's description. You can format this text (e.g. bolden, italicize, add headers, etc.) by following the text formatting guidelines described [https://steamcommunity.com/comment/Recommendation/formattinghelp here]. | |||
[[File:Snapjaw Mages -- workshop uploader description.webp|500px]] | |||
* '''Tags:''' one or more categories that your mod falls under, separated by commas (for instance, <code>"World,Settlement"</code>). You can define your own tags but if at all possible, try to use some of the same tags used by items currently in the [https://steamcommunity.com/workshop/about/?appid=333640 Caves of Qud workshop] so that it's easier for people to find your mod. | |||
* '''Visibility:''' defines who's able to see your mod in the workshop. 0 means that the mod is private, 1 means that it's friends-only, and 2 means that it's public. You can change this by setting "Visibility" in the workshop uploader. | |||
[[File:Snapjaw Mages -- workshop uploader visibility.webp|500px]] | |||
* '''ImagePath:''' the path (relative to the mod directory) to the image that should be used as the preview image for the mod. | |||
==Notes== | ==Notes== | ||