How To Mod

How to download and apply mods for Stoneshard.

Steam Betas

The first thing you need to do when you want to mod the game is to change it to its moddable version by following those steps:

1. Right click the game in your library.
   
2. Click "Properties".
   
3. Click "Betas" in the new window.
   
4. And lastly, select the "modbranch" beta.

This is a game version that uses a different compiler then the main game. It means that the game will run a little bit less smooth but will also allow us to mod the game!

Where to Find Mods

There are two main places where you can find mods to download from: Nexus, and the modding discord server.

To download a mod you need to get your hands on a file with the suffix ".sml", this means it was created using MSL (or ModShardLuancher) which is the "modern" tool for creating mods for Stoneshard.

Nexus Catalogue

Here[www.nexusmods.com] you can find the nexus site for Stoneshard, nexus is a site that hosts mods for a lot of different games, it is very convenient because you can filter by popularity and downloads numbers, once you chose a mod you want to download.

Once you entered to the page of the mod you want to download, before you continue and download the mod, I suggest you go and read the main page of the mod.

After that, you can click either "Download: Manual" or "Files to take you to the same page.
From there, you can find the mod author might have put multiple files to download, if so, make sure you preview and choose the one that contain an .sml suffix and click "Manual Download".

Discord Catalogue

If you haven't already, you should join our Modding Discord Server[discord.gg], there, you can find a channel named "mods-catalogue".

Some creators choose to upload their mods there, some to nexus, and some to both, so it is important to check both if you are just interested in seeing what our community have to offer.

Some just put here a link to the mod nexus page while some other choose to put a link to a GitHub page of their mod.



And again, remember to download the file with the .sml suffix!

MSL - ModShardLuancher

We are lucky enough that we got some brilliant minds in our community that made our own modding support.

Most of the mods from the past year have been made using our tool named MSL (ModShardLuancher) and also "applied" to the game with the same tool.

You can download MSL from Here[github.com], you only need to download msl.zip.

Unzip it wherever you want, inside the folder, there are only two things you care about.
The "mods" folder, and "ModShardLauncher.exe" of couse.
All the mods you have downloaded you put inside the mods folder. Pretty strait forward.

Now, before you open MSL, there is another thing you need to do.
Open your game files, they are usualy located at \SteamLibrary\steamapps\common\Stoneshard
There you will find a file namde "data.win", it basicly contains all of the game. you need to want to copy and rename it. While it does not matter what you name it to, you should make sure you can distinguish them as an unmodded and a modded one.

Now you can open MSL, click the anvil icon, then you will see all the mods you have downloaded.
Click the folder icon on top, then choose, in your game files, the vanilla data.win file.
From now you need to enable all the mods you want to install, and click on the save icon, and save on the modded data.win file.

Now all that left is opening the game! the game might ask you to choose a file when you do, if so, choose the modded data.win file.
Enjoy!

[FmoomooL]

now working even if it say loaded it will still be stucked and when open the game it justthe vanilla game

[Torgrim]

This mod is indispensable. I don't know why it isn't included in the game. Thanks for creating it. I hope the developers add it to the base game.

[>華想<]

Why after I use it, it only shows「may not be vanilla or is a new version」and then crash

[iamyoyoman]

yes, now it works

[Kalder (Totally a Hobb)]

Does this still work?

[BornSvg]

im not trying to be a downer here but few thigns i'd like to mention.
1. downloading updates to mods will require full downloads of new mods, as theres no updater software for these kinds of additions.
2. mods will almost certainly be broken with every new patch because the dev does so much everytime. i miss random generated maps because they were the spawn of evil incarnate every goddam time and it made sense because its evil that must be swept from the land of aldor.
3. mods likely wont have an inkling about upcoming changes to the game, so they will be trying to balance mods with the new content and new changes.
4. game is pretty much a very good and in depth game as it is. especially with random dungeons layout still available.

[iamyoyoman]

yep @gm-nonname , the devs have changed the compiler.

[gm-noname]

Not working for 0.9.1 update...

[Jiaz Jiaz]

Need Help, it crash everytime I want to load, and says something about inconsistencies on vanilla, and is not vanilla