Logo
Chat Channels
PluginMIT

Chat Channels

Lightweight chat channels plugin for Paper that lets players switch between channels and sync messages to Discord via webhooks.

47
Downloads
1
Followers
2 months ago
Updated
📦
4
Versions
managementsocialutilitypaper
Download Latestv1.4.3View on Modrinth

📖About Chat Channels

💬 Chat-Channels

Chat-Channels is a lightweight and flexible Paper plugin that allows players to switch between multiple chat channels, 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:

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:

    • ✅ Public Bot
    • ✅ Server Members Intent
    • ✅ Message Content Intent

  4. Copy the TOKEN and put it in your config.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
  1. Copy the generated URL
  2. Open it in your browser
  3. Add the bot to your server

🔗 How to get a Channel ID

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

🌐 How to create a Webhook

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

Then paste it in your config (optional):

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 LICENSE file for details.

💬 Organize your server chat and connect it with Discord!