nauja / sogmapi

Modding API for Secret of Grindea

Secrets of Grindea Modding API

SoGMAPI is an open-source modding framework and API for Secret of Grindea, forked from SMAPI, that lets you play the game with mods. It's safely installed alongside the game's executable, and doesn't change any of your game files.

Features

1. Load mods into the game.
   SoGMAPI loads mods when the game is starting up so they can interact with it. (Code mods aren't possible without SoGMAPI to load them.)

2. Provide APIs and events for mods.
   SoGMAPI provides APIs and events which let mods interact with the game in ways they otherwise couldn't.

3. Provide update checks.
   SoGMAPI automatically checks for new versions of your installed mods, and notifies you when any are available.

4. Provide compatibility checks.
   SoGMAPI automatically detects outdated or broken code in mods, and safely disables them before they cause problems.

5. Back up your save files.
   SoGMAPI automatically creates a daily backup of your saves and keeps ten backups (via the bundled Save Backup mod), in case something goes wrong.

Documentation

Most of the documentation available for SMAPI should also work for SoGMAPI as this is a fork with the same structure, same installer and same modding API.

Have questions? You can ask me on GitHub or send me an email.

For players

• Player guide (SMAPI)

For modders

• Modding documentation (SMAPI)
• Mod build configuration
• Release notes

For SoGMAPI developers

• Technical docs

sogmapi's Issues

No mods load

SoGMAPI 0.1.2

Upon starting SoGMAPI, every mod in the mods folder will give this error:

[21:48:41 ERROR screen_0 SoGMAPI] - Save Backup 1.0.0 because its DLL couldn't be loaded: Could not load 'C:\Program Files (x86)\Steam\steamapps\common\SecretsOfGrindea\Mods\SaveBackup\SaveBackup.dll' because it was already loaded. Do you have two copies of this mod?

There are not, in fact, two copies of any mod in the mods folder.

To reproduce: Simply start SoGMAPI without changing, adding or removing anything. The two mods it comes with give this error.

Linux/SteamOS Installer Support

In the 0.1.2 release, there is an installer for Windows but the Linux/MacOS installers have no data in the 'internal folder' to work with, and thus don't function. Is support for this planned in the future? I understand it could be built manually but in my particular case I don't have access to a compiler for a while, and playing on a Steam Deck would be ideal. Thanks!