🌌 VantyxBot System

The Next-Generation Discord Ecosystem

Vantyx is now Open Source! A complete platform merging a high-performance
Discord bot with a stunning web dashboard to deliver the ultimate server management experience.

  

---

🖼️ Dashboard Showcase

---

🎗️ Sponsor & Support the Project

Vantyx is now open-source, but development continues through community support!

Current Goal: $15 / month

• Goal: To host the project on a high-performance VPS, ensuring the bot stays online 24/7 for the community.
• Reward: When we reach this target, I will release a major update including:
  • 🔔 Social Notifications: YouTube, TikTok, Twitch, and Kick integration.
  • 🚀 And much more...

Become a Sponsor: patreon.com/hadi4100

---

📌 Release Info

• Current Version: v1.0 (The Starter)
• Status: Stable Release (Open Source)

---

✨ Features

🛡️ Advanced Moderation Keep your community safe with automated filters, rigorous logging, and swift justice tools (Ban, Kick, Timeout) accessible directly from Discord or the Dashboard.	📈 Engagement & Levels Gamify your server with a robust XP system. Custom rank cards, leaderboards, and role rewards keep your members active and engaged.	🎟️ Professional Support A complete ticketing system with transcript generation. Handle user inquiries privately and professionally without leaving Discord.
🎁 Events & Giveaways Host exciting giveaways with ease. Supports instant "Drops", intricate requirements, and automatic winner selection.	🌍 Global Ready Built from the ground up with English and Arabic support, automatically adapting to your server's language preference.	🎨 Creative Tools Stunning Welcome/Goodbye images powered by Canvas, fully customizable to match your server's unique aesthetic.

🛠️ The Stack

🚀 Quick Start

Get Vantyx up and running in minutes. The project uses NPM Workspaces to manage the Bot, API, and Dashboard.

1. Prerequisites

• Node.js v18+
• MongoDB (Local or Atlas)
• A Discord Bot Token

2. Configure

1. Environment Variables: Rename config.sample.js to config.js.
2. Discord Secrets: Open config.js and fill in your DISCORD_TOKEN, CLIENT_ID, and CLIENT_SECRET.
3. Discord Developer Portal Setup:
   • Go to the Discord Developer Portal.
   • Select your application and navigate to the OAuth2 tab.
   • Click Add Redirect and enter: http://localhost:3000/login.
   • Click Save Changes.
4. Database Connection:
   • Ensure your MONGO_URI in config.js is correct (default: mongodb://localhost:27017/vantyx).

/* config.js */
module.exports = {
  DISCORD_TOKEN: "YOUR_TOKEN",
  CLIENT_ID: "YOUR_APP_ID",
  CLIENT_SECRET: "YOUR_SECRET",
  MONGO_URI: "mongodb://localhost:27017/vantyx",
  // ...
};

3. Launch 🚀

Install dependencies and start all services at once from the root directory.

# 1. Install dependencies for all workspaces
npm install

# 2. Run all services in development mode (with hot-reload)
npm run dev

# OR: Run all services in production mode
npm start

4. Individual Service Control 🛠️

If you need to run or debug services individually:

# Start only the Bot
npm run dev:bot

# Start only the API
npm run dev:api

# Start only the Dashboard
npm run dev:dashboard

Services Online:

• 🖥️ Dashboard: http://localhost:3000
• 🔌 API: http://localhost:4000

📂 Project Structure

Path	Description
/bot	The core Discord client logic, event handlers, and commands.
/dashboard	Next.js 16+ web interface for managing the bot configs.
/api	Express.js backend API serving data between DB and Frontend.
config.js	Central configuration file for all services.

📜 License

This project is licensed under the MIT License. See LICENSE.md for details.

---

_{Built with ❤️ by Hadi. Open Source Project.}