Giveaway Joiner

Automatically detects and enters giveaways from configured bots.

The giveaway joiner watches the channels it can see, spots giveaway embeds from the bots you trust, and enters them for you. Everything is configured in one JSON file.

Configuration file

modules/giveaways.json

Core settings

Basic configuration for giveaway detection and entry.

Setting	Description	Default
delay	Time (in seconds) between status checks for new giveaways.	`10`
delay_enabled	Enable or disable the automatic giveaway checking.	`true`
notifications	Enable or disable webhook notifications.	`false`
debug	Enable verbose logging for troubleshooting.	`false`

Bot configuration

bot_list is the array of trusted giveaway bot user IDs to monitor.

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

How to add new bots

Find the bot ID. Enable Developer Mode in Discord (Settings, Advanced), then right-click the bot and select Copy User ID.
Add it to the config. Open modules/giveaways.json, add the ID to the bot_list array, save the file and restart your selfbot.

Reaction settings

Configure how the module reacts to giveaways.

Setting	Description	Default
max_attempts	Maximum times to try reacting if the first attempt fails.	`5`
retry_delay	Seconds between reaction attempts.	`1.5`
initial_wait	Seconds to wait before the first reaction.	`0.5`

Win detection

winning_phrases holds the keywords that indicate a giveaway result message.

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

Adding custom phrases

Identify the keywords. Look for words commonly used in giveaway result announcements.
Modify the config. Add the new phrases to the array in lowercase, keep them short (3-8 characters) for best matching, and avoid overly common words that might cause false positives.

Notification settings

webhook is the Discord webhook URL used for notifications.

webhook: YOUR_WEBHOOK_URL_HERE

Setting up webhooks

Create the webhook. Go to Server Settings, Integrations, Webhooks. Create a new webhook or copy an existing one.
Configure the URL. Paste the full webhook URL in the config and 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.