36 lines
1.6 KiB
Markdown
36 lines
1.6 KiB
Markdown
# Giveaways
|
||
|
||
Button/reaction giveaways drawn locally in the runner.
|
||
|
||
Drawn in the runner with buttons. The winner is posted to the channel (interaction tokens expire after 15 minutes). If the tab dies mid-giveaway, pending draws resume only after the runner is reopened while the end time is still in the future.
|
||
|
||
## How to enable
|
||
|
||
1. Open **Studio → your bot → Modules**.
|
||
2. Find **Giveaways** (`giveaways`) and turn it **On**.
|
||
3. Fill settings. Channel and role fields are Discord snowflakes, not names.
|
||
4. Disable individual slash commands if you are near Discord’s 100-command cap.
|
||
5. **Reload the runner tab** so the client re-registers slash commands. Global command updates can take up to an hour; guild-less register in TabBot is application-wide.
|
||
|
||
## Required intents
|
||
|
||
_None beyond what you already set on the bot._
|
||
|
||
Privileged intents (Message Content, Server Members, Presence) must also be enabled on the Discord application. TabBot cannot flip the Developer Portal for you.
|
||
|
||
## Settings
|
||
|
||
_This module has no settings. Enable it and use its commands as shipped._
|
||
|
||
## Slash commands
|
||
|
||
| Command | Description | Options |
|
||
| --- | --- | --- |
|
||
| `/giveaway-start` | Start a giveaway | `/prize`* (string), `/minutes`* (integer) |
|
||
|
||
Options marked with `*` are required. Uncheck a command in Studio to keep the module without occupying a slash slot.
|
||
|
||
## Data and failure modes
|
||
|
||
Module state uses this origin’s KV (`tabbot-store`) and the runner process. There is no HoneyPeer server-side copy. Closing the runner tab stops event handlers and timers. Official modules are GNU GPL v3 or later.
|