VØID

(I currently don't have a r.i.p logo)

👀 About

🚀 Void is a modern, modular, and powerful Discord bot built with TypeScript and Prisma !

✨ Features

• 🎭 Automatic role assignment (server tags, special colors)
• 💼 work command with random drops and bonuses
• 📸 Auto-thread creation channels
• ⚙️ Slash commands with advanced permission handling
• 🔒 Blacklist system with per-server overrides

⚙️ Prerequisites

Before installing the project, make sure you have:

1. Node.js >=23.x and npm or pnpm installed
2. A MySQL database (or adjust DATABASE_URL to your database type)
3. A Discord Application with a bot created:
   • Go to Discord Developer Portal
   • Create a new Application → Add a Bot
   • Copy your Bot Token
   • Enable the required Privileged Gateway Intents:
     • ✅ Presence Intent
     • ✅ Server Members Intent
     • ✅ Message Content Intent

📦 Installation

1. Clone the project

git clone https://github.com/discord-void-project/bot.git
cd bot

2. Install dependencies

npm install

3. Configure environment variables

Create a .env file based on .env.example and set your configuration:

DISCORD_TOKEN=your_token_here
DATABASE_URL=mysql://user:password@localhost:3306/void_dev

4. Generate Prisma client

npx prisma generate

5. Start the bot

pnpm dev

🗂️ Project Structure

src
├─ client/              # Commands, Events, Managers, Bot instance..
├─ database/            # Prisma schema and services
├─ structures/          # Base classes (Command, Event, Logger..)
├─ ui/                  # Discord UI (embeds, containers, presets..)
├─ utils/               # Utility functions (string, math, date..)
├─ helpers/             # Discord Helper, Extenders..

🔑 Commands

Default prefix: vdev!

Example:

• vdev!authority check <user> → Check if a user is blacklisted
• v!work or /eco work → Run an activity to earn rewards

🤝 Contributing

1. Fork the repository
2. Create a new branch (@feature/my-feature)
3. Commit your changes (git commit -m "Add my feature")
4. Push your branch (git push origin @feature/my-feature)
5. Open a Pull Request

📜 License

This project is licensed under the GPL-3.0 License.