Skip to content

Latest commit

 

History

History
207 lines (155 loc) · 7.28 KB

README.md

File metadata and controls

207 lines (155 loc) · 7.28 KB
Vantyx Logo

🌌 VantyxBot System

The Next-Generation Discord Ecosystem

Discord Server Node.js License Sponsor

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.


Patreon    Support

🖼️ Dashboard Showcase

Dashboard Home Server Settings
Moderation Tickets
Giveaways AutoMod

🎗️ 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

Tech Stack

🚀 Quick Start

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

1. Prerequisites

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.