> ## Documentation Index
> Fetch the complete documentation index at: https://mbcz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quests and rewards

> YAML quests, daily claims, playtime, and vote hooks.

Retention is two layers: lightweight quests (`/quest`) and timed rewards (`/daily`, `/weekly`, `/monthly`, `/playtime`). Lifesteal and Economy presets turn quests on.

## Quests

```text theme={null}
/quest
/quest claim <id>
```

The 54-slot desk uses catalog chrome. Filter ALL / READY / ACTIVE / CLAIMED. Sort by name or progress. Click a **ready** tile to claim. There is no slot-46 action button.

<Frame>
  <img src="https://mintcdn.com/mbcz/rS3T1Jj6YIDtgdo5/images/smply/thumb-quests.png?fit=max&auto=format&n=rS3T1Jj6YIDtgdo5&q=85&s=bbbd0ec369bca8a4822d196f2f17200b" alt="Quests gallery card" width="1280" height="720" data-path="images/smply/thumb-quests.png" />
</Frame>

Shipped types: `kill_players`, `break_blocks`, `play_minutes`. Economy quests include harvest / sell / auction style objectives. Configure ids, amounts, reset period, and reward commands in `quests.yml`.

Permission: `smply.quest.use`. This is not a full quest-suite replacement.

## Daily, weekly, monthly, playtime

```text theme={null}
/daily
/weekly
/monthly
/playtime
```

Each reward runs console commands from `rewards.yml`. Defaults use vanilla `give` so a fresh install does not need crates or Vault.

Placeholders in those commands: `{player}`, `{claim_count}`, `{streak}`.

Daily streaks reset after `streaks.reset_after_hours` (default 48). Milestone commands fire at 3 / 7 / 30 day streaks in the shipped file.

Vote plugins should call from console:

```text theme={null}
/smply reward vote <player>
```

Permission: `smply.reward.grant`. Same command grants `daily`, `weekly`, or `monthly` for testing.

<Frame>
  <img src="https://mintcdn.com/mbcz/rS3T1Jj6YIDtgdo5/images/smply/thumb-rewards.png?fit=max&auto=format&n=rS3T1Jj6YIDtgdo5&q=85&s=9ef862efdf5e08deda421061d3fd6a12" alt="Daily rewards gallery card" width="1280" height="720" data-path="images/smply/thumb-rewards.png" />
</Frame>

## Leaderboards

```text theme={null}
/leaderboards
```

Category picker is 27 slots (Back at 22). Opening a board uses the 54-slot catalog chrome. Categories include hearts, Vault balance, kills, and deaths when those modules or Vault are on.

<Frame>
  <img src="https://mintcdn.com/mbcz/rS3T1Jj6YIDtgdo5/images/smply/thumb-leaderboards.png?fit=max&auto=format&n=rS3T1Jj6YIDtgdo5&q=85&s=e1de3c341063964541b23738199742fd" alt="Leaderboards gallery card" width="1280" height="720" data-path="images/smply/thumb-leaderboards.png" />
</Frame>