GunGame Progressions

GunGame Progressions provides Advanced GunGame profiles and a lightweight runtime exporter for H3VR. It builds compatible loadouts from the content currently enabled in the player's H3VR profile, without modifying the GunGame plugin.

Requirement

• GunGame

Included Profiles

The package always includes these safe vanilla fallbacks:

After H3VR finishes loading active content, the exporter writes runtime profiles from the live object and Sosig registries:

Profiles 02 and 04 are generated only when active modded firearms exist. "Modded" profiles include the vanilla set as well as enabled modded content; they do not reference disabled or absent mods.

GunGame reads profiles during startup and does not support a live profile reload. The packaged fallbacks are therefore immediately selectable. A runtime profile set refreshed after other mods finish loading is reliably available on the next H3VR launch.

Mixed Enemy Progression

Mixed Enemy profiles use Count mode. The default is 3 kills to advance, and each player kill advances the current weapon by exactly one kill. The GunGame menu can change this count from 1 upward.

Enemy values control spawn likelihood only. Core H3VR factions (RW_*, M_Swat_*, M_MercWiener_*, and Comperator_*) receive extra weighted entries so they appear more often. Easier core enemies have higher weights: Rot 8, Scout 5, Riflewiener 3, SpecOps 2, and Heavy 1. Other active spawnable Sosigs remain eligible at lower weight.

Loadouts and Optics

• Every firearm uses compatible ammunition only: magazine first, then clip, then cartridge or speedloader when required.
• All compatible feed options are recorded in MagNames.
• Optics are assigned only when the firearm and optic have an exact verified physical mount match.
• Reflex sights and PIP scopes are eligible; magnifiers and unclassified attachments are excluded.
• Firearms without compatible feeds, and items listed in profile-rules.json, are excluded.

Runtime Files

The exporter writes these files under the installed HLin_Mods-GunGame_Progressions folder:

• ObjectData.json: active object metadata snapshot.
• GunGameWeaponPool_Runtime_*.json: generated GunGame profiles.
• RuntimePools/: runtime generation receipt and catalog data.

The package contains no game assemblies or static list of modded objects. Each player obtains a profile for their own active mod set at runtime.

License

MIT. See the repository LICENSE.

Changelog

See CHANGELOG.md.

Changelog

All notable changes to GunGame Progressions are documented here.

1.3.6

• Runtime pools now refresh once after enabled content finishes loading; the included vanilla profiles remain ready during startup.
• Prevented magnifier attachments from being selected as automatic scope loadouts.
• Improved runtime loadout validation for compatible firearms, feeds, and optics.

1.3.5

• Added separate Vanilla and Modded Rot and Mixed Enemy pools, so modded pools use only the weapon mods currently enabled in your profile.
• Added mixed enemy pacing: basic Sosigs are common, operators are uncommon, and heavy or high-tier operators are rare.
• Improved compatible loadouts: firearms receive the right magazines, clips, speedloaders, or cartridges, with suitable optics only on matching mounts.
• Updated the Thunderstore listing with a clearer player guide to pools, difficulty, and compatible gear.

1.3.4

• Refreshed the Thunderstore listing and icon with the verified vanilla catalog counts and runtime support for active modded guns and custom Sosigs.

1.3.3

• Mixed Enemy profiles now use GunGame Count mode: the default is 3 kills to advance and every kill contributes one advance.
• Reworked mixed-enemy values as spawn weights, preserving frequent easy core enemies and rare hard or unusual enemies without inflating the progression counter.
• Added a Count-mode vanilla mixed fallback so a newly installed package starts at three kills immediately.
• Added release documentation and packaged changelog metadata.

1.3.2

• Classify runtime Sosigs by built-in SosigEnemyID enum membership rather than UGC module ownership.
• Restore the vanilla mixed profile and restrict custom Sosigs to the active-content mixed profile.

1.3.1

• Favored Rotwieners, SWAT, MercWieners, and Operators through repeated equal-value entries while retaining every active Sosig type.

1.3.0

• Added startup metadata export with a later stable refresh after mod loading.
• Added origin-split vanilla and all-active Rot and Mixed Enemy runtime profiles.
• Added physical-mount-verified PIP scope and reflex sight selection.
• Excluded firearms without a compatible feed instead of assigning generic ammunition.

1.2.9

• Reduced packaged offline content to a single Rot baseline while making runtime-generated profiles the primary workflow.

1.2.8

• Added exact mount matching for optics, excluded magnifiers, and removed stale runtime pools before regeneration.

1.2.7

• Fixed runtime rules loading on H3VR Mono and enforced magazine, clip, then cartridge feed priority.

1.2.6

• Added Gauntlet and Bounty runtime modes.

1.2.4

• Converted profiles to GunGame Advanced format and added the independent runtime metadata exporter.

Earlier releases

• Added and curated the original vanilla all-in-one firearm pools, blacklists, and additional weapon coverage through versions 1.0.0 to 1.2.0.