unkronnn/RelivedBOT

🎮 Relived Roleplay - Discord Bot

Bot Discord multifungsi untuk server Relived Roleplay dengan fitur moderasi, musik, sistem ticket, dan manajemen server yang lengkap.

---

📋 Daftar Isi

• Fitur Utama
• Requirements
• Instalasi
• Konfigurasi
• Struktur Project
• Commands
• Deployment
• Troubleshooting
• Contributing
• License

---

✨ Fitur Utama

🛡️ Moderasi

• Ban/Kick/Softban - Kelola member yang melanggar aturan
• Timeout - Temporary mute member
• Warn System - Sistem peringatan dengan riwayat
• Purge - Hapus pesan secara bulk
• Ghost Ping Detection - Deteksi mention yang dihapus
• Anti-Spam Protection - Proteksi otomatis dari spam

🎵 Musik

• Play - Putar musik dari YouTube/Spotify
• Queue Management - Sistem antrian lagu
• Controls - Pause, resume, skip, stop
• Volume Control - Atur volume musik
• Loop Mode - Repeat single/queue
• Now Playing - Informasi lagu yang sedang diputar

🎫 Sistem Ticket

• 6 Kategori Ticket:
  • 💰 Donate
  • 👤 Report Player
  • 🐛 Report Bug
  • 👮 Report Staff
  • 📖 Character Story (CS)
  • 💀 Character Killed (CK)
• Private Threads - Setiap ticket dalam thread terpisah
• Claim System - Staff bisa claim ticket
• Ticket Add - Tambah member ke ticket
• Close Request - User bisa request close ticket

🎤 Temporary Voice Channels

• Auto-Create Voice - Buat voice channel otomatis
• Voice Panel - Kontrol penuh atas voice channel
• Custom Settings - Limit user, lock/unlock, rename
• Auto-Delete - Hapus otomatis saat kosong

🎉 Welcome & Booster

• Welcome Messages - Sambut member baru dengan custom embed
• Booster Perks - Reward untuk server booster
• Booster Role Claim - Booster bisa claim custom role
• Booster Logs - Track semua aktivitas booster

📊 Server Management

• Server Stats - Statistik server lengkap
• Rules Setup - Setup dan edit rules dengan mudah
• Channel Management - Move, organize channels
• Leave Threads - Bulk leave/archive threads
• Message Checker - Cek pesan member

👨‍💼 Staff Tools

• Devlog System - Catat progress development
• LOA Requests - Leave of Absence management
• Ask Staff - System pertanyaan untuk staff

💾 Database Features

• MongoDB Integration - Penyimpanan data persistent
• Voice Interaction Tracking - Track aktivitas voice
• Permission System - Kelola permission per fitur
• Channel Manager - Manajemen channel database

---

📦 Requirements

• Node.js v18.0.0 atau lebih tinggi
• MongoDB (Local atau MongoDB Atlas)
• Discord Bot Token dari Discord Developer Portal
• FFmpeg (untuk music features)
• Git (optional, untuk cloning)

---

🚀 Instalasi

1. Clone Repository

git clone https://github.com/Relived-RP/Bot-Discord.git
cd Bot-Discord

2. Install Dependencies

npm install --legacy-peer-deps

Note: Flag --legacy-peer-deps diperlukan untuk mengatasi konflik dependency.

3. Setup Environment Variables

Buat file .env di root folder:

# Discord Configuration
TOKEN=your_discord_bot_token_here
CLIENT_ID=your_application_client_id
GUILD_ID=your_guild_id_optional

# Database
MONGO_URI=mongodb://localhost:27017/relivedbot
# Atau MongoDB Atlas: mongodb+srv://username:[email protected]/relivedbot

# Environment
NODE_ENV=development

# Ticket System Channels (Optional)
CHANNEL_DONATE_ID=1234567890123456789
CHANNEL_REP_PLAYER_ID=1234567890123456789
CHANNEL_BUG_ID=1234567890123456789
CHANNEL_REP_STAFF_ID=1234567890123456789
CHANNEL_CS_ID=1234567890123456789
CHANNEL_CK_ID=1234567890123456789

4. Build Project

npm run build

5. Deploy Slash Commands

npm run deploy

6. Run Bot

Development mode (with auto-reload):

npm run dev

Production mode:

npm start

---

⚙️ Konfigurasi

Setup Commands

1. Welcome System

/setup-welcome

Konfigurasi pesan welcome untuk member baru.

2. Ticket System

/setup-ticket

Setup channel dan permission untuk sistem ticket.

3. Booster Log

/setup-booster-log

Setup logging untuk aktivitas booster.

4. Temporary Voice

/tempvoice-panel

Buat panel kontrol untuk temporary voice channels.

5. Rules Setup

/rules-setup

Setup channel rules dengan embed interaktif.

---

📁 Struktur Project

RRPBOT/
├── src/
│   ├── commands/           # Slash commands
│   │   ├── moderation/     # Ban, kick, warn, etc.
│   │   ├── music/          # Music player commands
│   │   ├── server/         # Server management
│   │   └── staff/          # Staff-only commands
│   ├── controllers/        # Business logic
│   │   ├── ask_controller.ts
│   │   ├── music_controller.ts
│   │   └── ...
│   ├── handlers/           # Event & interaction handlers
│   │   ├── events/         # Discord events
│   │   ├── buttons/        # Button interactions
│   │   ├── modals/         # Modal submissions
│   │   └── select-menus/   # Select menu handlers
│   ├── services/           # Core services
│   │   ├── booster/        # Booster management
│   │   ├── cache/          # Caching layer
│   │   └── tempvoice/      # Voice management
│   └── index.ts            # Main entry point
├── shared/
│   ├── database/           # Database layer
│   │   ├── managers/       # Data managers
│   │   ├── services/       # Database services
│   │   └── trackers/       # Activity trackers
│   ├── types/              # TypeScript types
│   └── utils/              # Utility functions
├── docs/                   # Documentation
├── assets/                 # Static assets
├── .env                    # Environment variables
├── package.json            # Dependencies
└── tsconfig.json          # TypeScript config

---

🤖 Commands

Moderasi Commands

Musik Commands

Server Management

Ticket Commands

Staff Commands

---

🌐 Deployment

Deploy ke VPS/Server

1. Install Node.js & MongoDB

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs mongodb

1. Clone & Setup

git clone https://github.com/Relived-RP/Bot-Discord.git
cd Bot-Discord
npm install --legacy-peer-deps

1. Configure & Build

# Edit .env dengan konfigurasi production
nano .env

# Build project
npm run build

# Deploy commands
npm run deploy

1. Run with PM2 (Recommended)

# Install PM2
npm install -g pm2

# Start bot
pm2 start ecosystem.config.cjs

# Auto-start on reboot
pm2 startup
pm2 save

Deploy ke Pterodactyl

Lihat dokumentasi lengkap di DEPLOYMENT.md

Quick Start:

1. Upload file ke server atau clone repository
2. Set environment variables di panel Pterodactyl
3. Set startup command:

   chmod +x /home/container/start.sh && /home/container/start.sh
   

4. Start server

---

🔧 Troubleshooting

Bot tidak connect

Solusi:

• Cek token di .env sudah benar
• Pastikan bot sudah di-invite ke server
• Cek intents sudah diaktifkan di Developer Portal

Music commands tidak jalan

Solusi:

• Install FFmpeg di server
• Cek bot ada permission CONNECT & SPEAK di voice channel
• Pastikan dependency @discordjs/voice terinstall

Database error

Solusi:

• Cek MongoDB service berjalan: sudo systemctl status mongodb
• Cek connection string di .env
• Test koneksi: mongo <your_connection_string>

Build error

Solusi:

• Hapus node_modules dan package-lock.json
• Install ulang: npm install --legacy-peer-deps
• Cek versi Node.js: node --version (harus >=18.0.0)

Permission error

Solusi:

• Cek bot role ada di posisi tertinggi (setelah server owner)
• Cek bot punya semua permission yang diperlukan
• Pastikan permission hierarchy benar

---

🤝 Contributing

Kontribusi sangat welcome! Silakan:

1. Fork repository ini
2. Buat branch baru: git checkout -b feature/AmazingFeature
3. Commit changes: git commit -m 'Add some AmazingFeature'
4. Push ke branch: git push origin feature/AmazingFeature
5. Buat Pull Request

Development Guidelines

• Gunakan TypeScript untuk semua file baru
• Follow existing code style
• Test semua perubahan sebelum commit
• Update dokumentasi jika perlu

---

📝 License

Project ini menggunakan MIT License.

---

📞 Support

Untuk bantuan dan pertanyaan:

• Discord Server: Relived Roleplay
• GitHub Issues: Report Bug/Request Feature
• Documentation: Lihat folder /docs untuk dokumentasi lengkap

---

🙏 Credits

Dibuat dengan ❤️ untuk komunitas Relived Roleplay

Teknologi yang digunakan:

• Discord.js - Discord API wrapper
• TypeScript - Type-safe JavaScript
• MongoDB - NoSQL database
• ytdl-core - YouTube downloader
• play-dl - Music streaming

---

🔄 Changelog

Version 1.0.0

• ✅ Sistem moderasi lengkap
• ✅ Music player dengan queue
• ✅ Ticket system dengan 6 kategori
• ✅ Temporary voice channels
• ✅ Welcome & booster system
• ✅ Server management tools
• ✅ MongoDB integration
• ✅ TypeScript support

---

⬆ Kembali ke atas

Made with 💙 for Relived Roleplay Community