SDK for making Don't Starve Together mods.
The story is always the same...
As I was making a few mods for the game, the amount of code that could be reused has kept growing. The maintenance cost has increased, and the feeling of writing the same solutions has popped into my head more frequently. So, I've made a separate repository to store all the existing solutions and wrap it in an SDK.
I don't know what final form this project ends up with. At this stage I have no aim in covering everything and just planning to extend it based on my own needs. However, even though I don't think that this project will be useful to anyone else, you can open an issue or a pull request to extend it. I appreciate any contributions!
- Blameability: you can always blame this project instead of your own code
- Modularity: use only what you need
- Reusability: write less and stop "reinventing the wheel"
- Stability: no one seems insane enough to write tests for mods
- Bloatedness: your solution can end up much smaller
First, this project is still in active development, so I can't guarantee anything at this stage. But if you are one of those who enjoys living on the verge and has decided to try it out, then it could be done in 3 steps:
Step 1/3. Clone it into your unique mod subdirectory:
git submodule add https://github.com/dstmodders/mod-sdk \
scripts/<your subdirectory>/sdk --name sdkStep 2/3. Require and load it is your modmain.lua:
local SDK = require("<your subdirectory>/sdk/sdk/sdk").Load(env, "<your subdirectory>/sdk")Step 3/3. Start using it directly in your modmain.lua or in any other file
by requiring it:
local SDK = require "<your subdirectory>/sdk/sdk/sdk"
dumptable(SDK.Entity.GetTags(ThePlayer))To learn more, explore the usage.
NB! Not all features are covered yet.
The whole SDK comprises modules and submodules with different functionality:
NB! The mentioned mods are currently in the process of migration to SDK.
Check out their sdk branches first.
The best way to see if this project is worth it, check out my following mods which use this SDK:
Or you could explore the documentation as some functions may have usage examples.
The LDoc documentation generator has been used for generating documentation, and the most recent version can be found here: https://docs.dstmodders.com/sdk/
Released under the MIT License.