Start New Game

New Game Button Hanlder Component

The Start New Game Component is responsible for creating a new profile and starting a fresh playthrough.

It defines what “New Game” means in a Hyper Save Engine project.

What does it do?

When triggered, the component will:

• Create a new profile with a unique identity

• Select the correct starter scene

• Initialize profile metadata (creation time, last scene, playtime)

• Optionally write an initial save stub

• Switch the active profile

• Load the game into a clean, isolated state

All of this happens without manual save logic.

When should you use it?

Use the Start New Game Component when:

• The player clicks New Game in the main menu

• You want to start a fresh story without affecting existing profiles

• You need multiple independent playthroughs in the same project

Each new game always results in a new profile.

Typical setup (UI)

Step 1 — Add the component

• Add NewGameButtonHandler to your menu object

Step 2 — Assign UI

• Assign the New Game button

• (Optional) Assign a profile name input field

Step 3 — Configure flow

• Set the starter scene

• Choose whether menus should rebuild before loading

• Enable or disable cloud sync behavior if used

That’s it.

No save logic is required.

Profile behavior

• New profile → a new story begins

• Existing profiles remain untouched

• Switching profiles is handled automatically

Profiles are isolated and self-contained by design

Advanced usage

The system also supports programmatic new game requests:

• Trigger a new game from code

• Override the starter scene

• Create profiles dynamically

This is useful for:

• Custom menu systems

• Debug tools

• Non-UI game flow

(Details are intentionally abstracted here — most projects never need manual control.)

Key takeaway

Starting a new game is not about clearing data.

It is about creating a new profile.

Once you understand this, New Game, Continue, and Multiple Stories all follow naturally.