> For the complete documentation index, see [llms.txt](https://docs.qrbase.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.qrbase.xyz/for-partners/scan-mode-campaign.md).

# Scan Mode campaign

Run a full community campaign with a USDC prize pool.

***

A Scan Mode campaign builds on a token listing by adding a community-driven reveal mechanic. Collective puzzle activity progressively uncovers a hidden QR code, which eligible players can scan to claim a USDC prize once fully revealed.

### Campaign setup

| Setting               | Description                                                                                              |
| --------------------- | -------------------------------------------------------------------------------------------------------- |
| Reward pool           | Total USDC allocated for the campaign, split between winners                                             |
| Number of winners     | How many eligible players receive a share of the prize pool                                              |
| Campaign games        | Target delivery volume — the number of puzzles that need to be generated to fully deliver the campaign   |
| Eligibility rules     | Conditions players must meet to claim — token holding, puzzle solves, level requirement, task completion |
| Promoted task or link | A task or external link featured in the campaign (e.g. follow a profile, visit a page)                   |
| Rounds                | After Round 1 ends, Round 2 begins with a fresh milestone cycle                                          |

#### **How delivery works**

Scan Mode progress is based on delivered games, not wins.

```
1 generated puzzle while the campaign is active
= 1 consumed play from the campaign pack
= 1 delivered campaign game
```

Progress is tracked as `delivered_games / target_games`.

While a Scan Mode campaign is active, general puzzle packs on the same token pause automatically. They resume in FIFO order once the campaign ends.

#### **Milestone schedule**

Delivered games progressively unlock tiles of the hidden QR. The milestone schedule is set per campaign — exact thresholds depend on the project and campaign configuration. Once all 9 tiles are revealed, eligible players can scan the QR and claim from the prize pool.

#### **Eligibility and claims**

Campaign delivery and claim eligibility are tracked separately. Even after full delivery, players must meet all campaign conditions to claim: token holding requirements, puzzle solves, task completion, level threshold, and anti-cheat checks. Only users who meet all conditions can claim when the campaign opens.

{% hint style="success" %}
Scan Mode is the highest-engagement product in QRbase. It creates urgency, drives holding, and rewards your most committed community members.
{% endhint %}