docs and run script

This commit is contained in:
Ell 2020-11-25 00:57:25 +01:00
parent 8db379cf51
commit f058b20253
3 changed files with 39 additions and 5 deletions

View file

@ -5,10 +5,10 @@
</PropertyGroup>
<ItemGroup>
<PackageReference Include="ExtremelySimpleLogger" Version="1.1.0"/>
<PackageReference Include="MLEM.Data" Version="4.3.0-7"/>
<PackageReference Include="TinyLifeApi" Version="1.0.0"/>
<PackageReference Include="MonoGame.Framework.DesktopGL" Version="3.8.0.1641"/>
<PackageReference Include="ExtremelySimpleLogger" Version="1.1.0" />
<PackageReference Include="MLEM.Data" Version="4.3.0-7" />
<PackageReference Include="TinyLifeApi" Version="1.0.0" />
<PackageReference Include="MonoGame.Framework.DesktopGL" Version="3.8.0.1641" />
</ItemGroup>
<ItemGroup>

View file

@ -1,2 +1,24 @@
# TinyLifeExampleMod
An example mod for my game Tiny Life. Clone this repository if you make a mod so people can easily find it!
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.
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.
## Where's the source code?
The NuGet package for the Tiny Life API just contains a [reference assembly](https://docs.microsoft.com/en-us/dotnet/standard/assembly/reference-assemblies) 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](https://ellpeck.itch.io/tiny-life) in your IDE.

12
Run.sh Normal file
View file

@ -0,0 +1,12 @@
#!/bin/bash
GAME_DIR="path/to/Tiny Life"
# build the mod
dotnet build
# copy the mod to the mods folder
cp ./bin/Debug/netcoreapp3.0/* "$LOCALAPPDATA/Tiny Life/Mods" -r
# run the game
cd $GAME_DIR
"./Tiny Life.exe"