Chat Channels

💬 Chat-Channels

Chat-Channels is a lightweight and flexible Paper plugin that allows players to full Discord integration (webhooks + bot sync), each with its own formatting and full Discord integration (webhooks + bot sync) 🌐.

Perfect for servers that want clean, organized communication between players, staff, and communities — both in-game and on Discord.

---

✨ Features

* 💬 Multiple customizable chat channels * 🔁 Switch channels easily with a command * 🏷️ Custom prefixes per channel * 👑 Staff-only channels (OP restricted) * 🌐 Discord webhook integration (Minecraft → Discord) * 🤖 Discord bot integration (Discord → Minecraft) * 🔗 Sync specific Discord channels with in-game channels * 🧑 Player avatars in Discord messages (webhooks) * 🎨 Full color support (including HEX colors) * 🧩 Optional Vault integration (prefix & suffix support) * 🔄 Hot reload with automatic bot restart if token changes * ⚡ Lightweight and simple configuration * 📡 Global chat support (vanilla + optional Discord sync)

---

🧩 Vault Support (Optional)

If you install Vault (with plugins like LuckPerms):

* 👑 Player prefixes & suffixes are automatically applied * 🎨 Colors are fully supported * 💬 Chat formatting becomes more dynamic and customizable

No configuration required — just install Vault.

If Vault is not installed, the plugin will still work normally.

---

📜 Commands

* `/channel <name>` - 💬 Switch to a channel * `/channel reload` - 🔄 Reload configuration (OP only)

---

⚙️ Configuration

Each channel can be fully customized in `config.yml`:

```yml discord: token: "" # Optional (enables Discord bot)

channels: global: prefix: "[Global]" webhook: "" # Optional discord-channel-id: "" # Optional

staff: prefix: "[Staff]" webhook: "YOUR_WEBHOOK_URL" # Optional discord-channel-id: "" # Optional ```

* 🏷️ `prefix` → How the channel appears in chat * 🌐 `webhook` → Sends Minecraft messages to Discord (optional) * 🤖 `discord-channel-id` → Sync Discord → Minecraft (optional) * 🔑 `discord.token` → Enables the Discord bot (optional) * 🎨 Supports HEX colors (e.g. `&#FFAA00`) * 🌐 Colors are automatically cleaned when sent to Discord

---

📦 Installation

1. 📥 Download the latest `.jar` 2. 📂 Place it in your server's `plugins` folder 3. ▶️ Start or restart your server 4. 📝 Edit `config.yml` to customize channels

---

⚙️ How it works

* 👤 Players are automatically assigned to the global channel * 🔄 Use `/channel` to switch between available channels * 💬 Messages are only visible to players in the same channel * 🌐 Messages can be sent to Discord via webhooks (optional) * 🤖 Discord messages can appear in Minecraft (optional)

---

🛡️ Channel System

* 🌍 Global channel

* Uses normal Minecraft chat * Optional Discord sync

* 👑 Staff channel

* Only accessible by OP players * Private communication

* ⚙️ Custom channels

* Fully configurable * Unlimited possibilities

---

🤖 Discord Bot Setup

1️⃣ Create a Discord Application

1. Go to: https://discord.com/developers/applications 2. Click "New Application" 3. Give it a name and create it

---

2️⃣ Create the Bot

1. Go to the "Bot" tab

2. Click "Add Bot"

3. Enable the following:

* ✅ Message Content Intent * ✅ Message Content Intent * ✅ Message Content Intent

4. Copy the TOKEN and put it in your `config.yml`:

```yml discord: token: "YOUR_BOT_TOKEN" ```

---

3️⃣ Invite the Bot to your Server

1. Go to OAuth2 → URL Generator 2. Select:

Scopes:

* `bot`

Bot Permissions:

* View Channels * Send Messages * Read Message History

3. Copy the generated URL 4. Open it in your browser 5. Add the bot to your server

---

🔗 How to get a Channel ID

1. Go to Discord settings → Advanced 2. Enable Copy ID 3. Right-click a channel → Copy ID 4. Paste it in your config (optional):

```yml discord-channel-id: "123456789012345678" ```

---

🌐 How to create a Webhook

1. Go to your Discord channel 2. Click ⚙️ New Webhook 3. Go to New Webhook 4. Click New Webhook 5. Copy the webhook URL

Then paste it in your config (optional):

```yml webhook: "https://discord.com/api/webhooks/..." ```

---

📝 Notes

* 👤 Only players can use commands * ⚙️ Works with Paper 1.21+ * 📄 Uses YAML configuration * 🌐 Discord integration is fully optional

---

🚀 Future ideas

* 🔐 Permission-based channels (LuckPerms deeper integration) * 🎨 More chat formatting options * 📊 Channel-specific settings (cooldowns, filters) * 🖥️ GUI for channel selection

---

👤 Author

Developed by Wilkcraft

📄 License

This project is licensed under the MIT License - see the MIT License file for details.

---

💬 Organize your server chat and connect it with Discord!