Free v1

Giveaway Discord Bot

Discord giveaway bot with slash command modal, entry button, SQLite persistence, and timed winner selection.

bebonaiem bebonaiem
0 (0)
2 downloads
36 views
May 2026

Giveaway Discord Bot

Node.js Discord giveaway bot with modal-based creation, button entries, SQLite persistence, and automatic winner selection.


โœจ Features

  • /gstart opens a form for prize name, duration, and number of winners

  • Giveaway posts with an entry button and live embed updates every 60 seconds

  • Automatic winner selection when the giveaway ends

  • Persistent storage so giveaways survive bot restarts

  • Admin tools for ending, rerolling, listing, and editing giveaways

  • DM notifications on entry confirmation

  • Logging channel support for tracking giveaway events

  • Entry limit enforcement per user

  • Duplicate entry prevention with rate-limited DM notifications


โš™๏ธ Commands

Command

Description

/gstart

Create a giveaway with a modal form (prize, duration, winners)

/gstop

End a running giveaway early and pick winners immediately

/greroll

Pick new winners for a finished giveaway

/glist

List all active giveaways in the server

/gedit

Update the prize text or extend the end time


๐Ÿš€ Setup

  1. Install dependencies:

    npm install
  1. Create a .env file in the project root with:

    env

    DISCORD_TOKEN=your-bot-token
    CLIENT_ID=your-application-client-id
    GUILD_ID=your-test-guild-id
  2. Start the bot (also registers slash commands):

    bash

    node run.js

๐Ÿ› ๏ธ Tech Stack

  • Node.js โ€” Runtime environment

  • discord.js v14 โ€” Discord API wrapper

  • SQLite3 โ€” Lightweight persistent database

  • dotenv โ€” Environment variable management


โณ Duration Format

Use values like 10m (minutes), 2h (hours), or 1d (days).


v1 May 26, 2026
Initial release

Reviews

0 reviews

No reviews yet

Be the first to review this project!