Big Firework

Host-synchronized sky firework shows, interactive launcher pads, cinematic night transitions, and authentic flare audio for Big Walk.

Big Firework lets the host illuminate the island sky with choreographed firework volleys that replicate across the entire lobby via Mirror RPCs. Unmodded vanilla players see the exact same sky show without installing anything.

✨ Features

• Lobby-Wide Multiplayer Sync: Bursts use the game's native Mirror PeckEffectParticleNetworked.RpcFire(pos, rot), so all vanilla and modded players in the session see the exact same fireworks in real time.
• Player Show & Follow Movement: In Self mode, the show follows the host dynamically as you walk, sprint, or explore the island. Or select Everyone to round-robin bursts across all lobby players.
• Cinematic Sky Director:
  • Automatically fast-forwards time smoothly to midnight (0.0h) over 2.5 seconds when a show begins.
  • Locks night for the duration of the show.
  • Smoothly restores daylight with a configurable RestoreDelay after the show concludes.
• Authentic Flare Audio Engine:
  • Ingests native AudioAsset collections from the game's ParticleOneShotSound.
  • Completely silent at launch—detonates in the air at apex via the game's compiled AudioPlayHelper engine.
  • Real-time acoustic propagation delay: sound arrives delayed by distance at the speed of sound ($\Delta t = \text{distance} / 343\text{ m/s}$).
• Firework Launcher Buttons:
  • Hooks into physical in-world firework launcher pads across the island.
  • Set to Off (vanilla), Accompany (pad triggers its own rockets plus sky volleys), or Replace (swaps button with custom pad shows: FlareVolley, RocketSalvo, or GrandFinale).
• Show Styles:
  • Sky: Majestic high-altitude bursts with customizable launch height and spread angle.
  • Fountain: Festive ground-level spray bursting from the anchor's feet with a wide cone.
• Color Compositions: Fine-tune burst counts for Green, Yellow, Blue, Red, and Teal flares.
• Zero-Allocation Core: Zero garbage collection pressure during gameplay using cached emitter lookups and pre-allocated player registries.
• In-Game Settings: Full integration with ModSettingsMenu.

🎮 Controls

(The shortcut key can be rebound in the Mod Settings menu under the Input section).

🚀 Installation

1. Install this package with your Thunderstore mod manager, or copy BigFirework.dll to:

   Big Walk/BepInEx/plugins/BigFirework/BigFirework.dll
   

2. Ensure BepInEx 6 IL2CPP and ModSettingsMenu (≥ 1.1.0) are installed.
3. Launch Big Walk as Host.
4. Press F10 to launch your first show!

⚙️ Settings

Open Mod Settings in the pause or main menu (or edit BepInEx/config/walker.bigfireworks.cfg):

Colors etc.

• Green / Yellow / Blue / Red / Teal: Burst count for each flare color per volley (0 to 20).
• LaunchHeight: Burst spawn height above player/anchor in meters (0m to 60m, default 2m).
• SpreadAngle: Angular cone spread from straight up in degrees (0° to 45°, default 8°).
• Interval: Seconds between burst beats (0.3s to 2.0s, default 0.8s).

Player Show

• Target: Self (launches from host) or Everyone (round-robins across all players).
• Follow: Follow the host as they move around during the show.
• Style: Sky (high altitude bursts) or Fountain (ground-level spray).
• FlareSounds: Play authentic flare explosion bang sounds in the air.
• Fast Night: Fast-forward time to night when the show begins.
• NightHour: Target night hour (default 0.0 = midnight).
• TransitionSpeed: Seconds to fast-forward into night (default 2.5s).
• RestoreDaylight: Smoothly restore daylight after show ends.
• RestoreDelay: Seconds to hold night after completion before sunrise (0s to 30s).
• Diagnostics: Write 1 Hz burst diagnostics to BepInEx log.

Firework Launcher

• Trigger: Off (vanilla), Accompany (rocket + show), or Replace (show instead of rocket).
• Show: FlareVolley, RocketSalvo, or GrandFinale.
• PadFrom: Pressed launcher or round-robin across All launchers.
• SalvoDelay: Seconds between salvo launches (0.2s to 2.0s).

Input

• Player Show: Rebindable hotkey (F10 by default).

💖 Credits

• M4TR!X GG — Thumbnail artwork and feedback
• Dexter — Testing and feedback
• Developed with BepInEx 6 IL2CPP & Harmony for Big Walk