R U C K U S

The chaotic-fun Discord bot your server didn't know it needed.

Pranks · Moderation · Games · Donations · Partnerships — all in one bot.

---

💥 What is Ruckus?

Ruckus is a feature-packed Discord bot built for communities that love a bit of chaos mixed with serious utility. Whether you're running a gaming server, a Dank Memer hub, or just want to spice up your community — Ruckus has you covered.

Zero hardcoded IDs. Every role and channel is configured via environment variables. Clone it, configure it, run it — on any server.

---

🎯 Feature Highlights

🎲 Fun & Chaos /hack — Fake-hack someone with dramatic effects /expose — Reveal hilarious "secrets" about users /bully — Auto-delete someone's messages temporarily /embarrass — Assign a random embarrassing role for 24h /shut — Quick temporary mute (10–60s) /hell-ban — Banish someone to a hell channel /massping — Ping a specific user 10 times (admins only)	⚔️ Battles & Events /xpbattle — XP role battle between two users /giffight — 1-minute GIF battle with server voting /gifevent — Staff-run GIF events with bracket rounds /compliment-chain — Wholesome compliment chains
🛡️ Moderation & Utility /snipe — Recover deleted messages /say — Make the bot speak (with logging) /announce — Send formatted announcements /last-seen — Track when users were last active /mentionrole — Ping non-mentionable roles /set-status — Change bot presence on the fly Automatic command logging	💎 Dank Memer Integration /pending — Track pending donations /edono — Event donation pings /mdono — Mafia donation pings /gdono — Giveaway donation pings /hcdono — Handcricket donation pings /partner — Full partner channel system /partnership — Partnership opt-out controls

---

🚀 Quick Start

# 1. Clone the repo
git clone https://github.com/<your-username>/ruckus-bot.git
cd ruckus-bot

# 2. Install dependencies
npm install

# 3. Configure your server
cp .env.example .env
# Edit .env with your bot token, IDs, and role configurations

# 4. Deploy slash commands
npm run deploy

# 5. Start Ruckus
npm start

That's it. Ruckus is live. 💥

---

⚙️ Configuration

All Discord IDs are managed through environment variables — no hardcoded IDs anywhere.

# Shared roles
ROLE_ADMIN=123456789
ROLE_STAFF=123456789

# Per-command permissions (comma-separated role IDs)
SHUT_ALLOWED_ROLES=id1,id2
SHUT_IMMUNE_ROLES=id1,id2
BULLY_ALLOWED_ROLES=id1,id2
# ... see .env.example for the full list

Everything is centralized in src/config.js — one file, all config.

---

🏗️ Project Structure

ruckus-bot/
├── src/
│   ├── index.js              # Entry point & event routing
│   ├── config.js             # Centralized ID configuration
│   ├── deploy-commands.js    # Slash command registration
│   ├── command-utils.js      # Shared utilities
│   ├── interaction-utils.js  # Interaction helpers
│   ├── logger.js             # Command logging
│   ├── presence.js           # Status rotation
│   └── ...                   # Individual command modules
├── data/                     # Runtime data (git-ignored)
├── .env.example              # Environment variable template
├── package.json
└── README.md

Each command lives in its own file — clean, modular, easy to extend.

---

🤝 Contributing

Contributions are welcome! Check out the Contributing Guide to get started.

tldr: Fork → Branch → Code → PR. That's it.

---

📄 License

MIT — do whatever you want with it.

---

Built with 💥 and a questionable sense of humor.

If Ruckus made your server more fun, give it a ⭐