https://github.com/discord-void-project/bot
Void Bot is an open-source Discord bot offering moderation tools, fun commands, and customizable features for your community ! :)
https://github.com/discord-void-project/bot
bot discord discord-js discord-ts lunaria void void-bot
Last synced: 6 months ago
JSON representation
Void Bot is an open-source Discord bot offering moderation tools, fun commands, and customizable features for your community ! :)
- Host: GitHub
- URL: https://github.com/discord-void-project/bot
- Owner: discord-void-project
- License: gpl-3.0
- Created: 2025-09-26T22:39:51.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-10-05T00:16:54.000Z (6 months ago)
- Last Synced: 2025-10-05T02:37:38.735Z (6 months ago)
- Topics: bot, discord, discord-js, discord-ts, lunaria, void, void-bot
- Language: TypeScript
- Homepage:
- Size: 209 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
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](https://discord.com/developers/applications)
* 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
```bash
git clone https://github.com/discord-void-project/bot.git
cd bot
```
### 2. Install dependencies
```bash
npm install
```
### 3. Configure environment variables
Create a `.env` file based on `.env.example` and set your configuration:
```env
DISCORD_TOKEN=your_token_here
DATABASE_URL=mysql://user:password@localhost:3306/void_dev
```
### 4. Generate Prisma client
```bash
npx prisma generate
```
### 5. Start the bot
```bash
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 ` → 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](./LICENSE).