SideloaderMint

Introduction

SideloaderMint is an asset loader for H3VR focused on easily making asset replacements. It's been forked from Sideloader and updated with plenty of new features. SideloaderMint supports per-firearm and per-magazine sound replacements, allows overriding pitch and volume of AudioClips, includes quality-of-life improvements for writing addon manifests, and more!

The full developer documentation is available at: https://gitlab.com/Sirdoggy/SideloaderMint/-/wikis/home

Configuring installed addons

Installed addons can be configured via the SideloaderMint.cfg config file — you can set their load priorities and disable them individually (very handy if several addons are packed into a single Thunderstore mod!). You must launch the game to have your installed addons appear in the config.

Q&A

Can I uninstall the old Sideloader if I have this?

You should still keep it installed if you have mods that depend on it. SideloaderMint will not conflict with Sideloader - you can have both installed alongside each other.

I'm a mod developer - can this load my Sideloader mods?

Yes, but you need to port them first. Doing this is very easy, see: Porting addons from Sideloader

I want to make mods with this, where should I start?

Try making your first addon by following the guide here: Getting Started

1.2.1

Additions

• If you uninstall an addon, all of it's associated settings will now be removed from the config file upon launching the game.
  • This behaviour is enabled by default, but can be disabled in the config file.

1.2.0

Additions

• Added ability to disable addons and set addon priorities via the config file.
  • If a mod author bundles several addons in one Thunderstore mod, you can configure them individually.
  • Addon priorities determine their load order in case of conflicts.
  • You must launch the game to have your installed addons appear in the config file.

Changes for addon developers

• Added optional priority parameter to addon manifests, which can be used to specify the default priority value in an addon's config.
  • The parameter takes values between -20 and 20.
  • If the parameter is not specified, default addon priority of 0 will be used.
• Stricter validation for sub-addon directory names — allowed characters are now a-z, A-Z, 0-9, and _.

1.1.1

Fixes

• Fixed filepath not being logged in the console when a file could not be loaded from an addon.

1.1.0

Additions for addon developers

• Added new target sub-segments for bolt-related events in GunAudioSet and GunSound replacements, which can be used to scope them to only trigger in specific circumstances:
  • AfterShot (for BoltSlideForward) — triggers only after a firearm shot.
  • AfterManualCharge (for BoltSlideForward) — triggers only after a player's manual interaction with the firearm bolt.
  • AfterHKSlap (for BoltSlideForward:AfterManualCharge and HandleForward) — triggers only after a bolt handle HK-slap.
  • These are meant to serve as a better alternative to using the vanilla BoltRelease event, which is very unreliable.
  • See the wiki for further explanations on how to use these.
• Added support for "_mute" as a valid value for the path parameter in AudioClip, GunAudioSet, and GunSound replacements. Using "_mute" will silence the target sound, which means you no longer need a dedicated .wav file for that in your addons. Requires ManifestRevision "2".

Other changes

• Names of addons that are being loaded by SideloaderMint are now printed to the console when launching the game.

1.0.0

Initial release