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

# Activity tracking

> See who is really in your game, set quotas per rank, and show a leaderboard.

Activity tracking answers the question every staff team argues about: who is
actually turning up. A module in your Roblox game reports time in-server, and
Cove turns that into activity, quotas and a leaderboard.

<Frame caption="Time in game, tracked by the Cove module.">
  <img src="https://cdn.coveapp.cc/docs/images/game/activity.png" alt="My Activity" />
</Frame>

## Setting it up

<Steps>
  <Step title="Turn it on">
    **Settings → Activity & Quota**. Nothing is recorded until you do.
  </Step>

  <Step title="Install the loader">
    Cove gives you a short script to paste into your game. It pulls the
    tracking module from Cove, so the logic stays ours and can be fixed
    without you editing your place again.
  </Step>

  <Step title="Choose which ranks are tracked">
    Usually your staff ranks rather than every member of the group.
  </Step>
</Steps>

<Warning>
  Roblox only talks to HTTPS endpoints, and your game needs HTTP requests
  enabled in Game Settings. Without it the module reports nothing and the
  pages stay empty.
</Warning>

## What gets recorded

| Page        | Who sees it                              |
| ----------- | ---------------------------------------- |
| My Activity | Each member, their own total             |
| My Visits   | Each member, their own visits one by one |
| Leaderboard | The whole workspace, if enabled          |

Time appears within about a minute of somebody joining. The tracker sends a
heartbeat while they are in-server, so a session that ends because Roblox
crashed closes cleanly rather than counting forever.

## Quotas

A quota is a target per period, set per rank — the people who run your
community and the people who joined last week rarely owe the same time.

| Setting             | Options                                      |
| ------------------- | -------------------------------------------- |
| Minutes in game     | A target in your Roblox experience           |
| Messages in Discord | Counted by the bot, without reading anything |
| Period              | Per week or per month, resetting on its own  |
| Ranks               | A different target for each rank             |

Somebody on approved [leave](/team/leave) isn't expected to meet a quota while
they are away.

## Leaderboard

A ranked list of the workspace — first, second, third, and runners-up. It is on
by default and visible to everybody, because a leaderboard half the team can't
see isn't one. Turn it off and the page leaves the sidebar entirely rather than
sitting there refusing to open.

## Permissions

| Permission               | What it allows                                      |
| ------------------------ | --------------------------------------------------- |
| Change activity settings | Tracking, tracked ranks, quotas and the leaderboard |