# Claimtime

## What is claimtime ?

> Whenever you host a giveaway using apollo, each user is given a set "claimtime" i.e the time that they have to claim the "set prize". Using apollo's advanced claimtime manager helps you to give extra claim time to set users/roles. In this section we will go through the details of the claimtime.
>
> Please refer to the [**overrides**](https://docs.apollo-bot.xyz/guides/overrides) section if you are not familiar with it as claimtime uses overrides.

## Subcommands for the Claimtime Module

### `a!claimtime`

> This command checks the claimtime for a user or a role. It gives the claimtime for a role and it gives the total claimtime for a user.

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2F0sj5qqSoguf1DtvwbRFu%2Fimage.png?alt=media&#x26;token=9cca3fcf-15cf-47cd-88d2-83feac432d87" alt=""><figcaption><p>claimtime for a member</p></figcaption></figure>

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2FCsLLazDMn3deNkQW3VkP%2F200B798B-3218-41FC-AF10-DD836EA92C8C.png?alt=media&#x26;token=a0565f28-9f14-40c2-abad-303c3205be23" alt=""><figcaption><p>claimtime for a specific role</p></figcaption></figure>

### Admin commands for the Claimtime Module

### `a!claimtime-admin add` (`/claimtime-admin add`)

> This command adds or updates a specific amount of time (claimtime) to the role mentioned. Use `s` for seconds, `m` for minutes and `h` for hours.

{% hint style="warning" %}
This only works for roles and cannot be set for specific users
{% endhint %}

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2F047q5eAhRJ9fyPYo9krW%2FEB5A431F-95EE-4E0A-A6CF-1837567B15BD.png?alt=media&#x26;token=c3523bcc-87be-477b-90c9-1a623036dca8" alt=""><figcaption><p>running the command will prompt you with an override selection. if you are unsure, please read our guide on <a href="overrides">overrides</a></p></figcaption></figure>

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2FrfF2WoFWOteROxZmmJzN%2F4D08C3D4-BF5B-4114-A359-B1FB24B45DDB.png?alt=media&#x26;token=c6236688-ee59-4cf8-9322-34a2623c14e3" alt=""><figcaption><p>once an override has been selected, the bot will acknowledge your selection</p></figcaption></figure>

### `a!claimtime-admin remove` (`/claimtime-admin remove`)

> This command removes the claimtime set for that particular role. Once this command is used on a role, the whole claimtime is deleted for that specific role completely.&#x20;

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2FGCjl0w7kNxs5c0tYkZhc%2F%7BA2BB8199-B48A-407B-BB09-0C7E43A1819D%7D.png?alt=media&#x26;token=3f9eea48-aeca-423c-bcce-0da5a0cd9e9a" alt=""><figcaption></figcaption></figure>

### `a!claimtime-admin display (/claimtime-admin display)`

> This command shows the configured claimtime for the roles in the server, however this command only shows the claimtime only for the configured roles as shown below.

<figure><img src="https://1529724062-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMamhYDlJn583lofv3ZTW%2Fuploads%2FZBrv2XGUMqJJ7gFeQaq5%2F%7BAEC4D014-89AD-4F81-AF46-9A421D4AA068%7D.png?alt=media&#x26;token=28ede369-0c07-48b7-b312-581f9515f66d" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Syntax usage:**

`<>` = Required argument (mandatory and must be included)

`[]` = Optional argument (not necessary to be included)
{% endhint %}
