<aside> <img src="/icons/reorder_gray.svg" alt="/icons/reorder_gray.svg" width="40px" />

Navigation

</aside>

🏠 Home Page

Getting Started

Architecture

Level System

Characters & Vehicles

Run Mechanics

World Objects

Boosters & Modifiers

Progression & Economy

UI

Save & Debugging

Modules

Publishing

Reference

💰 Monetization (Ads & IAP)

<aside> 💡 A booster is a temporary effect that the character gets by touching a booster pickup during a run. Boosters are ScriptableObjects, so a new booster needs no change in the character code.

</aside>

Subsystems

boosters-folder.png

booster-database.png

Booster fields

Field Description
Id Unique string id. It is also the effect id passed to PlayerController.OnEffectActivated.
Icon Icon shown on the booster cube and on the HUD.
Frame Material Material of the frame of the booster cube.
Drop Weight Weight of the booster in a Booster Box.
Activation Sound Sound played on activation.
Duration Timed boosters only. Seconds of the effect.

Types

Type Behavior
Timed Occupies a slot on the HUD until the duration ends. Picking up an active booster again refreshes the timer and does not apply the effect twice.
Instant Fires a one-shot effect and is never tracked as active.

Included boosters

Booster Class Type Effect
Turbo TurboBooster Timed, 8 s A rocket holds a constant speed: the speed at pickup plus Speed Boost, and at least Min Speed. A boost fire and a loop sound play.
Iron Skin IronSkinBooster Timed, 8 s Obstacles do not knock the speed back. A shield orbits the vehicle.
Vehicle Swap (Glider) VehicleSwapBooster Timed, 10 s Swaps the vehicle to the Plane Vehicle for the duration, with an optional speed burst.
Super Sled VehicleSwapBooster Timed, 10 s Swaps only the visual with the Super Sled Vehicle.
Coins Fever CoinsFeverBooster Instant Scatters visual coins and adds Coins Amount to the run coins when the last coin arrives.

Lifecycle

  1. The character touches a pickup. BoosterPickup calls BoosterController.Activate(booster, character).
  2. For a timed booster, the controller calls character.OnEffectActivated(id), booster.OnActivated(character) and plays the sound. It starts a timer.
  3. BoosterController.OnBoosterActivated fires. The HUD shows the slot.
  4. When the timer ends, booster.OnDeactivated(character) runs and OnBoosterDeactivated fires.
  5. A new run (PrepareRun) calls DeactivateAll, so no effect carries over to the next run.
  6. When the Game scene unloads, CancelAll drops the timers without reverting anything, because the character is destroyed.

BoosterController API

Member Description
Activate(booster, character) Activates a booster.
IsActive(booster) Checks whether a timed booster is active.
GetBoosterById(id) Finds a booster in the database.
DeactivateAll() Reverts all active timed boosters.
CancelAll() Drops all timers.
OnBoosterActivated(booster, duration) Event. The duration is 0 for an instant booster.
OnBoosterDeactivated(booster) Event.

Booster effect flash

On activation, the character flashes the Effect Flash Renderer with the Effect Flash Color. The effect is shared by all boosters.

Where boosters appear

Boosters are placed in a level as pickups. See Pickups.