# Gamification
Oobeya’s **Gamification** module provides a point-based competitive structure to boost engineering team performance. It visualizes progress, increases motivation, and highlights achievements. With this feature, you can create leagues, define performance metrics (Engineering KPIs), compare team scores, and reward high performance.
Oobeya Gamification Module
***
### Key Concepts
* **League**: A competition structure where teams collect points based on defined metrics.
* **Round**: Scoring periods executed at specific intervals (e.g., weekly, biweekly, monthly).
* **Referees**: Authorized users who supervise manual scoring and can update and approve results.
* **Points**: Numeric values assigned automatically or manually based on defined thresholds for KPIs.
***
### How It Works
Create New League - step by step
{% stepper %}
{% step %}
### **1. League Setup**
Create a new league via:\
**Gamification > Leagues Management > New League**
Required fields:
* **League Name** and **Description**
* **Referees**: Minimum 1, maximum 5 users
* **Scoring Interval**: Weekly, biweekly, or monthly
* **Start / End Date** (optional)
* **League Logo** (optional)
{% hint style="info" %}
⚠️ If an end date is provided, it must be at least 28 days after the start date and no more than 365 days. If left empty, the league runs indefinitely.
{% endhint %}
{% endstep %}
{% step %}
**Metric Selection**
Metric Selection
Select which performance metrics will be scored. Categories include:
* **Project Management** (e.g., Lead Time, Predictability)
* **Development** (e.g., Rework Rate, Coding Efficiency)
* **Code Review**
* **Code Quality**
* **Security**
* **Symptoms**
{% hint style="info" %}
These metrics will be used for **automatic scoring**.
{% endhint %}
{% endstep %}
{% step %}
**KPI Scoring**
KPI Scoring
Define scoring thresholds for each metric. Example:
* Cycle Time < 3 days → 3 points
* 3–10 days → 1 point
* ≥10 days → 0 points
{% hint style="warning" %}
Ensuring logical consistency of thresholds is the user’s responsibility.
{% endhint %}
{% endstep %}
{% step %}
**Manual KPIs (Optional)**
Manual KPIs
Define custom KPIs that will be scored manually by referees.
Each manual KPI requires:
* Label (Name)
* Description
* Maximum Points
{% endstep %}
{% step %}
**Team Selection**
Team Selection
Select which teams will participate in the league. Only teams with data available for the selected metrics can be added.
{% endstep %}
{% step %}
**Final Review and Start**
Review all settings and click **Create League** to launch.
{% endstep %}
{% endstepper %}
***
#### Round Management:
Each league generates a scoring **round** automatically based on the selected interval.
League referees manage rounds via:\
**League Management > Manage Rounds**
Manage Rounds
**Round Details:**
* **Round Date**: The date when scores are calculated.
* **States**:
* `Scheduled for the next round`
* `In Progress`
* `Pending Approval`
* `Approved`
* `Failed`
* `Cancelled`
Referees can **review, edit, and approve** round scores.
***
#### ✏️ Update Scores
Update Scores for a round
For each KPI, referees can:
* View the actual value (Value)
* Check the automatically calculated score (Calculated Score)
* Manually update scores if needed (Update)
* Approve scores (Approve)
> Use the **Recalculate** button (top right) to refresh all automatic scores.
***
#### 📊 Leaderboard
Leaderboard
The leaderboard displays team rankings based on their total points:
* Track progress over time
* View historical rounds
* See which metrics contributed to team scores.
***
#### 🔐 Authorization
The following actions can only be performed by authorized users:
* Creating and editing leagues (Role: Gamification Admin)
* Defining metrics and scoring rules (Role: Gamification Admin)
* Approving round results (Role: League Referee)
Manage user roles
---
# 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://docs.oobeya.io/gamification/gamification.md?ask=
```
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.
