BotMotherDiscord

# Bot Mother DC - Release Notes

## Version 1.0.0

**Release Date:** December 2, 2025

### Overview

Bot Mother DC is a comprehensive Discord-Minecraft integration plugin that provides seamless communication between your Minecraft server and Discord community. This initial release includes all core features fully functional and tested.

---

## Features

### Account Synchronization
- Secure verification code system (6-character alphanumeric)
- Automatic Discord role assignment upon sync
- Configurable sync rewards (commands, permissions, positions)
- Unsync actions when accounts are unlinked
- Reverse lookup support (Discord ID ↔ Minecraft UUID)

### Ticket Support System
- Professional Discord button-based ticket creation
- Modal form for ticket subject and description
- Private channels (only creator and assigned staff)
- Staff DM notifications with Accept button
- Staff cannot send messages until accepting ticket
- Optional voice channels for ticket support
- Auto-timeout for unanswered tickets (configurable)
- Extended timeout (24h) when no staff online
- Complete ticket history logging
- Automatic channel cleanup

### VoIP Voice Channel Management
- Dynamic voice channel creation on demand
- Automatic cleanup when channels empty
- User limit configuration
- Voice time tracking per user
- Screen share permissions based on voice time
- Alone timeout (delete when only 1 person)

### Shop System with Stripe Integration
- Secure payment processing via Stripe Checkout
- Configurable VIP positions/ranks
- Position stacking (cumulative duration)
- Expiration warnings and grace periods
- Discord and in-game purchase notifications
- Cloudflare Tunnel support for production SSL
- Polling backup system for webhook failures
- Automatic role assignment on purchase
- Commands on activate/expire

### Chat Bridge
- Bidirectional Minecraft ↔ Discord chat
- Global chat channel (all players)
- Media chat channel (images/videos with delay)
- Server chat channel (verified players only)
- Chat filter support for TownyChat, EssentialsChat, etc.
- Configurable message delays (anti-spam)

### Content Moderation
- Multi-language profanity filter (EN, PT-BR, ES, IT, RU, ZH)
- Leetspeak detection (character substitution)
- Repeated character detection
- Spaced word detection
- Link filtering with whitelist/blacklist
- Progressive punishment system:
  - Warnings → Mute → Kick → Ban
- Cross-platform punishment sync
- Staff notifications for violations
- Warning/Mute/Kick/Ban roles

### CAPTCHA Verification
- Automatic CAPTCHA for new Discord members
- Bot/spam prevention
- Role assignment after verification

### Staff Role System
- Automatic in-game prefixes from Discord roles
- Permission synchronization
- Administrator and Moderator role support
- Chat and nickname prefix customization
- Commands on role grant/revoke

### Auto-Setup System
- First-time setup creates all Discord infrastructure
- Automatic role creation (DevOps, Admin, Mod, Player, Member, Unverified)
- Category and channel creation
- Permission configuration

---

## Technical Specifications

### Compatibility
- **Minecraft Versions:** 1.17.x - 1.21.x
- **Server Software:** Spigot, Paper, Purpur
- **Java Version:** 17 or higher

### Soft Dependencies
- Vault (economy/permissions hooks)
- LuckPerms (permissions integration)
- EssentialsChat (chat formatting)
- TownyChat (channel support)

### Languages Supported
- English (en)
- Portuguese Brazil (pt_br)
- Spanish (es)
- Italian (it)
- Russian (ru)
- Chinese (zh)

---

## Commands

| Command | Description | Permission |
|---------|-------------|------------|
| `/sync dc` | Link Minecraft to Discord | `botmotherdc.sync` |
| `/positions` | View your positions | `botmotherdc.positions` |
| `/positions list` | List all positions | `botmother.admin.positions` |
| `/positions give <player> <pos> <days>` | Grant position | `botmother.admin.positions` |
| `/positions remove <player> <pos>` | Remove position | `botmother.admin.positions` |
| `/positions check <player>` | Check player positions | `botmother.admin.positions` |
| `/botmother reload` | Reload configs | `botmotherdc.admin.reload` |
| `/botmother reset` | Reset Discord setup | `botmotherdc.admin.reset` |

---

## Configuration Files

| File | Purpose |
|------|---------|
| `configs/config.yml` | Main plugin settings, Discord bot configuration |
| `configs/stripe.yml` | Stripe payment integration |
| `configs/positions.yml` | VIP/ranks definitions, staff roles, sync rewards |
| `configs/chat.yml` | Chat filter and prefix settings |
| `configs/norms.yml` | Content moderation rules |
| `languages/*.yml` | Localization files |

---

## Data Storage

All data is stored in YAML format for easy backup and editing:

| File | Purpose |
|------|---------|
| `data/linked_accounts.yml` | Synced Minecraft-Discord accounts |
| `data/shop_data.yml` | Position purchases and expiration |
| `data/voice_time.yml` | Voice time tracking |
| `data/tickets.yml` | Ticket history |
| `data/moderation_data.yml` | Punishment records |

---

## Security Features

- **Webhook Signature Verification:** All Stripe webhooks are cryptographically verified
- **Rate Limiting:** Configurable request limits per IP
- **SSL/TLS:** Auto-generated certificates for testing, Cloudflare Tunnel for production
- **Debounced Saves:** Prevents excessive I/O operations
- **Thread-Safe:** ConcurrentHashMap for all async operations
- **CAPTCHA:** Prevents bot accounts from accessing server

---

## Performance Optimizations

- Asynchronous file I/O operations
- Debounced save operations (3-5 second delay)
- Efficient rate limiting with ArrayDeque
- ConcurrentHashMap for thread-safe data access
- Configurable polling intervals
- Automatic cleanup tasks

---

## Known Limitations

1. **Self-signed SSL for Testing Only:** Stripe will reject self-signed certificates in production. Use Cloudflare Tunnel (free) or a valid CA certificate.

2. **Quick Tunnel URLs Change:** If using Cloudflare Quick Tunnel (`trycloudflare.com`), URLs change on every restart. Use a permanent domain for production.

3. **First-Time Setup:** The `first-time-setup` option will recreate all Discord infrastructure. Always set to `false` after initial setup.

---

## Support

For issues, questions, or feature requests:
- Create a ticket in the SpigotMC discussion
- Check the included documentation
- Enable `debug-mode: true` for detailed logging

---

## Credits

- **Developer:** BotMother
- **Discord Library:** JDA (Java Discord API)
- **Payment Processing:** Stripe

---

## License

This plugin is proprietary software. Unauthorized distribution or modification is prohibited.

---

**Thank you for using Bot Mother DC!**