Pixi/README.md

35 lines
1.7 KiB
Markdown
Raw Normal View History

2020-05-09 00:30:31 +00:00
# Pixi
2020-05-09 00:11:37 +00:00
2020-05-09 00:30:31 +00:00
Gamecraft mod for converting images into coloured blocks.
Think of it like automatic pixel art.
2020-05-09 00:11:37 +00:00
2020-05-09 00:30:31 +00:00
## Installation
To install the Pixi mod, copy the build's `Pixi.dll` into the `Plugins` folder in Gamecraft's main folder.
## Development
Show your love by offering your time.
### Setup
Pixi's development environment is similar to most Gamecraft mods, since it's based on HelloModdingWorld's configuration.
2020-05-09 00:11:37 +00:00
This project requires most of Gamecraft's `.dll` files to function correctly.
Most, but not all, of these files are stored in Gamecraft's `Gamecraft_Data\Managed` folder.
The project is pre-configured to look in a folder called ref in the solution's main directory or one level up from that.
2020-05-09 00:30:31 +00:00
You can make sure Pixi can find all of `.dll` files it needs by copying your Gamecraft folder here and renaming it to `ref`, but you'll have to re-copy it after every Gamecraft update.
2020-05-09 00:11:37 +00:00
You can also create a symbolic link (look it up) to your Gamecraft install folder named `ref` in this folder to avoid having to re-copy files.
2020-05-09 00:30:31 +00:00
Like most mods, you will have to patch your game with [GCIPA](https://git.exmods.org/modtainers/GCIPA).
Pixi also requires the [GamecraftModdingAPI](https://git.exmods.org/modtainers/GamecraftModdingAPI) library to be installed (in `ref/Plugins/GamecraftModdingAPI.dll`).
2020-05-09 00:11:37 +00:00
## Building
2020-05-09 00:30:31 +00:00
After you've completed the setup, open the solution file `Pixi.sln` in your prefered C# .NET/Mono development environment.
2020-05-09 00:11:37 +00:00
I'd recommend Visual Studio Community Edition or JetBrains Rider for Windows and Monodevelop for Linux.
2020-05-09 00:30:31 +00:00
If you've successfully completed setup, you should be able to build the Pixi project without errors.
2020-05-09 00:11:37 +00:00
If it doesn't work and you can't figure out why, ask for help on [our Discord server](https://discord.gg/xjnFxQV).