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.

data/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,  // Example bot 1
  235148962103951360,  // Example bot 2
  276060004262477825,  // Example bot 3
  294882584201003009,  // Example bot 4
  530082442967646230,  // Example bot 5
  673918978178940951,  // Example bot 6
  824119071556763668,  // Example bot 7
  1048591041445498910, // Example bot 8
  1242930981967757452  // Example bot 9
]

How to Add New Bots

Find Bot ID

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

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

Add to Config

1. Open data/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

Identify Keywords

Look for words commonly used in giveaway result announcements.

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

Create Webhook

1. Go to Server Settings → Integrations → Webhooks

2. Create new webhook or copy existing one

Configure URL

1. Paste the full webhook URL in the config

2. Test with "debug": true enabled

Embed Customization

Customize the notification embeds for giveaways.

giveaway_join

Embed sent when joining a giveaway:

"giveaway_join": {
  "title": "• Giveaway Joined",
  "color": "0x2b2d31",
  "footer": {
    "text": "Pashka™ | Giveaways",
    "icon_url": "https://i.e-z.host/a8oyrvt5.png"
  },
  "fields": [
    {"name": "Server", "value": "[{guild_name}](https://discord.com/channels/{guild_id})"},
    {"name": "Channel", "value": "[{channel_name}](https://discord.com/channels/{guild_id}/{channel_id})"},
    {"name": "Bot", "value": "[{author_name}](https://discordlookup.com/user/{author_id})"}
  ]
}

giveaway_win

Embed sent when winning a giveaway:

"giveaway_win": {
  "title": "• Giveaway Won!",
  "color": "0x2b2d31",
  "footer": {
    "text": "Pashka™ | Giveaways",
    "icon_url": "https://i.e-z.host/a8oyrvt5.png"
  },
  "fields": [
    {"name": "Server", "value": "[{guild_name}](https://discord.com/channels/{guild_id})"},
    {"name": "Channel", "value": "[{channel_name}](https://discord.com/channels/{guild_id}/{channel_id})"},
    {"name": "Bot", "value": "[{author_name}](https://discordlookup.com/user/{author_id})"}
  ]
}

Customizing Embeds

Available Variables

Use these placeholders in embed fields:

｛guild_name｝ - Server name
｛guild_id｝ - Server ID
｛channel_name｝ - Channel name
｛channel_id｝ - Channel ID
｛author_name｝ - Bot username
｛author_id｝ - Bot user ID

Modifying Appearance

1. Change color using hex values (with 0x prefix)

2. Add thumbnail URL for images

3. Modify footer text/icon for branding

Security Recommendations

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