unity-technologies/endlessrunnersamplegame

Purpose and Runtime

Unity 2019.3 mobile endless-runner sample game. The player selects a character/theme, runs an infinite lane-based track, avoids obstacles, collects currency/power-ups, completes missions, and can purchase content. Runtime is Unity/C# with the Universal/Lightweight Render Pipeline and Unity Addressables. Project launch scene ordering is defined in ProjectSettings/EditorBuildSettings.asset; principal scenes are Assets/Scenes/Start.unity, Assets/Scenes/Main.unity, and Assets/Scenes/Shop.unity.

Entry and Game-State Orchestration

GameManager is the central gameplay coordinator, using explicit state classes for loadout, tutorial, active play, and game-over transitions. UI start actions and scene loading hand off into this state machine; persistent player progress is represented by PlayerData.

• Assets/Scripts/GameManager/GameManager.cs

• Assets/Scripts/GameManager/GameState.cs

• Assets/Scripts/GameManager/LoadoutState.cs

• Assets/Scripts/GameManager/TutorialState.cs

• Assets/Scripts/GameManager/GameOverState.cs

• Assets/Scripts/PlayerData.cs

• Assets/Scripts/LevelLoader.cs

Runner Simulation: Player, Track, and Hazards

The active run connects input-driven character movement/collision to procedurally continued track segments and spawned obstacles. TrackManager/TrackSegment own the world progression boundary; obstacle subclasses encapsulate behavior variants. Pooler supports reuse of runtime objects rather than repeated allocation.

• Assets/Scripts/Characters/Character.cs

• Assets/Scripts/Characters/CharacterInputController.cs

• Assets/Scripts/Characters/CharacterCollider.cs

• Assets/Scripts/Tracks/TrackManager.cs

• Assets/Scripts/Tracks/TrackSegment.cs

• Assets/Scripts/Obstacles/Obstacle.cs

• Assets/Scripts/Pooler.cs

Progression, Pickups, and Consumables

Collectibles update run/progression state, while consumables provide temporary effects such as magnet, extra life, invincibility, and score multiplier. Character, theme, and consumable databases form content-selection boundaries between runtime gameplay and authored assets.

• Assets/Scripts/Coin.cs

• Assets/Scripts/Consumable/Consumable.cs

• Assets/Scripts/Consumable/ConsumableDatabase.cs

• Assets/Scripts/Consumable/Types/CoinMagnet.cs

• Assets/Scripts/Missions/Missions.cs

• Assets/Scripts/Characters/CharacterDatabase.cs

• Assets/Scripts/Themes/ThemeDatabase.cs

Content Delivery and Theming

Addressables replaces legacy asset bundles: groups split characters, coins, power-ups, UI, tutorial, and day/night theme resources for build/load management. Theme data points at environment, sky, zones, and obstacle prefab sets; default and nighttime are separate authored content variants.

• Assets/AddressableAssetsData/AddressableAssetSettings.asset

• Assets/AddressableAssetsData/AssetGroups/Characters.asset

• Assets/AddressableAssetsData/AssetGroups/Themes.asset

• Assets/Bundles/Themes/Default/themeData.asset

• Assets/Bundles/Themes/NightTime/themeData.asset

• Assets/Bundles/Characters/Cat/character.prefab

UI, Economy, and External Platform Services

Start/menu, mission, HUD, and shop controllers present and mutate player-owned content. Unity IAP is configured through Resources catalog files and handled by IAPHandler; ads are surfaced for mission flows. No backend service is evidenced in the supplied tree.

• Assets/Scripts/UI/MainMenu.cs

• Assets/Scripts/UI/MissionUI.cs

• Assets/Scripts/UI/Shop/ShopUI.cs

• Assets/Scripts/UI/Shop/IAPHandler.cs

• Assets/Scripts/UI/AdsForMission.cs

• Assets/Resources/IAPProductCatalog.json

Rendering, Audio, and Build Boundaries

The project uses URP assets plus custom world-curving shaders to create the runner’s visual depth. Audio is mixed through Unity’s mixer and controlled by runtime music components. Editor automation builds Addressables/content and player output; target-specific Addressables state exists for Android, Windows, and macOS.

• Assets/RenderingPipeline.asset

• Assets/Scripts/WorldCurver.cs

• Assets/Shaders/CurvedRotation.shader

• Assets/Scripts/Sounds/MusicPlayer.cs

• Assets/Sounds/Mixers/MainMix.mixer

• Assets/Editor/BundleAndBuild.cs