Skip to content

Installation

Shape Storm works out of the box - import, open a scene, and hit play. This guide walks you through the setup process.

Prerequisites

  • Unity Version: 2021.3 LTS or newer recommended
  • Platform: Windows, macOS, or Linux
  • Build Targets: Standalone (Windows/Mac/Linux) and WebGL supported

Installation Steps

Step 1: Import the Package

Import Shape Storm through Unity’s Package Manager:

  1. Open your Unity project
  2. Navigate to Window > Package Manager
  3. Click on My Assets
  4. Search for the Shape Storm package
  5. Click on Import to project to add the project files

Unity Package Manager import screen

Step 2: Locate the Scenes

After import, find the Shape Storm scenes in your project:

ShapeStorm/
├── Audio/ # Music tracks and sound effects
├── Fonts/ # Typography assets
├── Post Processing/ # Visual effects and post-processing profiles
├── RetroDev/ # Random utility package for RNG
├── Scenes/ # Game scenes (Menu, Loading, Game)
├── Scripts/ # All game logic and behavior scripts
└── Sprites/ # Visual assets and sprite sheets

Step 3: Add Scenes to Build Settings

For the game to function properly, all three scenes must be in your build settings:

  1. Open File > Build Settings
  2. Drag these scenes into the “Scenes In Build” list in this order:
    • Menu.unity (Index 0)
    • Loading.unity (Index 1)
    • Game.unity (Index 2)

Build settings with scenes added

Step 4: Open the Menu Scene

  1. In the Project window, navigate to Assets/Scenes
  2. Double-click Menu.unity to open it

Step 5: Hit Play

Click the Play button in the Unity editor. You should see:

  1. Splash screens (if enabled)
  2. Main menu with the Shape Storm logo and background
  3. Click “Start” to enter shape selection
  4. Choose a ship shape
  5. Loading screen with randomized hints
  6. Gameplay with your selected ship

Game running in play mode

Platform-Specific Notes

WebGL Builds

  • Background videos require URLs instead of video clips
  • Set video URLs in the MainMenu component’s “WebGL Video URL” field
  • Test in a web server environment, not by opening the HTML file directly

Standalone Builds

  • All features work without modification
  • Background videos use VideoClip assets directly
  • Controllers automatically detected and supported

Troubleshooting

Scene Transitions Don’t Work

  • Verify all three scenes are in Build Settings
  • Check scene order: Menu (0), Loading (1), Game (2)
  • Ensure scene names match exactly

No Audio Playing

  • Check Audio Listener is present in each scene’s main camera
  • Verify audio clips are assigned in the AudioManager
  • Check volume sliders in the settings menu

Player Won’t Move

  • Verify Input System settings in Edit > Project Settings > Input Manager
  • Check if the Controls component has key bindings assigned
  • For controller: ensure controller is detected before starting the game

Missing References in Inspector

  • This usually means prefabs or assets weren’t imported
  • Re-import the package
  • Check console for specific missing asset errors

Next Steps

Now that Shape Storm is running, you’re ready to customize it:


Need Help? If you encounter issues not covered here, reach out at [email protected]