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

# Giveaways

> Host engagement-driven giveaways with role requirements and custom prizes.

## Overview

greed's giveaway system is built for high engagement. It supports buttons for easy entry, role-based requirements, and full customization of the giveaway embed.

## Starting a Giveaway

Create a giveaway by specifying the duration, winner count, and the prize.

<CodeGroup>
  ```javascript Syntax theme={null}
  ,giveaway start (duration) (winners) (prize) @Role
  ```

  ```javascript Example theme={null}
  ,giveaway start 1h 2 Nitro @Supporter
  ```
</CodeGroup>

<Frame>
  <img src="https://mintcdn.com/emogirlsllc/X-qcKaA3AtknmTs2/images/image1%5B1%5D.png?fit=max&auto=format&n=X-qcKaA3AtknmTs2&q=85&s=90f54c0a20eb1b06b6d4e5f9bf1c3803" alt="Image1[1]" width="720" height="409" data-path="images/image1[1].png" />
</Frame>

<Info>
  **Role Requirements**: Use the `,giveway blacklist (role)` flag to restrict the giveaway to members with a specific role.
</Info>

***

## Giveaway Management

Control your active giveaways with these subcommands.

### Basic Controls

<AccordionGroup>
  <Accordion title="Ending & Rerolling">
    * `,giveaway end (message_id)`: Force a giveaway to end immediately.
    * `,giveaway reroll (message_id)`: Pick new winners for a finished giveaway.
  </Accordion>

  <Accordion title="User Restrictions">
    * `,giveaway blacklist @user`: Prevent a specific user from entering giveaways.
    * `,giveaway setmax (role) (max enteries)`: Limit how many giveaways a user can win in a certain timeframe.
  </Accordion>
</AccordionGroup>

### Editing Giveaways

You can modify an active giveaway's details without needing to restart it.

<AccordionGroup>
  <Accordion title="Core Details">
    * `,giveaway edit prize (message_id) (new prize)`: Update the prize description.
    * `,giveaway edit winners (message_id) (count)`: Change the number of winners to be selected.
    * `,giveaway edit duration (message_id) (new duration)`: Adjust the time remaining.
  </Accordion>

  <Accordion title="Visuals & Text">
    * `,giveaway edit description (message_id) (text)`: Add or change the giveaway description.
  </Accordion>
</AccordionGroup>

***

## Technical Details

* **Participation**: Users enter by clicking the "Enter" button on the giveaway message.
* **Winner Selection**: greed uses a cryptographically secure random number generator to ensure fair winners.
* **Notifications**: greed can DM the giveaway creator and the winners when the giveaway ends.