An example mod for my game Tiny Life. Use this template repository to create your own mod!
Find a file
2020-11-25 02:00:47 +01:00
Content/ExampleMod added the ability for modded localization 2020-11-25 01:39:41 +01:00
.gitignore modding, part 1! 2020-11-25 00:33:47 +01:00
CustomTable.cs modding, part 1! 2020-11-25 00:33:47 +01:00
ExampleMod.cs added the ability for modded localization 2020-11-25 01:39:41 +01:00
ExampleMod.csproj update some libraries 2020-11-25 02:00:47 +01:00
README.md update some libraries 2020-11-25 02:00:47 +01:00
Run.sh added the ability for modded localization 2020-11-25 01:39:41 +01:00

TinyLifeExampleMod

An example mod for my game Tiny Life. Fork this repository if you make a mod so people can easily find it!

Installing Mods

Installing a mod is pretty simple:

  • Find the Tiny Life folder in your local app data (On Windows, just type %localappdata% into your search)
  • Find the Mods folder in there
  • If you received the mod you want to install as a zip (or any other kind of) archive, extract it first
  • Put the mod's dll as well as its Content folder into the Mods folder.

Done! Now just start the game and the mod should automatically load. If there are any errors, they'll be logged in the Log.txt file in the Tiny Life folder.

Creating Mods

To create a mod, all you have to do is fork this repository and open the project contained in it using Visual Studio, Rider or any other kind of C# IDE. The code that is already there contains some examples. Once you're done checking them out, you can just delete them and start fresh.

Since Tiny Life uses early versions of some of my libraries, you will also have to add my server to your NuGet config. You can do so using the following command:

nuget sources Add -Name "Ellpeck" -Source https://nuget.ellpeck.de/

This repository also contains a little script called Run.sh that you can use to automatically build your mod, copy it into the Mods directory of your Tiny Life instance and run the game. Just be sure to modify all of the paths first.

Note that there is no proper modding API right now, so you can pretty much do anything you want. You can look around in the reference code to see what there is to add and change.

Distributing mods

To distribute your mod to other people, all you have to do is go into the bin/Debug/netcoreapp3.0 folder after building and copy your mod's dll and the Content directory. You can either send them to your friends directly or pack them into an archive first.

Updating mods

To change the version of Tiny Life that your mod is compiled against, simply go into the csproj file and change the TinyLifeApi version.

Where's the source code?

The NuGet package for the Tiny Life API just contains a reference assembly so that people can't just download the game from NuGet and play it. If you want to see the game's full source code, all you have to do is open the Tiny Life.dll that you downloaded on itch in your IDE.