# Bue - Modern Discord Moderation Bot

[![Website](https://img.shields.io/badge/Website-bueapp.com-blue?style=for-the-badge)](https://bueapp.com)
[![Discord](https://img.shields.io/badge/Support-Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://bueapp.com)

---

## 🚀 Overview

**Bue** is a powerful, feature-rich Discord moderation bot designed for servers that take moderation seriously. With collaborative Action Threads, comprehensive event logging, and detailed analytics, Bue gives your moderation team the tools they need to manage your community effectively.

---

## ⚡ Key Features

### 🧵 Action Threads
When a moderation action occurs (ban, kick, timeout), Bue automatically creates a private discussion thread for your mod team. This allows moderators to:
- Discuss the context behind actions
- Document evidence and reasoning
- Collaborate on complex moderation decisions
- Keep a permanent record of mod discussions

### 📋 Comprehensive Event Logging
Track everything happening in your server with support for **25+ event types**:
- **Members** Joins, leaves, kicks, bans, timeouts
- **Messages** Deletions, edits
- **Channels** Creates, deletes, updates
- **Roles** Creates, deletes, permission changes
- **Invites** Creation and deletion tracking
- **Voice** Mutes, deafens, disconnects, moves
- **Server** Settings changes, emoji updates

### ⚠️ Warning System
A fully-featured warning system with automatic escalation:
- Issue warnings with `/warn`
- Set automatic punishments at warning thresholds (e.g., 3 warns = timeout, 5 warns = ban)
- Pardon warnings when appropriate
- View warning history per user

### 📝 Moderator Notes
Keep private notes on users that only your mod team can see:
- Document suspicious behavior
- Track previous issues
- Share context between moderators
- Markdown formatting support

### 📊 Analytics & Statistics
Visualize your server's activity with beautiful charts:
- **Server Stats** Member joins/leaves, message activity, moderation actions
- **Moderator Stats** See which mods are most active
- **Audit Search** Find specific actions with powerful filters
- **User History** Complete moderation history for any user

### 📤 Log Export
Export your server's moderation logs as CSV files for:
- External analysis
- Record keeping
- Compliance requirements

---

## 🛡️ Moderation Commands

| Command | Description |
|---------|-------------|
| `/ban` | Ban a user from the server |
| `/kick` | Kick a user from the server |
| `/timeout` | Timeout a user for a specified duration |
| `/warn` | Issue a warning to a user |
| `/purge` | Bulk delete messages in a channel |
| `/note` | Add a private note to a user |

---

## 📈 Analytics Commands

| Command | Description |
|---------|-------------|
| `/stats` | View server activity statistics with charts |
| `/modstats` | View moderator activity leaderboard |
| `/audit` | Search audit log entries with filters |
| `/history` | View complete moderation history of a user |
| `/export` | Export server logs as CSV |

---

## ⚙️ Configuration Commands

| Command | Description |
|---------|-------------|
| `/logging setup` | Configure event logging channel and events |
| `/logging disable` | Temporarily disable logging |
| `/action-threads setup` | Configure Action Threads |
| `/settings` | View current server configuration |

---

## 🔒 Permissions

Bue requires the following permissions to function properly:
- Kick Members
- Ban Members
- Moderate Members (for timeouts)
- Manage Messages
- View Audit Log
- Create Public Threads
- Send Messages in Threads
- Read Message History

---

## 🌐 Links

- **Website:** [bueapp.com](https://bueapp.com)
- **Support Server:** [Join Discord](https://bueapp.com)
- **Documentation:** [bueapp.com](https://bueapp.com)

---

## 💡 Why Bue?

✅ **Collaborative Moderation** Action Threads bring your team together  
✅ **Comprehensive Logging** Never miss an important event  
✅ **Beautiful Analytics** Visualize your server's health  
✅ **Automatic Escalation** Warnings that lead to action  
✅ **Privacy Focused** Your data stays yours  
✅ **Actively Developed** Regular updates and new features  

---

**Ready to level up your server's moderation?**

[**Add Bue to your server →**](https://bueapp.com)

Modern Discord moderation bot with Action Threads, comprehensive audit logging, moderator stats, and automated warning systems.

Votando por Bue

¿Quieres apoyarnos?