ModMail – Professional Multi‑Server Ticket Bot

ModMail is a production-ready, open-source Discord bot that lets server members privately contact staff via tickets. Any server owner can invite and configure it independently.

---

✨ Key Features

• Multi-server support – Independent settings per guild (roles, channels, cooldowns, auto-close)
• Slash commands only – Modern interface with /modmail, /setup, and more
• Two-way relay – Staff replies sync to user DMs; user replies sync back
• Persistent UI – Buttons survive bot restarts
• Transcript generation – HTML transcripts saved on close
• Auto-close & cooldowns – Inactive tickets close automatically; anti-spam
• Full logging – All ticket actions logged to a Discord channel
• Global blacklist – Owner can block users or servers
• Railway ready – Optimised with health checks and connection pooling

---

🔧 Commands

👤 User Commands

• /modmail new [message] – Open a new ticket
• Click the Open ModMail Ticket button (deployed via /setup panel)

👥 Staff Commands (inside a ticket channel)

• /modmail close – Close the current ticket
• /modmail claim – Claim the ticket
• /modmail rename <name> – Rename the ticket channel
• /modmail adduser <user> – Add a user to the ticket
• /modmail removeuser <user> – Remove a user

⚙️ Admin Setup Commands

• /setup category – Set category for ticket channels
• /setup staffrole – Add/remove staff roles
• /setup logs – Set logs channel
• /setup transcripts – Set transcripts channel
• /setup panel – Deploy ticket button panel
• /setup cooldown <seconds> – Set cooldown between tickets
• /setup autoclose <minutes> – Set auto-close timeout
• /setup show – View current config
• /setup reset – Reset all settings

👑 Owner Commands

• /blacklist add user/guild <id> [reason]
• /blacklist remove <id>
• /blacklist list
• /stats – Bot statistics

---

📦 Quick Setup

1. Invite the bot using the link below.
2. Run /setup category – provide a category ID (ticket channels go here).
3. Run /setup staffrole – add staff roles.
4. Run /setup logs – set channel for ticket logs.
5. Run /setup transcripts – set channel for transcripts.
6. Run /setup panel – set channel and deploy the ticket button.

Once done, users click the button to open a ticket. Staff see a private channel and can reply – messages automatically go to the user's DM.

---

🔒 Privacy & Security

• Only user IDs, message content, and guild settings are stored (required for functionality).
• Cooldowns, rate limiting, and blacklist prevent abuse.
• Transcripts are generated only on ticket close and sent to your configured channel.
• You can delete all data by resetting the guild configuration.

---