mirror of
https://github.com/Ellpeck/TinyLifeExampleMod.git
synced 2024-11-26 05:28:34 +01:00
docs and run script
This commit is contained in:
parent
8db379cf51
commit
f058b20253
3 changed files with 39 additions and 5 deletions
|
@ -5,10 +5,10 @@
|
||||||
</PropertyGroup>
|
</PropertyGroup>
|
||||||
|
|
||||||
<ItemGroup>
|
<ItemGroup>
|
||||||
<PackageReference Include="ExtremelySimpleLogger" Version="1.1.0"/>
|
<PackageReference Include="ExtremelySimpleLogger" Version="1.1.0" />
|
||||||
<PackageReference Include="MLEM.Data" Version="4.3.0-7"/>
|
<PackageReference Include="MLEM.Data" Version="4.3.0-7" />
|
||||||
<PackageReference Include="TinyLifeApi" Version="1.0.0"/>
|
<PackageReference Include="TinyLifeApi" Version="1.0.0" />
|
||||||
<PackageReference Include="MonoGame.Framework.DesktopGL" Version="3.8.0.1641"/>
|
<PackageReference Include="MonoGame.Framework.DesktopGL" Version="3.8.0.1641" />
|
||||||
</ItemGroup>
|
</ItemGroup>
|
||||||
|
|
||||||
<ItemGroup>
|
<ItemGroup>
|
||||||
|
|
24
README.md
24
README.md
|
@ -1,2 +1,24 @@
|
||||||
# TinyLifeExampleMod
|
# 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
12
Run.sh
Normal 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"
|
Loading…
Reference in a new issue