<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> 💡 Common questions and errors. Each answer links to the page with the full explanation.

</aside>

Starting the game

Question or message Answer
Play from a level scene shows nothing or an error. A level scene has no GameController, UI or camera. Press Play with the level scene open and the template starts through Init → Game. Check that Auto Load Initializer is enabled in Core Settings. See ‣.
GameData is null. Please add the Game Settings component to the Project Init Settings and link Game Data scriptable object. The Game Settings module is missing in Project Init Settings or has no Game Data asset. See ‣.
[GameController]: levelsDatabase not assigned. Assign the Levels Database to GameController in the Game scene.
The wrong level starts. The saved level wins over Level Index. In the Editor, an open level scene overrides both. Clear the save with Edit → Clear Save. See ‣.
[BoosterController]: Not initialized. Add BoosterInitModule to the ProjectInitSettings modules list. Add Boosters to Project Init Settings. The same for PreRunModifiers.
A module is initialized before the module it needs. Move it below that module in Project Init Settings.

Levels

Question or message Answer
No active StartPoint found in scene The level scene has no enabled Start Point. The same for Finish Point. See ‣.
Multiple active ... components found Disable all but one Start Point or Finish Point.
The start or the progress bar is wrong after moving the points. Save the level scene. The Level Scene Controller bakes the references on save.
Objects far from the character do not move or animate. They are outside Active Chunk Radius. Save the scene after adding objects with IChunkActivatable. See ‣.
Two levels share collected pickups and the record. The ids are the same, usually after duplicating a Level asset. Reset the Id of the copy.
A new level is missing in the build. Add its scene to the Build Settings. See ‣.
The test Database_ContainsEveryLevelAssetInProject fails with Level asset(s) exist but aren't registered in LevelsDatabase. Add the Level to the Levels Database.
The Level Builder says Scene 'X' has no SlopeLevelLayout. The builder works only for scenes that have a layout. See ‣.
Root object 'Terrain' not found The scene lacks a root object that the builder needs: Terrain, Props, World Objects, Start Point, Finish Point.
A rebuild changed the shared bridge or landmark prefabs. Rebuild All and Rebuild Bridge rewrite them. Use a single step command.

Characters and upgrades

Question or message Answer
The character does not move after the launch. The Character prefab has no Default Vehicle, or the movement behavior never changes the velocity. See ‣.
[Perks]: Upgrade with type X isn't registered! The Character misses an upgrade for that role. Assign the three upgrades. See ‣.
A purchased upgrade has no effect. The effect is read when the vehicle behavior is created at the start of a run. Start a new run.
The upgrade progress is shared between two levels. The levels link the same Character. Create a separate Character and upgrade assets.
A new vehicle does not leave tracks. The terrain material needs the Watermelon/Terrain Toon shader and at most four terrain layers per tile. See ‣.
The vehicle can turn back to the start. Steer with character.LimitTurn. See ‣.

Boosters and pickups

Question or message Answer
[Boosters]: No booster with id 'X' in ... The id is missing in the Booster Database.
A booster pickup gives nothing. The Booster field is empty, or the booster is not in the database.
A pickup does not react. The collider must be a trigger, on the Pickup layer. The Pickup layer collides only with the Player layer.
A coin comes back every run. Disable After Pickup is off. Turn it on for a one-time coin.
The active booster HUD does not show a booster. All slots are in use. Add slots to ActiveBoosterHUD.

UI

Question or message Answer
A new page never opens. The page is not under the UI Main Canvas, or NotifyOpened() is not called. See ‣.
The x2 button is missing. The rewarded video is not loaded. With the Dummy provider, check Ads Settings.
The Privacy, Terms or Restore buttons are hidden. The link is empty in Ads Settings, or the module is not enabled.
The settings popup animation freezes in the game. A pause popup runs with Time.timeScale at 0. Use unscaled time in the animation.

Ads and purchases

Question or message Answer
Ads do not show in the build. Active Provider is Dummy. See ‣.
Purchases do not work. The product ids are the placeholders com.example.noads, or the MODULE_IAP define is not set.
The No Ads button stays after the purchase. UIStartScreen refreshes it on AdsManager.ForcedAdDisabled. Check that the purchase completed.

Save and logs

Question or message Answer
How do I reset the progress? Edit → Clear Save.
How do I start with a prepared state? Use Save Presets. See ‣.
A save was lost after a class rename. Add [SaveKey("name")] to the save class before the first release. See ‣.
The console has no game logs. Enable the categories in Actions → Log Categories. See ‣.
A play test changed my saved level. Tests use the real save. Clear it or load a preset afterwards.

Performance

Question Answer
How can I reduce the level cost? Put small decor under the Props root, so it is distance-culled. Keep Active Chunk Radius as small as the camera allows. Use the GPU-instanced grass.