Riks of Rain 2 Achievement Loader

A loader of sorts of the achievement variety

IMPORTANT

To the EXTENT OF MY KNOWLEDGE this don't corrupt save files when uninstalled.

HOWEVER

You should ALWAYS be safe and BACK UP YOUR SAVES!!

It's better to be safe than sorry!

Installing

Download then drag and drop the "plugins" folder into your bepinex folder

You'll know it's working if you see this in the output console

How to make a Custom Achievement

To make a custom achievement just follow these simple steps.

1. Add "AchievementLoader" as a dependency to your project
2. Add a class to your plugin that inherits from BaseAchievement
3. Decorate your class with the [RegisterAchievement] attribute
4. Override OnInstall and OnUninstall with whatever you need to check for your challenge
5. Call Grant() when the criteria is met
6. (Optionable) If you don't do these, the challenge will still work but text related to it will be broken and it won't unlock anything when completed
   1. Decorate your achievement class with a [CustomUnlockable] attribute
   2. Add tokens to the language file for your challenge in the format ACHIEVEMENT_NAMEINCAPS_NAME and ACHIEVEMENT_NAMEINCAPS_DESCRIPTION
   • The AssetPlus api makes this easy

Here's an example of what a valid achievement class looks like

  [CustomUnlockable("Example.Example", "ACHIEVEMENT_EXAMPLEACHIEVEMENT_DESCRIPTION")]
  [RegisterAchievement("ExampleAchievement", "Example.Example", null, null)]
  public class ExampleAchievement : BaseAchievement
  {
      public override void OnInstall()
      {
          base.OnInstall();
          RoR2Application.onUpdate += AutoGrant;
      }

      public override void OnUninstall()
      {
          base.OnUninstall();
          RoR2Application.onUpdate -= AutoGrant;
      }

      public void AutoGrant()
      {
          Grant();
      }
  }

For more details check out the (WIP) wiki

Contact

Any comments, question or concerns please send my way @ Dak#0001 on the modding discord.

Changelog

View it here

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Thanks

• I'd like to thank the Harmony devs for writing good docs that don't make me want to commit unalive