Gundomizer

Randomize items directly in Item Spawner V2, including the toolbox tablet, in classic and tag-search modes.

Features

• Random item: roll from the current category and its subcategories, or your selected tags, across all pages.
• Compatible item: roll items that fit what you're holding, including magazines, attachments, and installed rail adapters.
• Random ammo: roll a compatible ammo variant. The arrow beside it opens the variant toggles.
• Spawn or preview: spawn immediately, or select a result to inspect, accept, or reroll.
• Auto-fill: replace loaded rounds and fill the held magazine or weapon, while still spawning the loose round.
• Continuous search: shows loading progress; click the active button again to cancel.

Mod compatibility

Tested with Modul / Modular Workshop content, OtherLoader, and OtherLoaderPatched. These mods are optional.

Optimization

A background metadata index checks compatibility without loading entire assets just to inspect their connectors. It's saved between launches and updates changed packages, making rolls faster as indexing completes.

Mod Options

• Spawn Item Instantly — ON: spawn immediately; OFF: preview first.
• Auto Fill Held Item — ON: refill with the rolled ammo after spawning.
• Persistent Connector Index — ON: build and reuse the metadata cache.
• Reset Metadata Indexing — OFF: clear and rebuild the cache once, then switch itself off.

Edit quaternion.gundomizer.cfg through your mod manager's Config Editor. Requires BepInExPack H3VR.

Changelog

• 1.0.2: Fix missing buttons with OtherLoaderPatched and support its custom categories.
• 1.0.1: DLL-only metadata reader with reusable decompression buffers.
• 1.0.0: First public release: item, compatible gear and ammo rolls, optional auto-fill, and persistent background indexing.

Development version history

Credits

• Special thanks to Glicen for requesting and sponsoring the mod.
• Anton Hand and RUST LTD. for H3VR.
• The H3VR Homebrew community, mod authors, and tool and loader maintainers.
• nesrak1 / AssetsTools.NET for the bundle metadata reader library.

Support

Tips and donations are welcome on Ko-fi. You can find my other projects and links at quaternion7.github.io.

Changelog

1.1.0

Add compatible item choices: type and connector toggles, with current-section/tag or all-item scope. The global scope includes modular magazines stored under Firearms.

Use a chain-link icon for compatible rolls, with a grouped dropdown for filter choices.

Recognize byte-encoded magazine flags in bundle metadata, enabling lightweight indexing for ModulAK magazines. Existing indexes rebuild once for the corrected reader.

1.0.2

Fix missing buttons with OtherLoaderPatched. Support its native IDs, custom categories, unlocks and bundled spawns while retaining optional support for original OtherLoader. Neither loader is required.

1.0.1

Move the metadata reader into the mod DLL, remove the external executable, reuse decompression buffers, and read only relevant fields to reduce allocation pressure. Existing persistent caches remain compatible.

1.0.0

First public release: random items, compatible gear and ammo in Item Spawner V2 and its toolbox tablet, with optional auto-fill and persistent background indexing.

Development versions

• 0.1.14: Automatic search continuation, loading progress, click-to-cancel, and a shorter README with a spawner preview.
• 0.1.13: Optional held-item ammo filling, including native Spawn and toolbox tablet placement.
• 0.1.12: One-shot metadata reset and support for modded ammo IDs without standalone spawner entries.
• 0.1.11: Persistent background metadata indexing with per-package updates and a lightweight reader.
• 0.1.10: OtherLoader categories, IDs and bundled spawns; performance checks with modded items.
• 0.1.9: Generic cleanup for failed item initialization, replacing the sight-specific exclusion.
• 0.1.8: Reused filter results, indexed loaded connectors, and paced prefab searches with pause limits (removed in 0.1.14).
• 0.1.7: Rounded, shaded rainbow buttons, grouped ammo controls, and a missing-preview fallback.
• 0.1.6: Compatible ammo rolls with per-caliber variant toggles.
• 0.1.5: Tag-search support across every results page.
• 0.1.4: Reused held-item compatibility queries and added timing measurements.
• 0.1.3: Nearby held-item checks at one-second intervals within eight metres.
• 0.1.2: Optional selection before spawning.
• 0.1.1: Sliding rainbow gradients, compact icons, larger tooltips, and an initial sight-specific guard.
• 0.1.0: Initial random and compatible item buttons for the classic spawner.