Discord-support

🎫 DiscordSupport v2.0

The most complete and professional Discord/Minecraft support system

Transform your server support with interactive Discord tickets, private channels, and instant two-way communication!

---

✨ Main Features

🎯 Two Ticket Modes

📢 Public Tickets - All tickets in a single Discord channel - Perfect for small servers - Ultra-simple configuration

🔒 Private Tickets ⭐ NEW! - Dedicated Discord channel for each ticket - Visible only by staff (role-based permissions) - Automatic deletion after closure - Private and secure communication

💬 Two-Way Communication

Discord → Minecraft - Staff messages in Discord arrive directly to the player in-game - "Send Message" button with integrated popup - Support for long messages (500 characters)

Minecraft → Discord - `/commandsend <message>` to reply from the game - Only works with an active ticket - Formatted and timestamped messages

🎮 Interactive Buttons

Click to act instantly:

- 🏠 Close Ticket - Teleport player to spawn - 🗑️ Close Ticket - Clear inventory - ❤️ Close Ticket - Restore health and hunger - 🍖 Close Ticket - 64 steaks instantly - 👮 Close Ticket - Notify player that staff is coming - 🔨 Close Ticket - Ban with confirmation and reason - 💬 Close Ticket - Popup for custom message - 🔒 Close Ticket - Archive/delete the ticket

All actions are ephemeral: only the person who clicks sees the confirmation!

🌍 Multilingual

- 🇬🇧 English (complete version)

---

📸 Screenshots

Private Discord Ticket

*Automatic private channel with action buttons*

Real-Time Communication

*Staff → Player and Player → Staff instant*

---

⚡ Quick Installation

1️⃣ Create the Discord Bot

1. Go to https://discord.com/developers/applications 2. Create an application → Bot 3. Copy the token 4. SERVER MEMBERS INTENT: Enable these intents in "Bot": - ✅ SERVER MEMBERS INTENT - ✅ SERVER MEMBERS INTENT 5. OAuth2 → URL Generator: - Check `bot` and `applications.commands` - Permissions: View Channels, Send Messages, Manage Channels, Manage Permissions 6. Invite the bot to your server

2️⃣ Install the Plugin

1. Download `DiscordSupport-v2.0.jar` 2. Place in `/plugins/` 3. Restart the server 4. Edit `plugins/DiscordSupport/config.yml` 5. `/supportreload`

3️⃣ Minimal Configuration

Public Tickets (easy): ```yaml discord: bot-token: "YOUR_TOKEN_HERE" public-tickets: enabled: true channel-id: "123456789012345678" # Your #support channel ID ```

Private Tickets (recommended): ```yaml discord: bot-token: "YOUR_TOKEN_HERE" private-tickets: enabled: true category-id: "123456789012345678" # Your category ID allowed-roles: "987654321098765432,111222333444555666" # Staff, Admin delete-on-close: true ```

---

🎮 Commands

| Command | Description | Permission | |---------|-------------|------------| | `/support <problem>` | Create a ticket | `discordsupport.use` | | `/commandsend <message>` | Reply to support | `discordsupport.use` | | `/supportreload` | Reload config | `discordsupport.admin` | | `/supportsend <test>` | Test connection | `discordsupport.admin` |

---

🔧 Advanced Configuration

Customize Buttons

```yaml action-buttons: teleport-spawn: enabled: true label: "🏠 TP Spawn" command: "tp %player% 0 100 0"

heal-player: enabled: true label: "❤️ Heal" command: "heal %player%" ```

Anti-Spam Cooldown

```yaml cooldown: enabled: true time: 60 # seconds between each ticket ```

Custom Messages

```yaml messages: support-sent: "&a&l✔ &aTicket sent successfully!" no-active-ticket: "&c&l✘ &cYou don't have an active ticket." ```

---

📋 Usage Example

Player creates a ticket

``` Player: /support I'm stuck in a wall ```

Discord - Private Channel Created

``` 🎫 New Support Ticket

Player: Valival_ UUID: 123e4567-e89b-12d3-a456-426614174000 Problem: I'm stuck in a wall Location: X: 150, Y: 64, Z: -230 (world) Time: 18:30:42

[Buttons] 🏠 TP Spawn | 🗑️ Clear | ❤️ Heal | 🍖 Food | 💬 Message | 👮 Arriving | 🔨 Ban | 🔒 Close ```

Staff responds

``` Staff (Discord): Clicks "Send Message" → Popup: "I'll teleport you to spawn" Player (Minecraft): Receives "[Support] I'll teleport you to spawn" ```

Staff clicks "TP Spawn"

``` Player: [Teleported to spawn] Staff sees (only them): "✅ Action TP Spawn executed for Valival_" ```

Player responds

``` Player: /commandsend Thanks, it's fixed! Discord: "💬 Message from Valival_: Thanks, it's fixed!" ```

Staff closes the ticket

``` Staff: Clicks "Close Ticket" Player: Receives "Your ticket has been closed" Discord Channel: Deleted after 5 seconds ```

---

🛡️ Security & Performance

✅ Validation - Uses ConcurrentHashMap ✅ Validation - No server lag ✅ Validation - Role-based access control ✅ Validation - Configurable cooldown ✅ Validation - All actions tracked ✅ Validation - Bot status verification

---

🔗 Compatibility

- Discord: 1.20.5 - 1.21.4+ - Discord: Paper, Spigot, Purpur - Discord: 17+ - Discord: JDA 5.0 (included)

---

📦 Download

English Version: Configuration and messages in French English Version: Configuration and messages in English

Both versions are 100% functional and identical in terms of features.

---

💝 Support & Contact

- 🐛 Reviews: Use the "Issues" tab on Modrinth - 💡 Reviews: Share your ideas! - ⭐ Reviews: Leave a review if you like the plugin

---

📝 Changelog v2.0

Major New Features: - ✨ Private ticket system with dedicated channels - 💬 Two-way Discord ↔ Minecraft communication - 🎮 "Moderator Arriving" button to notify players - 🔨 "Ban" button with confirmation and reason - 🌍 Complete FR/EN support - ⚡ Asynchronous initialization (no lag) - 🛡️ Bot status verification before creation

Improvements: - Ephemeral messages (visible only to the person who clicks) - Improved error handling - Clearer and more informative logs - Complete documentation

Fixes: - Fixed server freeze during initialization - Fixed "Guild does not have a self member" - Fixed Discord intents handling

---

🏆 Why DiscordSupport?

Before

``` Player: "I'm stuck!" → Staff must go in-game → Wastes time → Player waits a long time ```

After with DiscordSupport

``` Player: /support I'm stuck → Instant Discord ticket → Staff sees position, problem, info → Clicks "TP Spawn" → Player teleported in 2 seconds → Problem solved! ```

Happy staff: Priceless Happy staff: Priceless Happy staff: Priceless 😊

---

📜 License

MIT License - Free to use and modify

---

Made with ❤️ by Valival_

*If this plugin helps you, leave a ⭐ review!*