# Gamification Bar

<figure><img src="/files/xHK9no7V3ZEEKawEX3Xp" alt=""><figcaption></figcaption></figure>

The **Gamification Bar** is a dynamic component in UFOLAB that enhances gameplay by integrating interactive elements such as a **countdown/timer**, **progress bar**, and **points system**. These elements are crucial in adding engagement and challenge to your game. Below is a breakdown of each feature.

You can use it just adding the **Gamification Bar**  by dragging it into your scene.

<figure><img src="/files/N776sY5d5fi0rNXBAuxW" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
The location where the gamificatin bar is placed when you drag it into any scene on the Interface Layer (![](/files/9sqyT2UquFvzmDPRZkX4)), will remain during all the game from the scene it's set up to be shown initially and until the gameover scene, at the exact same position.
{% endhint %}

### Elements in the gamification bar

There are 3 elements, and you can decide whether use just one, two or all of them.

**1. Countdown/Timer**

* **Purpose**: adds a sense of urgency to the game, encouraging players to complete tasks within a limited time frame.
* **Usage Example**: Useful in scenarios where players need to solve puzzles or complete challenges within a time limit.\
  \
  In advanced option you can select in which scene the gamification bar starts.

{% hint style="info" %}
When the countdown ends the game finishes and takes the player to the gameover scene. It is mandatory to keep this scene created in the game if you use the Countdown.
{% endhint %}

**2. Progress Bar**

* **Purpose**: Visually tracks the player’s progress throughout the game.
* **Usage Example**: Particularly helpful for games with multiple stages or challenges, showing how far the player has progressed through the game.

**3. Points System**

* **Purpose**: Tracks and displays points that players accumulate based on their actions and performance within the game.
* **Usage Example**: Ideal for quiz-style games or educational scenarios where players are rewarded for correct answers and deducted points for incorrect ones.

{% hint style="info" %}
Points need to be defined along the game in the actions linked to components and/or puzzles and minigames.
{% endhint %}

### How to Configure and Use the Gamification Bar

* **Step 1**:  navigate to the left-hand panel and select the **Gamification Bar** option from the list of components.
* **Step 2**: drag it onto the scene placing it on the Interface Layer (![](/files/9sqyT2UquFvzmDPRZkX4)), this way it will appear in all the scenes of the game.
* **Step 3**: customize the size and behaviour of each element using the options in the top menu.
* **Step 4**: set specific actions that should happen when the player interacts with these components. For example, when the timer ends, the game can cause a scene change or a points deduction.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.theufolab.com/game-editor/components/gamification-bar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
