HappyPeak

Tired of a plain old climb? Spice up every PEAK run with a bunch of toggleable chaos events.

A host-side PEAK mod that randomizes chest loot, scales loot by a configurable multiplier, and adds a handful of independently-toggleable chaos events designed to make co-op runs more unpredictable.

Every event has its own on/off switch and tuning knobs. Don't like banana rain? Turn it off. Want zombies to come out of every chest? Crank ZombieTrapChance. The defaults aim for "noticeable but not run-ruining"; tweak as you like.

Only the host needs to install this mod. Clients see all the effects without installing anything — every spawn / replacement happens host-side and propagates over Photon.

🔥 Strongly recommended companion: ModConfig

Install PEAKModding's ModConfig alongside HappyPeak. It opens an in-game GUI where you can flip any config value live — no need to alt-tab, edit text files, or restart the game. Boolean toggles, sliders, etc. all work out of the box with HappyPeak's settings.

It's a separate mod (one-click install from Thunderstore). Without it, you have to edit BepInEx/config/HappyPeak.cfg by hand and BepInEx hot-reloads it.

⚠️ Upgrading from an older HappyPeak version?

If you had HappyPeak installed and are updating to a newer version that added/removed/renamed config entries, delete BepInEx/config/HappyPeak.cfg before launching. BepInEx never rewrites descriptions or new entries into an existing cfg, so you'll lose new toggles otherwise. Your custom values get reset — back them up first if you'd tuned anything.

If you're unsure whether the version you're updating to changed configs, just delete the cfg. It costs you a 5-second restart and avoids weirdness. (As of 0.12.0 the safe zone, invincibility, chest trap, and tumbleweed sections are recent additions; 0.11.x doesn't have them.)

Features

Events never fire while you're at the airport / lobby — they only run inside an actual mountain run.

Install

Install via the Thunderstore Mod Manager or r2modman, or drop HappyPeak.dll into <PEAK install>/BepInEx/plugins/ manually.

Requires the BepInExPack for PEAK.
Also recommended: PEAKModding/ModConfig for in-game live configuration.

Configuration

After running the game once with the mod installed, BepInEx generates BepInEx/config/HappyPeak.cfg. Edit it with any text editor — every entry has a bilingual description (English line + Chinese line) right above it.

Or use ModConfig for in-game live editing (see top of this page).

Full config reference

[Randomizer]

[LootScaling]

[Tornado]

[BananaPeel]

[Tumbleweed]

[Dynamite]

[MarkerSpawn]

Behavior is hardcoded (no extra knobs): up to 2 pickaxes per player, auto-cleanup at 60 seconds. New pings past the cap evict the pickaxe farthest from you so a pickaxe in your hand is never destroyed.

[Eruption]

[ChestTraps]

[SafeZones]

Affected events: Tornado, Eruption, BananaPeel, Tumbleweed, Dynamite. Players standing inside the safe radius are skipped by those events.

Tuning recipes

• Default (balanced): leave everything alone. Events fire roughly every 1–2 minutes per type, loot is tripled, traps are rare.
• Chill mode: bump every IntervalMin/IntervalMax to 180–300s, set LootMultiplier = 1, traps at 1–2%.
• Party chaos: drop intervals back to 10–30s across the board.
• Pure loot mode: set every EnableXxx (except EnableItemRandomization and EnableLootScaling) to false.
• All-traps, no events: disable Tornado/BananaPeel/Tumbleweed/Dynamite/Eruption, leave ChestTraps + Randomizer + LootScaling on.
• Demolition mode: LightDynamiteOnSpawn = true, DynamiteForwardDistance = 0, DynamiteDropHeight = 0 — bombs detonate exactly where the player is standing.

Compatibility

• Targets BepInExPack PEAK 5.4.2403.
• Should coexist with most cosmetic / QoL mods.
• Likely conflicts with mods that also patch Spawner.SpawnItems (e.g. ItemMultiplier) — Harmony will let one of them win on each call. Disable LootScaling if you want ItemMultiplier to be authoritative.
• Coexists fine with PeakRandomizedChaos if you turn off the overlapping events on either side.

Build from source

Requires:

• .NET SDK 8 or newer (brew install dotnet on macOS, winget install Microsoft.DotNet.SDK.8 on Windows).
• A local PEAK install — the build pulls game DLLs from <PeakGameRootDir>/PEAK_Data/Managed/. If your install isn't at the default Steam path, you can either copy the Managed/ folder into the project root (auto-detected) or set <PeakGameRootDir> in Config.Build.user.props.

dotnet restore
dotnet build -c Release

DLL ends up at artifacts/bin/HappyPeak/release/HappyPeak.dll.

To produce a Thunderstore package:

dotnet tool restore
dotnet build -c Release -target:PackTS

Recent changes

Full history in CHANGELOG.md. Top-level summary:

• 0.12.0 — Big quality-of-life release.

  • MarkerSpawn now drops a real Mesa pickaxe (鹤嘴锄) instead of a piton, captured instantly via Harmony Postfix, attached precisely to whatever surface the ping crosshair landed on. Spawned pickaxes don't crack. Up to 2 per player, evicts the one farthest from you so the held / freshly-spawned ones are always safe.
  • Dynamite redesigned as a "face-drop": spawns in front of the player's head from head height, default unlit (so the player can pick it up and use it).
  • New events: Tumbleweed rain, Chest traps (Scoutmaster summon + Mushroom Zombies).
  • New SafeZones section: standing near a campfire makes you immune to all hazardous events and (optionally) to all status damage.
  • Fix: bushes no longer get randomized items (was a side effect of patching LootData instead of Spawner.SpawnItems).
  • Fix: held items no longer accidentally destroyed by marker eviction.
  • All networked spawns now properly replicate destroy to clients (no ghost objects).
  • README + cfg descriptions fully bilingual (English + Chinese).

• 0.11.5 — First public Thunderstore release: chest randomization, loot multiplier, Tornado, BananaPeel (trail-style), Dynamite (lit), MarkerSpawn (piton), Eruption.

Credits

Implementation patterns adapted from:

• PeakRandomizedChaos by DoggyDentures — Tornado, BananaPeel, Eruption event templates.
• ItemMultiplier by IceMods — Spawner.SpawnItems patching shape.
• HazardChaos by Bananegame — Dynamite.LightFlare insight.
• TrappedLuggage by tony4twenty — chest trap pattern (Scoutmaster + Zombie spawning, RPC names).
• PeakStranding by lnkr — verified 0_Items/ClimbingSpikeHammered prefab name for embedded pitons.
• BetterPreplacedPitons by Gabriel — confirmed ShittyPiton is PEAK's internal name for the wooden Mesa pickaxe.
• RandomEvents by Wesmania — verified 0_Items/PickAxeHammered_Shitty prefab name for spawning the Mesa pickaxe.
• ItemBrowser by cherrycove — project structure / build setup template.

Changelog

[Unreleased]

• Default tuning pass for the public release. Events fire much less often than the previous test-mode defaults, loot is tripled instead of doubled, and small counts trimmed for balance.
  • LootMultiplier: 2 → 3 (triple loot)
  • Tornado interval: 10–30s → 90–120s; lifetime 60s → 30s
  • BananaPeel interval: 10–30s → 60–90s; min per player 2 → 1
  • Tumbleweed interval: 10–30s → 60–90s; per-player range 2–5 → 1–3
  • Dynamite interval: 15–30s → 60–90s
  • Eruption interval: 15–30s → 60–90s
  • Scoutmaster chase time: 60s → 30s
• Fixed EnableRandomDynamite description that still said "lit on spawn by default" — it's actually false (unlit) since 0.12.0.
• README config tables + tuning recipes updated to reflect the new defaults.

[0.12.0]

Big quality-of-life release. Major redesigns to MarkerSpawn, Dynamite, BananaPeel; new Tumbleweed, ChestTraps, and SafeZones sections; lots of bug fixes.

MarkerSpawn (middle-click pickaxe drop)

• Now drops a real Mesa pickaxe (鹤嘴锄) instead of a piton. Photon prefab name (0_Items/PickAxeHammered_Shitty) verified against Wesmania/RandomEvents PingGrabber.
• Reads PointPing.hitNormal directly for accurate surface attachment on walls / overhangs / slopes. Old approach raycast in 5 world directions and often picked up the floor beneath a wall.
• Caught instantly via a Harmony Postfix on PointPing.Start (no more 200 ms polling that missed rapid pings).
• Spawned pickaxes don't crack/break. Mesa's preplaced pickaxes still behave normally — we tag our spawns via InstantiationData so PickaxePermanencePatch only affects ours.
• Up to 2 unclaimed pickaxes per player (hardcoded). New ping past the cap removes the one farthest from the player so the freshly-spawned and held ones are always preserved.
• Auto-cleanup at 60s hardcoded — no more MarkerSpawnLifetime config.
• Spawn position offset 0.3 m out from the surface along the normal so the model doesn't z-fight inside the wall.
• Used Quaternion.LookRotation(-normal, Vector3.up) (matching the game's own HammerClimbingSpike) so the spike pokes properly into the wall.

Dynamite (face-drop)

• Redesigned from "drop near random player on the ground" → "drop right in front of the player's face from head height."
• Default LightDynamiteOnSpawn = false — drops an unlit stick the player can pick up and use, instead of bombing them.
• New configs: DynamiteForwardDistance (default 1 m in front of head), DynamiteDropHeight (default 0 m above head), DynamiteSidewaysJitter (default ±0.5 m).
• Old DynamiteOffsetMin/Max repurposed as horizontal scatter — defaults changed from 20/100 → 0/5.
• Item.SetState(ItemState.Ground) called on spawn so the rigidbody actually falls under gravity (PEAK items default to kinematic until the game's own drop logic activates them).
• Respects campfire safe zone.

Tumbleweed (new section)

• Tumbleweeds rain from above each player (same pattern as banana rain) using PEAK's native TumbleWeed prefab.
• Default 15 s lifetime per tumbleweed.
• Respects campfire safe zone.

BananaPeel (rain)

• Peels spawn high above each player and fall via gravity instead of materializing at foot level.
• Each peel is independent (random rotation, no more cumulative trail offset).
• Respects campfire safe zone.

SafeZones (new section)

• CampfireSafeRadius (default 30 m) — bubble around every campfire (biome rest + player-lit) where Tornado / Eruption / BananaPeel / Tumbleweed / Dynamite events skip the player.
• EnableCampfireInvincibility (default on) — patches CharacterAfflictions.AddStatus so any positive status (injury, cold, hot, hunger, poison, …) is blocked while a player stands inside the safe radius. Healing still works.

ChestTraps (new section)

• Each chest opening rolls per-trap chances:
  • Scoutmaster trap (default 5% chance) — teleports the existing Scoutmaster to the chest and forces him to hunt the opener for ScoutmasterChaseTime seconds. Uses the networked RPCA_SetCurrentTarget RPC so the AI on every client receives the assignment.
  • Mushroom Zombie trap (default 10%) — spawns 1–2 zombies at the chest, sets their wake-up time to 0, locks them onto the opener.

Other events

• Tornado: Kiln detection now compares against the Segment.TheKiln enum (was a magic int >= 4 that sometimes leaked tornadoes to the summit).
• Eruption: respects campfire safe zone.
• All events gated on Plugin.IsInGameRun() — nothing fires in the airport / lobby.

Bug fixes

• Bushes no longer get randomized items. Removed LootTablePatch (which patched LootData.GetRandomItem(s), hit by every spawner not just chests). Randomization is now handled in SpawnerPatch along with the multiplier; that patch filters by ChestSpawnerTypeNames (Luggage, RespawnChest) so non-chest spawners pass through to vanilla logic.
• Marker pickaxe no longer destroys items the player is holding. Eviction checks Item.holderCharacter AND walks the GameObject's parent chain to detect "in a Character's hand/inventory" — both signals are checked; either one passing skips destroy. As of 0.12.0 the dominant safeguard is the "evict farthest from pinger" rule (anything held is 0–1 m away vs walls being further).
• Bombs no longer hover in mid-air. Items spawned via PhotonNetwork.InstantiateItemRoom default to kinematic; we now call Item.SetState(ItemState.Ground) to enable gravity.
• All networked spawns now use PhotonNetwork.Destroy via the shared Plugin.DelayedNetworkDestroy helper instead of Object.Destroy, so despawns replicate to every client (no more ghost objects on clients).
• Marker pitons no longer bury themselves inside walls. Switched the rotation calc from Quaternion.FromToRotation(Vector3.up, normal) to Quaternion.LookRotation(-normal, Vector3.up) to match the game's own placement.

Configuration

• New configs across sections (see README's full reference): DynamiteForwardDistance, DynamiteDropHeight, DynamiteSidewaysJitter, TumbleweedIntervalMin/Max/sPerPlayerMin/Max/Lifetime/DropHeight, BananaPeelDropHeight, CampfireSafeRadius, EnableCampfireInvincibility, EnableScoutmasterTrap, ScoutmasterTrapChance, ScoutmasterChaseTime, EnableZombieTrap, ZombieTrapChance, ZombieCountMin/Max, ZombieLifetime.
• Removed configs: MarkerSpawnItemName, MarkerSpawnLifetime, MarkerSpawnMaxActive, DynamiteOffsetMin/Max (the old "distance from player" pair).
• All descriptions are bilingual (English line + Chinese line) so the cfg file is readable in either language.
• LootMultiplier now rounded to nearest integer at read time (no fractional item counts).

Docs

• README rewritten for the public Thunderstore page.
• Recommends installing PEAKModding/ModConfig for in-game live config editing.
• Adds "Upgrading from an older version" notice — delete HappyPeak.cfg when updating, since BepInEx doesn't backfill new entries into an existing cfg.
• "Recent changes" section.
• Renamed mod's tagline + general polish.

[0.11.5]

• Initial public Thunderstore release.
• Chest randomization with custom blacklist + loot multiplier.
• Tornado, BananaPeel (trail), Dynamite (lit), MarkerSpawn (piton), Eruption events.
• Bilingual config descriptions.