KioTsBot
Modern Discord Bot Framework
A powerful, modular Discord bot built with TypeScript featuring 30+ commands across economy, music, moderation, and game systems.
Tech Stack
Kio-TsBot is the modern, modular successor to DiscordTSBot — a Discord bot written in TypeScript. Designed for simplicity, flexibility, and extensibility, making it easy to build, customize, and scale your own Discord bot.
✨ Key Features
Modular Architecture
Effortlessly add, remove, or modify commands and features with a plugin-friendly structure.
Professional Response System
Unified modern response system with rich embeds, consistent branding, and category-specific colors.
Economy System
Comprehensive economy with fops 🦊 currency, daily rewards, casino games, and shop system.
Music Player
Full-featured music bot supporting YouTube and multiple audio sources with queue management.
Moderation Tools
Professional moderation commands: kick, ban, timeout, and bulk message deletion.
Shipping System
Fun shipping commands with persistent stats, leaderboards, and user pairings.
Reaction Roles
Advanced reaction role panels with custom emojis, descriptions, and persistent storage.
Welcome System
Configurable welcome and goodbye messages with custom channels and embed styling.
Casino Games
Multiple games including Blackjack, Coinflip, Roulette, and Slots with multipliers.
Docker Support
Complete Docker setup with docker-compose for easy deployment and PostgreSQL database.
TypeScript First
Full type safety and modern development experience with strict TypeScript configuration.
Discord.js v14
Built on the latest Discord.js library with modern features and best practices.
🎮 Available Commands
Kio-TsBot features over 30 commands organized in categories. Use /help in Discord for an interactive command browser!
💰 Economy Commands
- ▸/balance - Check your fops 🦊 balance
- ▸/daily - Claim your daily reward
- ▸/pay - Send fops to another user
- ▸/inventory - View your items
- ▸/playgame - Casino games (blackjack, coinflip, roulette, slots)
🛍️ Shop Commands
- ▸/shop - Browse available items
- ▸/buy - Purchase items from the shop
- ▸/item - Use items from your inventory
🎵 Music Commands
- ▸/join - Join your voice channel
- ▸/play - Play music from YouTube
- ▸/pause / /resume - Control playback
- ▸/skip - Skip current song
- ▸/queue - View current queue
- ▸/nowplaying - Show current song info
🛡️ Moderation Commands
- ▸/kick - Kick a user from the server
- ▸/ban - Ban a user from the server
- ▸/timeout - Timeout a user
- ▸/clear - Bulk delete messages
❤️ Shipping Commands
- ▸/ship - Ship two users together
- ▸/mystats - Your shipping statistics
- ▸/top - Server shipping leaderboard
🔧 Technical Implementation
📝 Recent Updates (v0.3.1)
Comprehensive Feedback System
Interactive modal forms with DM notifications and type-based color coding
ResponseBuilder System
Centralized response system with rich embeds and consistent branding
Docker Migration
Complete docker-compose setup with PostgreSQL and health monitoring
30+ Commands Updated
Migrated all commands to modern response system with rich embeds
🚀 Quick Start
Requirements:
- Node.js v18.0.0 or newer (LTS recommended)
- Discord Bot Token
- PostgreSQL Database
- Docker & Docker Compose (recommended)
Installation:
# Clone the repository
git clone https://github.com/KibaOfficial/kio-tsbot.git
cd kio-tsbot
# Configure environment
cp .env.example .env
# Edit .env with your credentials
# Start with Docker Compose
docker-compose up -d kio-tsbot-db
npm run dev"Thanks to everyone who contributed to this project, either by helping test the bot, contributing code, ideas, or just by using it. I really appreciate it!" ❤️