Giveaway Joiner

Automatically detects and enters giveaways from configured bots.

Giveaway Joiner Configuration

Configure how the module detects and enters giveaways automatically.
All settings are managed through the configuration file shown below.
See the Modules Overview for a complete list of all available modules.

modules/giveaways.json

Core Settings

Basic configuration for giveaway detection and entry.

delay

Time (in seconds) between status checks for new giveaways
Default: 10

delay_enabled

Enable/disable the automatic giveaway checking
Default: true

notifications

Enable/disable webhook notifications
Default: false

debug

Enable verbose logging for troubleshooting
Default: false

Bot Configuration

Manage which bots the module interacts with.

bot_list

Array of trusted giveaway bot user IDs to monitor:

"bot_list": [
  159985870458322944,
  235148962103951360,
  276060004262477825,
  294882584201003009,
  530082442967646230
]

How to Add New Bots

1
Find Bot ID

1. Enable Developer Mode in Discord (Settings - Advanced)

2. Right-click the bot and select Copy User ID

2
Add to Config

1. Open modules/giveaways.json

2. Add the ID to the bot_list array

3. Save the file and restart your selfbot

Reaction Settings

Configure how the module reacts to giveaways.

max_attempts

Maximum times to try reacting if first attempt fails
Default: 5

retry_delay

Seconds between reaction attempts
Default: 1.5

initial_wait

Seconds to wait before first reaction
Default: 0.5

Win Detection

Configure how the module detects giveaway wins.

winning_phrases

Keywords that indicate a giveaway result message:

"winning_phrases": [
  "ended",
  "winner",
  "congrat",
  "won",
  "results",
  "drawing"
]

Adding Custom Phrases

1
Identify Keywords

Look for words commonly used in giveaway result announcements.

2
Modify Config

1. Add new phrases to the array in lowercase

2. Keep phrases short (3-8 characters) for best matching

3. Avoid overly common words that might cause false positives

Notification Settings

Configure webhook notifications for giveaway activity.

webhook

Discord webhook URL for notifications:

webhook: YOUR_WEBHOOK_URL_HERE

Setting Up Webhooks

1
Create Webhook

1. Go to Server Settings - Integrations - Webhooks

2. Create new webhook or copy existing one

2
Configure URL

1. Paste the full webhook URL in the config

2. Test with debug: true enabled

Security Recommendations

  • Keep your webhook private - anyone with it can send messages
  • Consider using a dedicated account for giveaway joining