Introduction

OtherLoaderPatched is a full replacement for OtherLoader — if both are installed, it will take priority over the original. It fixes OtherLoader's long-standing bugs and makes it more future-proof, all while being fully backwards compatible with existing OtherLoader mods.

If you notice some mod is broken when using this mod, but worked fine with old OtherLoader, report it in this form or message me directly (@Sirdoggy) in the H3VR Homebrew discord server!

Differences from OtherLoader

• Modded categories now have their own dedicated spawner tab
  • This helps isolate them from the rest of the item spawner, which should make it less prone to breaking
  • Custom items can still appear in vanilla categories if they were configured that way
• Fixed white squares appearing in vanilla item spawner categories
• Fixed items from certain old mods (like Meats_ASh12) not being vaultable or not appearing in the spawner at all
• Fixed tags not working in item spawner tag view
• Fixed the portable item spawner stylus not working
• Fixed issues with items appearing as locked when they shouldn't be
• Fixed related vault files buttons not working on update 120
• Improved how items are ordered and grouped in the spawner, with customization options in the config
• Fully revamped the Unlockathon game mode!
  • Use the new in-game panel to toggle it on/off, manage profiles, and customize settings on the fly! It can be spawned via the wrist menu or the item spawner.
  • Certain categories of items can now be configured to always stay unlocked
  • Unlockathon progress from old OtherLoader can be imported
• Added "ItemUnlocker" to the config file and expanded its functionality
  • This is a tool you can use to unlock hidden weapons and reward items. It was already present in old OtherLoader but couldn't be accessed through the regular config file.
  • Added option to only unlock firearms and ammo, which won't unlock things like gun hats or melee weapons

Making custom items

The process of making items with OLP is the same as with old OtherLoader, however modders are encouraged to install the updated OtherLoader MeatKit tools package, available here: https://github.com/sirdoggy45/MeatKit_OtherLoaderPatched/releases

Existing OtherLoader guides are still relevant:

• devyndamonster's Custom Gun Series (covers the fundamentals, mostly up-to-date)
• H3VR Homebrew Discord Server - #tutorials-gallery
• H3VR Homebrew Discord Server - #other-mods (check pins)

Credits

• devyndamonster - Creator of the original OtherLoader
• Sirdoggy - Creator of OtherLoaderPatched

And special thanks to Meat Banana, J. Melon, Veryll, and jolly soldier bucket square for beta testing the mod and providing feedback!

2.0.3

• Fixed duplicate tiles appearing in the spawner for items that use the PrefabReplacer mod
• Fixed modded items with "Prop" subcategory not appearing in the item spawner
• Fixed modded items configured as rewards appearing in the spawner even if they're not unlocked
  • These items can still appear in T&H even if not unlocked
  • Added new option under General/ItemUnlocker in the config file for only unlocking these modded items

2.0.2

• Fixed loading progress getting stuck at 100% and not finishing

2.0.1

• Fixed item spawner pages erroring out when trying to list misconfigured items
• Fixed cases where the wrong Unlockathon profile was being selected after restart
• Minor performance improvements during initial loading

2.0.0 - Full release!

The first stable release of OtherLoaderPatched is finally here! Thanks to everyone who offered help and tested the mod!

Alongside this release, an updated version of OtherLoader MeatKit tools has also been released! With it OtherLoaderPatched will be automatically set as a dependency in build profiles. If you are a modder, consider installing it to help bring the mod to more players!

Changelog

• Re-added a fully revamped version of Unlockathon!
  • This is a game mode where you have to unlock items by finding them!
  • Use the new in-game panel to toggle it on/off, manage profiles, and customize settings on the fly! It can be spawned via the wrist menu or the item spawner.
  • Certain categories of items can now be configured to always stay unlocked
  • Unlockathon progress from old OtherLoader can be imported
• Item spawner UIs will now automatically refresh when changing sorting and Unlockathon options
• Improved code for disabling old OtherLoader. Locally imported versions will now be detected much more consistently.

1.5.1

• Config options can now be edited through the in-game mod panel
• Added back the mod loading progress indicator above the item spawner
• Added back the spawn item button on the portable item spawner
• Fixed asset loading getting stuck if a mod attempts to load the same asset bundle more than once
• Fixed modded items not being correctly assigned as secondary objects if they have a misconfigured 'FVRObject.SpawnedFromID'
• Fixed some items not being loaded from the following legacy mods:
  • Phoenix-NikiFoxsCSGOBenelliNova
  • Potatoes-Potatoes_SMGs
  • Potatoes-Potatoes_Rifles
  • Potatoes-Potatoes_NonRepeaters
  • Potatoes-Potatoes_Pistols
• Back-end changes:
  • All custom ItemSpawnerIDs now have their "FromMod" field set to the name of the plugin they belong to. This means that mod names will be properly serialized in vault files now.
  • Improved the code for hashing category names to enum integers (used for spawner tags) to better avoid collisions

1.5.0

• Added options for configuring how items are sorted and grouped in the item spawner
  • You can now configure whether modded items should be displayed before, after, or alongside vanilla items. By default, they will be displayed before vanilla items. This affects both simple mode view and tag view.
  • Items will now be sorted by their display name, instead of by their internal IDs (which is the vanilla behaviour). This can be disabled in the config.
• OtherLoaderPatched will no longer attempt to categorize items if their spawner page does not match their categories, bringing its behaviour closer to old OtherLoader
  • Unlike old OtherLoader, these items are now placed into a dedicated category in the modded categories tab instead of appearing in random white-square categories.

1.4.14

• Fixed compatibility with legacy mods that directly load dlls through OtherLoader
  • Fixes nayr31-Exotic_Grenades not loading

1.4.13

• Fixed spawner entry not appearing in spawner if a different entry with the same ID had loaded with the "IsDisplayedInMain" flag set to false. Only affects legacy mods.
• Improved how legacy items are tagged

1.4.12

• Fixed colored logs degrading performance if any LogTags other than "General" were selected in the config
• Fixed null pointer exception introduced in previous patch

1.4.11

• Fixed custom item spawner tutorial videos not loading
• Fixed secondary objects not spawning alongside main object for some legacy mods

1.4.10

• All items loaded by OtherLoader are now displayed in item spawner tag view and can be searched using tags!
  • The "IsDisplayedInMain" flag is now ignored when in tag view, but still respected when in simple mode view
  • Keep in mind that the tab in which items will be located is heavily dependent on how a mod author has configured them - as an example, to find magazines from certain mods you might need to search in the "Firearms" tab instead of the "Ammo" tab
• Fixed certain tags being associated with object IDs instead of spawner IDs, which was causing issues when they were being loaded in item spawner tag mode
• Fixed an edge case where spawner entries were being incorrectly registered as categories even though they had a valid main object
• Fixed rare cases of items being visible in vanilla simple mode categories even though they were successfully registered in the custom categories tab

1.4.9

• Fixed even more cases where items were being assigned wrong categories

1.4.8

• Fixed melee weapons from certain mods being assigned to the wrong category, causing them to not appear in the spawner

1.4.7

• Fixed items from FTW_Arms_Modular_M1a (and possibly other legacy mods) not appearing in the item spawner, caused by a very specific edge case in load order of spawner entries

1.4.6

• Fixed some items not loading from FTW_Arms_Edged_Weapons_Pack

1.4.5

• Fixed issues with spawner entries not spawning additional items if more than 1 additional item was defined
• Fixed modded category count not updating dynamically while mods are still loading in

1.4.4

• OtherLoaderPatched will no longer refuse to register an ItemSpawnerID if one with the same ID was already registered before, bringing it's behaviour closer to old OtherLoader. This fixes items from some mods not appearing in the item spawner.
• Fixed secondary objects not being linked to spawner entries if one asset bundle had loaded before the other

1.4.3

• Improved legacy mod compatibility. This fixes Nik_ApexLegendsWeapons not loading properly, but can also affect other legacy mods.

1.4.2

• Old OtherLoader dll file will now be automatically re-enabled after OtherLoaderPatched has successfully initialized. Previously, if you were to uninstall OtherLoaderPatched, you would also need to manually re-enable old OtherLoader in your mod manager for it to work again. Now it will be re-enabled automatically.

1.4.1

• Fixed vanilla items not being registered as "Secondary Objects" for custom items
• Fixed some custom objects appearing simultaneously in modded categories and vanilla categories in simple mode view

1.4.0

Initial beta release of OtherLoaderPatched