CloverAPI
API for CloverPit
About this mod Author’s original text
CloverPit API
API for CloverPit
For Mod Users
You can find the Clover API:
- CloverAPI
Automatic Installation
Just search for "CloverAPI" in one of these mod managers and install it like any other mod:
- r2modman
- Mod Manager
Manual Installation
Download the latest release or GitHub and place the DLL in your BepInEx/plugins folder like any other mod.
The API doesn't do anything on its own, so you'll need to install mods that use it to see any effect.
For Mod Developers
If you're a mod developer looking to use CloverAPI, here are some resources to help you get started:
- See the BepInEx
and Harmony docs for the basics of modding.
- See the CloverAPI documentation for more information on how to use the API.
- Ask around in the Panik Games Discord's modding channel if you need help.
- Check out the Example Mod for a basic mod structure and some
example usages of the API.
The API is currently in beta. Breaking changes may happen, but we'll try to keep them to a minimum.
Game updates may also break the API. We'll fix it as soon as we can, but please be patient.
It's recommended to add the API as a dependency for all mods, even if you don't use it directly. The API includes various
features that are important for modding, like the save file compatibility layer and showing that mods are installed
on the screen. The developers requested to show whether mods are installed to prevent cheating and confusion.
Please respect this request.
The APIs distribution contains Newtonsoft JSON. Please do not include it in your mod as well, as it may cause conflicts.
Of course, you can still use it in your mod, just don't include it in the distribution.
Contributing
Just fork the repository, make your changes, and open a pull request. No special process is needed. Although no strict
code style is enforced, please try to keep your code clean and readable. Comments are appreciated.
License
MIT License.
See LICENSE for more information.
You may freely distribute CloverAPI to on other platforms. In fact, you're encouraged to do so because I sure won't be uploading it or any other platform. is too much of a hassle and other platforms aren't popular enough to be worth the effort. Maybe once stops requiring a 5-page survey to upload a mod, I'll consider it.
Although the MIT license allows you to do pretty much anything with the code, please don't claim it as your own or rebrand it unless you have made significant changes. Just fork the repository and make your changes there. Thanks!
TL;DR of the License
You can do whatever you want with the code, as long as you include the original license.
The only thing you can't do is sue me for anything related to the code.
If something breaks, it's your problem, not mine.
But hey, it's open source, so you can always fix it yourself or ask for help.
License for Builds
You don't need to include the license file when distributing official builds (e.g. releases on GitHub or ). They are free from any restrictions.
However, if you build the code yourself, you need to include the license file when distributing it.
Please also include the license file for modified builds.
Credits
- IngoH - Project lead, maintainer, and developer, also the best player of CloverPit in the world, obviously. 😎
- pharmacomaniac (a.k.a. zapybibby) - Settings integration, also the 27th best player of CloverPit in the world.
- Matteo & Lorenzo - The devs of CloverPit!
Thanks to everyone who provided feedback and helped to test the API!
Fun Fact
The name "CloverAPI" is a portmanteau of "CloverPit" and "API".
Really creative, I know. Sometimes I amaze even myself.
Let's go gambling! 🍀
Install & use Install: follow the bundled instructions
- Unzip the archive from playbuff and read the bundled readme / instructions first.
- Most mods rely on the game's mod loader — the usual route is a community mod manager (such as r2modman): pick this game, install, and it handles the loader and dependencies.
- For a manual install, put the mod files into the matching Mod / plugins folder inside the game directory.
- Launch the game to confirm it loaded; mods with listed dependencies need those installed as well.
Install locations vary a lot between mods — the bundled readme is the most reliable guide.
Install these first, or the mod will not work: