> For the complete documentation index, see [llms.txt](https://mango-5m.gitbook.io/mango5m-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mango-5m.gitbook.io/mango5m-docs/resources/mango-achievements/features/time-limited-awards.md).

# Time-Limited Awards

Awards that can only be earned at certain times.

Any award can be limited to a time of day, days of the week, a date range, or any combination — checked against **your server's clock**, so a player changing their own clock achieves nothing.

```lua
window = {
    hours = { from = '00:00', to = '05:00' },            -- may wrap midnight
    days  = { 'sat', 'sun' },
    dates = { from = '2026-09-01', to = '2026-09-30' },  -- inclusive
},
```

Use any part, or any combination. All parts present must pass.

## Examples

{% tabs %}
{% tab title="Night Owl" %}

```lua
{
    id     = 'night_owl',
    name   = 'Night Owl',
    stat   = 'session_start',
    goal   = 1,
    window = { hours = { from = '00:00', to = '05:00' } },
}
```

`session_start` fires on every character load, which is what "join during…" awards hang off.
{% endtab %}

{% tab title="Weekend Warrior" %}

```lua
{
    id     = 'weekend_warrior',
    stat   = 'playtime_minutes',
    goal   = 120,
    window = { days = { 'sat', 'sun' } },
}
```

Playtime only accumulates toward this award on a Saturday or Sunday.
{% endtab %}

{% tab title="Founder" %}

```lua
{
    id     = 'mango_founder',
    stat   = 'session_start',
    goal   = 1,
    window = { dates = { from = '2026-09-01', to = '2026-09-30' } },
}
```

Any login during the opening month earns it. Afterwards it can never be earned again — the point of a founder award.
{% endtab %}
{% endtabs %}

{% hint style="warning" %}
Progress arriving outside the window is **ignored, not banked**. "Join between midnight and 5am" cannot be topped up at noon.
{% endhint %}

The window is shown on the award's row in the menu. `/achievementgive` bypasses it, as it bypasses prerequisites.

A malformed window is reported against the award id when the resource starts and that part is dropped, so a typo never locks an award away forever.

## Session-only awards

`session = true` means progress is never saved and starts at zero every session — for "…without disconnecting" awards like Most Wanted.