Princess Usa's Bike Gang Mod 1.2.2

A standalone R.E.P.O. BepInEx mod for building a whole Scout/Hauler bike gang.

WHAT 1.1.0 ADDS

• Bike Gang now adds duplicate Scout/Hauler candidates to R.E.P.O.'s normal shop pool itself.
• Shop Duplicate Unlock is NOT required to get duplicate bikes.
• Only Scout and Hauler shop candidates are duplicated by this feature.
• Other shop items are not duplicated by Bike Gang.

PURPOSE

• Allows repeat buying/ownership of the vanilla Scout and Hauler.
• Allows multiple Scouts and Haulers to coexist and be used in the same run.
• Does NOT require CartTrain Locomotives.
• Does NOT change cart towing, Shift+X, vehicle physics, or CartTrain.
• Only targets items whose records/prefabs identify as Scout, Hauler, or Semiscooter.

CONFIG Shop / ScoutHaulerMaxCopies = 10 Purchase/ownership ceiling for each vehicle type. Minimum effective value is 2.

Shop / ScoutHaulerShopPoolCopies = 5 Number of copies of each Scout/Hauler Item placed into the normal shop candidate pool. Effective range is 1-10. Higher values make multiple bikes more likely to be selected for a shop.

The mod changes these Item limits for Scout/Hauler only:

• maxAmountInShop = ScoutHaulerMaxCopies
• maxAmount = ScoutHaulerMaxCopies
• maxPurchase = false
• maxPurchaseAmount = 0

It also tops up ShopManager.potentialItems so each Scout/Hauler Item has at least ScoutHaulerShopPoolCopies candidate entries whenever the shop pool is built.

MULTIPLAYER The host/master client applies the shop item and candidate-pool changes.

COMPATIBILITY

• Shop Duplicate Unlock may remain installed for duplicate non-bike items. Bike Gang no longer needs it for Scouts/Haulers.
• If Shop Duplicate Unlock adds even more Scout/Hauler candidates than Bike Gang's configured target, Bike Gang does not remove them; it only tops up when there are too few.
• CartTrain Locomotives may be installed separately, but is not a dependency.

BUILD

1. Install .NET 8 SDK if dotnet is not already installed.
2. Open PowerShell in this folder.
3. Run: Set-ExecutionPolicy -Scope Process Bypass
4. Then run: .\build.ps1
5. Output DLL: src\bin\Release\netstandard2.1\PrincessUsasBikeGangMod.dll
6. Replace the old DLL in: R.E.P.O.\BepInEx\plugins\PrincessUsasBikeGangMod\

TEST

1. Start a save as host.
2. Reach several shops.
3. Confirm the log contains lines beginning "Bike Gang shop pool:".
4. Buy multiple Scouts and/or Haulers when offered.
5. Verify all bought vehicles arrive and can be used independently.
6. Send the new LogOutput.log if anything behaves differently than expected.

VEHICLE COLORS (1.2.0)

• Hold a Scout or Hauler and press C by default.
• Pick a color from the popup palette.
• The selected color applies only to that vehicle instance.
• Wheels, tires, glass, lights, seats, screens and handles are skipped where identifiable.
• The palette key can be changed in BepInEx/config/CandyKane.PrincessUsasBikeGangMod.cfg: [Vehicle Colors] EnableVehicleColors = true PaletteKey = C
• Press the palette key again, Escape, or Cancel to close.

VEHICLE COLORS (1.2.2)

• ExteriorPaintOnly = true by default.
• The palette now targets likely painted exterior/body meshes instead of recoloring nearly every renderer on the vehicle.
• Explicitly skips wheels/tires, glass, lights, seats, controls, suspension, drivetrain, motors, batteries, cables, decals/UI and other mechanical pieces where identifiable.
• Large generic vehicle-shell meshes are still included so vanilla body parts do not need perfect names.
• If the filter is too strict for a future R.E.P.O. update, set ExteriorPaintOnly = false to temporarily use the broader 1.2.0 behavior.
• Enable DebugLogging to print each renderer/material selected as paint; this makes future filter tuning much easier.

Changelog

1.3.0 — Rainbow Fighters

• Added multiplayer synchronization for Scout and Hauler color choices.
• Everyone running the mod in the room can see the selected color for the same vehicle.
• Restore Original now synchronizes to other players.
• Added late-join synchronization so current vehicle colors can be restored for players entering the room after colors were chosen.
• Retained configurable palette key, per-vehicle coloring, exterior-paint filtering, and full-vehicle root resolution.

1.2.2

• Fixed occasional partial vehicle recolors when the held PhysGrabObject was a child piece.
• Color and Restore Original now resolve upward to the full Scout/Hauler root before touching renderers.
• Recolor log reports RootResolvedFrom for easier testing.

1.2.1

• Color palette defaults to exterior/body-paint-only recoloring.
• Added exclusions for wheels, glass, lights, controls, seats, and mechanical components.
• Added size-based fallback for generically named body-shell meshes.
• Added ExteriorPaintOnly config toggle and debug paint-target logging.

1.2.0

• Added per-vehicle Scout/Hauler color palette.
• Hold a vehicle and press configurable PaletteKey (C by default).
• Added Pink, Purple, Blue, Cyan, Green, Yellow, Orange, Red, White, Black, Gold, and Mint swatches.
• Added Restore Original.

1.1.0

• Added built-in Scout/Hauler duplicate shop candidate pool support.
• Shop Duplicate Unlock is no longer required for duplicate Scout/Hauler candidates.

1.0.0

• Initial standalone release.
• Raised Scout/Hauler purchase and ownership limits.