# start

{% tabs %}
{% tab title="Aliases" %}
gwstart, giveawaystart
{% endtab %}

{% tab title="Cooldown" %}
30 seconds
{% endtab %}

{% tab title="Permissions" %}

* `MANAGE_SERVER:` The discord user running the command should have at least this permission in the giveaway server.
  {% endtab %}

{% tab title="Requirements" %}

* `VIEW_CHANNEL:` Nyaru should be able to view the giveaway channel.
* `SEND_MESSAGES:` Nyaru should be able to send the giveaway message.
* `EMBED_LINKS:` Nyaru should be able to send giveaway embeds in the giveaway channel.
* `MANAGE_MESSAGES:` Nyaru should have this permission to control giveaway reactions.
  {% endtab %}
  {% endtabs %}

## Usage <a href="#usage" id="usage"></a>

`@Nyaru gstart`` `<mark style="color:orange;">`<Duration>`</mark> <mark style="color:yellow;">`<Winner Count>`</mark> <mark style="color:blue;">`<Giveaway Prize>`</mark>

`/giveaway start`` `<mark style="color:orange;">`<Duration>`</mark> <mark style="color:blue;">`<Giveaway Prize>`</mark>` `<mark style="color:purple;">`<Channel>`</mark>

## Example

`@Nyaru gstart`` `<mark style="color:orange;">`1d`</mark> <mark style="color:yellow;">`1`</mark> <mark style="color:blue;">`Nitro Basic`</mark>

`/giveaway create`` `<mark style="color:orange;">`duration:20h 10m`</mark> <mark style="color:blue;">`prize:Nitro Basic`</mark> <mark style="color:purple;">`channel:general`</mark>

## Giveaway Options <a href="#giveaway-options" id="giveaway-options"></a>

### Duration

Provide the giveaway duration. Ensure the duration is between 30 seconds and 1 year.

Duration can be defined as 10h (10 hours), or 20m (20 minutes)

### Winner Count

Provide the number of giveaway winners. Ensure winners are less than 20.

> Winner Count is only necessary in `gstart` message command and not mandatory in slash command. It defaults to 1 winner automatically.

### Giveaway Prize

Provide the giveaway prize. Ensure the prize character limit is 100.

### Channel

Provide the giveaway channel or channel ID where the giveaway should be hosted.

> Channel is only necessary in slash command and not mandatory in normal (prefix) command. It defaults to the message channel automatically.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nyaru.xyz/giveaways/gstart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.