# Discord Casino Bot A fully-featured Discord casino bot with real Litecoin (LTC) integration, multiple games, and a complete economy system. ## Features ### Games - **Dice** - Roll over/under system with provably fair results - **Crash** - Multiplier increases until crash, cashout before it crashes - **Mines** - Grid-based risk game, reveal tiles and avoid mines - **Blackjack** - Classic card game vs bot dealer - **Roulette** - Numbers, colors, and betting options - **Coinflip** - PvP and vs bot modes - **Slots** - Animated reel system with multiple paylines ### Economy System - Virtual currency (coins) - Daily, weekly, and hourly rewards - Tipping system - Leaderboards - Complete transaction history ### LTC Crypto Integration - Automatic deposit detection - Unique deposit address per user - Withdrawal system with admin approval - Blockchain monitoring - Secure API integration via BlockCypher - Conversion between LTC and casino coins ### Security Features - Provably fair gaming system - Rate limiting and anti-spam - Input validation - Cooldown management - Admin controls ## Setup Instructions ### Prerequisites - Python 3.9 or higher - MongoDB (local or cloud instance) - Discord Bot Token - BlockCypher API Token (for LTC integration) ### Installation 1. Clone the repository or download the source code 2. Install dependencies: ```bash pip install -r requirements.txt ``` 3. Set up MongoDB: - Install MongoDB locally or use MongoDB Atlas (cloud) - Default connection: `mongodb://localhost:27017/` 4. Create a `.env` file based on `.env.example`: ```env DISCORD_TOKEN=your_discord_bot_token_here MONGODB_URI=mongodb://localhost:27017/ DATABASE_NAME=casino_bot BLOCKCYPHER_TOKEN=your_blockcypher_api_token LTC_WITHDRAW_FEE=0.001 MIN_WITHDRAW_AMOUNT=0.01 REQUIRED_CONFIRMATIONS=3 ADMIN_USER_IDS=123456789012345678,987654321098765432 ``` 5. Get required tokens: - **Discord Bot Token**: https://discord.com/developers/applications - **BlockCypher Token**: https://www.blockcypher.com/ (free tier available) 6. Configure admin users: - Add your Discord user ID to `ADMIN_USER_IDS` in `.env` - To get your user ID: Enable Developer Mode in Discord, right-click your name, Copy ID ### Running the Bot ```bash python bot.py ``` The bot will: - Connect to MongoDB - Load all cogs and commands - Start the crypto monitoring system - Sync slash commands with Discord ## Command List ### Economy Commands - `/balance` - Check your balance and stats - `/daily` - Claim daily reward (500 coins) - `/weekly` - Claim weekly reward (3,500 coins) - `/hourly` - Claim hourly reward (100 coins) - `/tip ` - Tip coins to another user - `/leaderboard` - View top 10 players ### Casino Games - `/dice ` - Roll the dice - `/crash [auto_cashout]` - Play crash game - `/mines [num_mines]` - Play mines game - `/blackjack ` - Play blackjack - `/roulette ` - Spin the roulette wheel - `/coinflip [opponent]` - Flip a coin - `/slots ` - Spin the slots ### Crypto Commands - `/ltc-deposit` - Get your LTC deposit address - `/ltc-balance` - Check your LTC balance - `/ltc-withdraw

` - Withdraw LTC to external wallet - `/ltc-to-coins ` - Convert LTC to casino coins - `/coins-to-ltc ` - Convert casino coins to LTC ### Admin Commands (Admins Only) - `/admin-set-balance ` - Set user balance - `/admin-reset-user ` - Reset user data - `/admin-ban [reason]` - Ban user from casino - `/admin-unban ` - Unban user - `/admin-stats` - View bot statistics ## Configuration ### Game Settings Edit `config.py` to adjust: - Starting balance - Reward amounts - House edge - Minimum/maximum bets - Color scheme ### Crypto Settings - `LTC_WITHDRAW_FEE` - Fee charged per withdrawal - `MIN_WITHDRAW_AMOUNT` - Minimum withdrawal amount - `REQUIRED_CONFIRMATIONS` - Blockchain confirmations needed ### Security Settings - Rate limits (in `utils/security.py`) - Validation rules - Cooldown periods ## Database Structure ### Collections **users** - user_id (unique) - balance - ltc_address - ltc_balance - total_wagered - total_won - total_lost - games_played - last_daily, last_weekly, last_hourly - banned **game_history** - user_id - game_type - bet_amount - payout - profit - multiplier - result - timestamp **transactions** - user_id - type (deposit/withdraw) - amount - tx_hash - address - status - timestamp ## Provably Fair System All games use a provably fair system with: - Server seed (hidden until game end) - Client seed (user generated) - Nonce (unique per game) - SHA256 hashing Results can be verified by users to ensure fairness. ## LTC Integration Details ### Deposits 1. User requests deposit address via `/ltc-deposit` 2. Unique address generated via BlockCypher API 3. Bot monitors blockchain for incoming transactions 4. Credits user after required confirmations 5. Sends notification to user ### Withdrawals 1. User submits withdrawal request via `/ltc-withdraw` 2. Balance deducted immediately 3. Admin notified for manual processing 4. Admin processes transaction manually for security ### Conversion Rates - 1 LTC = 10,000 casino coins (configurable) - Instant conversion between LTC and coins ## Security Best Practices 1. **Never share your `.env` file** 2. **Use MongoDB authentication** in production 3. **Enable Discord 2FA** for bot account 4. **Restrict admin IDs** to trusted users only 5. **Monitor logs** regularly for suspicious activity 6. **Backup database** regularly 7. **Use HTTPS** for web dashboard (if implemented) ## Troubleshooting ### Bot won't start - Check Discord token is valid - Verify MongoDB is running - Check all dependencies installed ### Commands not showing - Ensure bot has `applications.commands` scope - Wait a few minutes for Discord to sync commands - Check bot permissions in server ### LTC deposits not working - Verify BlockCypher token is valid - Check MongoDB connection - Ensure crypto monitor is running - Check required confirmations setting ### Games not working - Check user has sufficient balance - Verify no rate limit exceeded - Check for error messages in logs ## Performance Optimization - MongoDB indexes created automatically - Async operations throughout - Rate limiting prevents abuse - Connection pooling for database - Efficient blockchain monitoring ## Future Enhancements Potential additions: - Web dashboard (React + Express) - More games (Plinko, Wheel, Limbo) - Tournaments and competitions - Affiliate system - Multi-language support - Voice channel integration - Live statistics channel - Jackpot system ## Support For issues or questions: 1. Check the logs in `casino_bot.log` 2. Verify configuration in `.env` 3. Ensure all dependencies are up to date 4. Check MongoDB connection ## Credits Built with: - discord.py v2.3+ - Motor (async MongoDB) - BlockCypher API - Python 3.9+ ## License This project is provided as-is for educational and entertainment purposes. --- **⚠️ Disclaimer**: This bot is for entertainment purposes only. Gambling can be addictive. Always gamble responsibly.