Countdown Timer in Unity: Step-by-Step guide

Imagine your player has just entered a level. A message appears: “You have 60 seconds!” The clock starts ticking. Every second increases the tension, and when the timer reaches zero, the game ends.

That simple countdown can completely change the feel of a game.

Whether you are building a time-based challenge, racing game, puzzle, survival game, quiz, or speedrun mechanic, knowing how to add a countdown timer in Unity is an incredibly useful skill.

In this tutorial, we'll learn how to create a Unity countdown timer from scratch using C# and Unity UI. You'll learn how to display the remaining time, update it every second, stop it at zero, and trigger an action when the countdown finishes.

By the end, you'll have a reusable Unity timer script that you can customize for your own game.

What Is a Countdown Timer in Unity?

A countdown timer is a system that starts with a specific amount of time and continuously decreases until it reaches zero.

For example:

60 → 59 → 58 → 57 → ... → 3 → 2 → 1 → 0

In a game, a countdown timer can be used for:

Time-limited levels
Racing challenges
Bomb or survival mechanics
Puzzle games
Quiz games
Platformer challenges
Enemy waves
Power-ups
Respawn systems
Speedrun mechanics
Mission objectives

To create a basic countdown timer in Unity, we need three main components:

A timer variable
A UI element to display the time
A C# script that decreases the timer

How to Create a Countdown Timer in Unity

Let's build the timer step by step.

For this tutorial, we'll use Unity's standard UI Text component. The same basic logic can also be adapted for TextMeshPro.

Step 1: Create a New Unity Project

Open Unity Hub and create a new 2D or 3D project.

You can use any Unity project because the countdown logic works independently of whether your game is 2D or 3D.

Once the project opens, create a new scene and save it.

For example:

Scenes → GameScene

Now we're ready to create the timer UI.

Step 2: Create the Unity UI for the Timer

The player needs to see how much time is remaining, so we'll create a UI text element.

In the Unity Hierarchy:

Right-click → UI → Text

Depending on your Unity version, you may see Text - TextMeshPro instead. TextMeshPro is recommended for modern Unity projects.

If Unity asks you to import TMP Essentials, click Import TMP Essentials.

Rename the text object:

CountdownText

Now select the text object and position it near the top of the screen.

You can customize:

Font size
Font style
Color
Alignment
Position
Text size

For example, you could display:

Time: 60

This will eventually be updated automatically by our C# script.

Step 3: Create the Unity Timer Script

Now let's create the actual Unity C# timer.

In your Project window:

Right-click → Create → C# Script

Name the script:

CountdownTimer

Open the script and replace its contents with the following code:

using UnityEngine;
using TMPro;

public class CountdownTimer : MonoBehaviour
{
    public float timeRemaining = 60f;
    public TMP_Text countdownText;

    private bool timerIsRunning = true;

    void Update()
    {
        if (timerIsRunning)
        {
            if (timeRemaining > 0)
            {
                timeRemaining -= Time.deltaTime;
                DisplayTime(timeRemaining);
            }
            else
            {
                timeRemaining = 0;
                timerIsRunning = false;
                DisplayTime(timeRemaining);

                TimerFinished();
            }
        }
    }

    void DisplayTime(float timeToDisplay)
    {
        timeToDisplay += 1;

        float minutes = Mathf.FloorToInt(timeToDisplay / 60);
        float seconds = Mathf.FloorToInt(timeToDisplay % 60);

        countdownText.text = string.Format("{0:00}:{1:00}", minutes, seconds);
    }

    void TimerFinished()
    {
        Debug.Log("Countdown finished!");
    }
}

Let's understand what this Unity timer script is doing.

Step 4: Understanding the Countdown Timer Code

The Timer Variable

public float timeRemaining = 60f;

This stores the amount of time remaining.

The value is set to 60 seconds, but you can change it to any duration.

For example:

public float timeRemaining = 30f;

creates a 30-second countdown.

Or:

public float timeRemaining = 120f;

creates a two-minute countdown.

Using Time.deltaTime

One of the most important parts of the Unity C# timer is:

timeRemaining -= Time.deltaTime;

Time.deltaTime represents the amount of time that has passed since the previous frame.

Instead of subtracting a fixed number every frame, Unity subtracts the actual elapsed time.

This means the countdown behaves consistently even when the game's frame rate changes.

Without Time.deltaTime, your timer could run at different speeds depending on the player's frame rate.

Step 5: Display Minutes and Seconds

The timer needs to be converted into a format that players can easily understand.

This code handles that:

float minutes = Mathf.FloorToInt(timeToDisplay / 60);
float seconds = Mathf.FloorToInt(timeToDisplay % 60);

For example, if the remaining time is:

90 seconds

The UI displays:

01:30

If the remaining time is:

45 seconds

The UI displays:

00:45

This makes the Unity countdown timer look much more like the timers players see in finished games.

Step 6: Update the Timer UI

This line updates the text displayed on the screen:

countdownText.text = string.Format("{0:00}:{1:00}", minutes, seconds);

The {0:00} and {1:00} formatting ensures that the numbers contain two digits.

So instead of:

1:5

the timer displays:

01:05

This small formatting detail makes your game UI look much cleaner.

Step 7: Attach the Script to a GameObject

Now we need to connect the script to the Unity scene.

In the Hierarchy:

Right-click → Create Empty

Rename the GameObject:

GameManager

Select the GameManager and drag the CountdownTimer script onto it.

You'll now see the Countdown Timer component in the Inspector.

It should contain:

Time Remaining: 60

Countdown Text: None

The next step is to connect the UI.

Step 8: Connect CountdownText to the Script

Select the GameManager object.

In the Inspector, you'll see the Countdown Text field.

Drag your CountdownText UI object from the Hierarchy into this field.

Your setup should now look something like this:

GameManager
    └── CountdownTimer
          Time Remaining: 60
          Countdown Text: CountdownText

The script now knows which UI element it needs to update.

Step 9: Test the Unity Countdown Timer

Press the Play button in Unity.

You should see the timer start counting down:

01:00
00:59
00:58
00:57
...
00:03
00:02
00:01
00:00

Once the timer reaches zero, it stops.

You'll also see this message in the Unity Console:

Countdown finished!

Congratulations! You have created your first countdown timer in Unity.

How the Unity Timer Script Works

Let's look at the core logic again:

if (timeRemaining > 0)
{
    timeRemaining -= Time.deltaTime;
    DisplayTime(timeRemaining);
}
else
{
    timeRemaining = 0;
    timerIsRunning = false;

    DisplayTime(timeRemaining);
    TimerFinished();
}

The logic is simple:

Check whether there is time remaining.
Subtract elapsed time.
Update the UI.
Continue until the timer reaches zero.
Stop the timer.
Run an action when the countdown finishes.

This structure can be used for many different game mechanics.

How to Run an Action When the Timer Reaches Zero

A countdown timer becomes much more useful when something happens after the timer expires.

For example, perhaps you want to:

End the level
Show a Game Over screen
Load another scene
Spawn enemies
Stop player movement
Award points
Trigger an animation

You can put that functionality inside the TimerFinished() method.

For example:

void TimerFinished()
{
    Debug.Log("Time's up!");

    // Add your game logic here
}

You could also enable a Game Over panel:

public GameObject gameOverPanel;

void TimerFinished()
{
    gameOverPanel.SetActive(true);
}

Then drag your Game Over UI panel into the Game Over Panel field in the Inspector.

Now your timer can trigger a Game Over screen automatically.

How to Create a 30-Second Countdown Timer in Unity

Creating a shorter timer is extremely simple.

Change:

public float timeRemaining = 60f;

to:

public float timeRemaining = 30f;

Now the countdown starts at 30 seconds.

You could use this for a quick challenge:

00:30
00:29
00:28
...
00:02
00:01
00:00

How to Add a Start Timer to Your Unity Game

Sometimes you don't want the countdown to start immediately when the scene loads.

For example, you might want to show:

GO!

before the actual game begins.

To control when the timer starts, change:

private bool timerIsRunning = true;

to:

private bool timerIsRunning = false;

Then create a method:

public void StartTimer()
{
    timerIsRunning = true;
}

You can call StartTimer() from another script, button, or game event.

This gives you much greater control over your Unity timer system.

How to Pause a Countdown Timer in Unity

A useful feature is the ability to pause the timer.

You can add:

public void PauseTimer()
{
    timerIsRunning = false;
}

And to resume it:

public void ResumeTimer()
{
    timerIsRunning = true;
}

Now you can connect these methods to pause and resume buttons.

For example:

public void ToggleTimer()
{
    timerIsRunning = !timerIsRunning;
}

This switches the timer between running and paused states.

How to Change the Timer Color

You can make the timer visually react as the remaining time decreases.

For example, you may want the timer to become red when there are only 10 seconds left.

Add this inside the Update() method:

if (timeRemaining <= 10)
{
    countdownText.color = Color.red;
}

Now the timer becomes red during the final 10 seconds.

You can make this more dynamic:

if (timeRemaining <= 10)
{
    countdownText.color = Color.red;
}
else if (timeRemaining <= 30)
{
    countdownText.color = Color.yellow;
}
else
{
    countdownText.color = Color.white;
}

This creates a simple visual warning system for your Unity countdown timer.

Complete Unity Countdown Timer Script

Here is the complete version again so you can easily copy it into your project:

using UnityEngine;
using TMPro;

public class CountdownTimer : MonoBehaviour
{
    public float timeRemaining = 60f;
    public TMP_Text countdownText;

    private bool timerIsRunning = true;

    void Update()
    {
        if (timerIsRunning)
        {
            if (timeRemaining > 0)
            {
                timeRemaining -= Time.deltaTime;

                if (timeRemaining <= 10)
                {
                    countdownText.color = Color.red;
                }
                else if (timeRemaining <= 30)
                {
                    countdownText.color = Color.yellow;
                }
                else
                {
                    countdownText.color = Color.white;
                }

                DisplayTime(timeRemaining);
            }
            else
            {
                timeRemaining = 0;
                timerIsRunning = false;

                DisplayTime(timeRemaining);
                TimerFinished();
            }
        }
    }

    void DisplayTime(float timeToDisplay)
    {
        float minutes = Mathf.FloorToInt(timeToDisplay / 60);
        float seconds = Mathf.FloorToInt(timeToDisplay % 60);

        countdownText.text = string.Format("{0:00}:{1:00}", minutes, seconds);
    }

    void TimerFinished()
    {
        Debug.Log("Time's up!");
    }

    public void StartTimer()
    {
        timerIsRunning = true;
    }

    public void PauseTimer()
    {
        timerIsRunning = false;
    }

    public void ResumeTimer()
    {
        timerIsRunning = true;
    }
}

This gives you a flexible Unity timer script with:

Countdown functionality
UI updates
Minutes and seconds formatting
Timer completion detection
Color changes
Start functionality
Pause functionality
Resume functionality

Common Mistakes When Creating a Countdown Timer in Unity

Even a simple Unity C# timer can cause problems if a few details are overlooked.

1. Forgetting to Assign the UI Text

If Countdown Text is empty in the Inspector, Unity may generate a NullReferenceException.

Make sure you drag the UI text object into the script's Countdown Text field.

2. Letting the Timer Go Below Zero

Always make sure the timer is set to zero when it finishes:

timeRemaining = 0;

Otherwise, you may end up displaying negative values.

3. Not Using Time.deltaTime

Avoid code such as:

timeRemaining -= 1;

inside Update().

Update() runs once per frame, so this would make the timer dependent on the game's frame rate.

Instead, use:

timeRemaining -= Time.deltaTime;

4. Forgetting to Stop the Timer

Once the timer reaches zero, stop it:

timerIsRunning = false;

Otherwise, your completion logic could potentially run repeatedly.

Ideas for Using a Countdown Timer in Your Game

Once you know how to create a timer in Unity, you can use it for much more than simply displaying seconds.

Racing Games

Give players 60 seconds to complete a track.

Puzzle Games

Give players a limited amount of time to solve a puzzle.

Survival Games

Spawn increasingly difficult enemies as the timer progresses.

Quiz Games

Give players 10 seconds to answer each question.

Platformers

Challenge players to reach the finish line before time runs out.

Power-Ups

Create temporary abilities that disappear after a specific duration.

Mission Games

Give players a limited amount of time to complete an objective.

The same basic Unity countdown timer logic can be adapted to all of these situations.

Frequently Asked Questions About Unity Countdown Timers

How do I add a countdown timer in Unity?

Create a UI Text or TextMeshPro element, create a C# timer script, subtract Time.deltaTime from the remaining time inside Update(), and update the UI with the remaining minutes and seconds.

How do I create a timer in Unity using C#?

You can create a float variable to store the remaining time and decrease it using:

timeRemaining -= Time.deltaTime;

Then display the value through a Unity UI text component.

What is Time.deltaTime used for in a Unity timer?

Time.deltaTime represents the time that has passed since the previous frame. Using it allows the timer to decrease according to real elapsed time rather than the number of frames rendered.

Can I create a countdown timer without using a plugin?

Yes. You can create a basic Unity countdown timer entirely with C# and Unity's built-in UI systems.

How can I make the timer stop at zero?

Check whether the remaining time is greater than zero. When it reaches zero, set it explicitly to zero and stop the timer:

timeRemaining = 0;
timerIsRunning = false;

How can I display minutes and seconds in Unity?

You can use:

float minutes = Mathf.FloorToInt(timeToDisplay / 60);
float seconds = Mathf.FloorToInt(timeToDisplay % 60);

Then format the values as:

string.Format("{0:00}:{1:00}", minutes, seconds);

Can I use TextMeshPro for a Unity timer?

Yes. TextMeshPro is a great choice for displaying a countdown timer. You can reference it using:

using TMPro;

and:

public TMP_Text countdownText;

How do I trigger Game Over when the timer reaches zero?

Put your Game Over logic inside the method that runs when the countdown finishes:

void TimerFinished()
{
    // Show Game Over screen
}

You can then activate a Game Over panel, load another scene, or trigger another gameplay event.

Conclusion

Creating a countdown timer in Unity doesn't have to be complicated. With a simple C# script, a UI text element, and Time.deltaTime, you can build a reliable timer that works across many types of games.

In this tutorial, we covered how to add a countdown timer in Unity, including how to:

Create a timer UI
Write a Unity C# timer
Build a reusable Unity timer script
Display minutes and seconds
Start and pause the timer
Stop the timer at zero
Trigger an event when time runs out
Change the timer's color
Create a Game Over event

Once you understand the basic timer system, you can take it much further by adding sound effects, animations, warning effects, progress bars, pause menus, and other gameplay mechanics.

So, start with the simple Unity countdown timer from this tutorial and customize it to fit your game's mechanics. A ticking clock might be a small feature, but it can add a surprising amount of tension and excitement to gameplay.

How to Add a Countdown Timer in Unity: Step-by-Step Guide

Countdown Timer in Unity: Step-by-Step guide

What Is a Countdown Timer in Unity?

How to Create a Countdown Timer in Unity

Step 1: Create a New Unity Project

Step 2: Create the Unity UI for the Timer

Step 3: Create the Unity Timer Script

Step 4: Understanding the Countdown Timer Code

Step 5: Display Minutes and Seconds

Step 6: Update the Timer UI

Step 7: Attach the Script to a GameObject

Step 8: Connect CountdownText to the Script

Step 9: Test the Unity Countdown Timer

How the Unity Timer Script Works

How to Run an Action When the Timer Reaches Zero

How to Create a 30-Second Countdown Timer in Unity

How to Add a Start Timer to Your Unity Game

How to Pause a Countdown Timer in Unity

How to Change the Timer Color

Complete Unity Countdown Timer Script

Common Mistakes When Creating a Countdown Timer in Unity

1. Forgetting to Assign the UI Text

2. Letting the Timer Go Below Zero

3. Not Using Time.deltaTime

4. Forgetting to Stop the Timer

Ideas for Using a Countdown Timer in Your Game

Racing Games

Puzzle Games

Survival Games

Quiz Games

Platformers

Power-Ups

Mission Games

Frequently Asked Questions About Unity Countdown Timers

How do I add a countdown timer in Unity?

How do I create a timer in Unity using C#?

What is Time.deltaTime used for in a Unity timer?

Can I create a countdown timer without using a plugin?

How can I make the timer stop at zero?

How can I display minutes and seconds in Unity?

Can I use TextMeshPro for a Unity timer?

How do I trigger Game Over when the timer reaches zero?

Conclusion

You Might Like

Contact form