<aside> <img src="/icons/reorder_gray.svg" alt="/icons/reorder_gray.svg" width="40px" />
Navigation
</aside>
<aside> 💡 Common questions and errors. Each answer links to the page with the full explanation.
</aside>
| 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. |
| 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. |
| 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 ‣. |
| 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. |
| 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. |
| 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. |
| 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. |
| 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. |